Documentazione dell'API Reve Art

Benvenuti alla documentazione dell'API di generazione di immagini di Reve Art. Il servizio offre capacità di generazione di immagini all'avanguardia basate sull'IA tramite una semplice API REST.

Introduzione a Reve Image 1.0

Reve Image 1.0 è il nostro modello di punta per la generazione di testo in immagine, progettato con un focus su:

• Superiore aderenza ai prompt
• Alta qualità estetica
• Rendering accurato della tipografia
• Generazione intuitiva di testo in immagine

Il modello è progettato per produrre risultati di alta qualità senza richiedere competenze avanzate di ingegneria dei prompt, rendendolo accessibile sia ai principianti che agli utenti esperti. Puoi provarlo gratuitamente su Crea Immagine.

Casi d'uso

L'API Reve Art può essere integrata in varie applicazioni:

• Creazione di contenuti: Genera immagini uniche per blog, articoli e social media
• E-commerce: Crea mockup e varianti di prodotti
• Design e prototipazione: Visualizza rapidamente i concetti di design
• Gaming e intrattenimento: Genera risorse di gioco e design di personaggi
• Istruzione: Crea materiali didattici e illustrazioni

Autenticazione

Tutte le richieste API richiedono l'autenticazione tramite una chiave API.

Aggiungi la chiave API all'intestazione Authorization:

bash
curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "your prompt here", "aspect_ratio": "1:1"}'

Come ottenere la chiave API

Effettua l'accesso e aggiungi la tua chiave API nella pagina Dashboard > API Key.

Quindi utilizza la chiave API per generare immagini.

Genera immagine

L'endpoint di generazione di immagini ti consente di creare immagini da descrizioni di testo. Puoi controllare vari aspetti del processo di generazione tramite i parametri.

Best practice

1. Ingegneria dei prompt

   • Sii specifico e descrittivo nei tuoi prompt
   • Utilizza termini artistici per la guida allo stile
   • Includi dettagli sull'illuminazione, la prospettiva e l'atmosfera

2. Selezione del rapporto d'aspetto

   • Scegli in base al tuo caso d'uso previsto
   • 1:1 per i post sui social media
   • 16:9 per presentazioni/banner
   • 9:16 per i contenuti mobili

3. Generazione asincrona

   • Usa async=true per generazioni più lunghe
   • Implementa il polling dello stato per una migliore esperienza utente

POST /v1/images/generate

Corpo della richiesta

{
  "prompt": "string",           // Obbligatorio: Il prompt di generazione dell'immagine
  "negative_prompt": "string",  // Facoltativo: Cose da evitare nell'immagine
  "aspect_ratio": "string",    // Obbligatorio: Rapporto d'aspetto dell'immagine (default: "1:1")
  "async": boolean             // Facoltativo: Generazione asincrona (default: false)
}

Rapporto d'aspetto

Il rapporto d'aspetto dell'immagine. Rapporti supportati: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2".

Risposta sincrona

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "your prompt",
    "width": 1024,
    "height": 1024,
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Risposta asincrona

{
  "id": "img_123",
  "status": "pending"
}

Esempio di utilizzo

Python:

import requests

api_key = "your_api_key"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.reve-art.com/v1/reve-image/generate",
    headers=headers,
    json={
        "prompt": "a beautiful sunset over mountains",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Image URL: {result['url']}")
else:
    print(f"Error: {response.text}")

Node.js:

async function generateImage(prompt: string) {
  const response = await fetch("https://api.reve-art.com/v1/reve-image/generate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt,
      aspect_ratio: "1:1",
      async: true,
    }),
  });

  if (!response.ok) {
    throw new Error(`Failed to generate image: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Interroga per il completamento
    return await checkImageStatus(result.id);
  }

  return result;
}

Verifica stato immagine

GET /v1/reve-image/status/image_id

Risposta

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "original prompt",
    "width": 1024,
    "height": 1024,
    "model": "text2image_v1",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Esempio di utilizzo

async function checkImageStatus(imageId: string) {
  const response = await fetch(
    `https://reve-art.com/v1/reve-image/status/${imageId}/`,
    {
      headers: {
        "Authorization": `Bearer ${apiKey}`,
      },
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to check status: ${response.statusText}`);
  }

  return await response.json();
}

Limiti di frequenza

Le richieste API sono limitate dal tuo piano di abbonamento e dai crediti disponibili.

• Ogni generazione di immagine costa 1 credito
• Piano gratuito: 3 crediti inclusi
• Piano base: 100 crediti al mese
• Limite di frequenza: 10 richieste al minuto
• Se hai bisogno di più crediti, aggiorna il tuo piano o acquista più crediti.