Documentazione

Riferimento API

Genera un'immagine in modo sincrono

POST/v1/images/generations

I parametri sincroni sono validati secondo il modello; sono disponibili solo le capacità immagine del modello scelto. Qwen: massimo 6 immagini/3 riferimenti; Ark secondo modello; Venice testo-immagine: una sola immagine senza riferimenti. I file API ordinari seguono la durata di storage, diversamente dalle attività immagine persistenti.

Limiti delle uscite sincrone

Qwen supporta fino a 6 immagini in uscita e 3 immagini di riferimento. I limiti Ark variano per modello; Venice genera soltanto un'immagine da testo. Scegli prima il modello e poi invia i campi corrispondenti. Non inviare richieste con immagini di riferimento a modelli che non le supportano.

Per conferma del preventivo, cronologia a lungo termine e recupero dopo disconnessione, usa il flusso di immagini persistenti invece di ripetere automaticamente la generazione sincrona. Gli header di archiviazione nella risposta sincrona descrivono soltanto la fase di salvataggio. La conservazione ordinaria dei file è diversa dalla protezione tramite riferimenti delle attività; vedi Fatturazione.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Corpo della richiesta · application/json

Tipo
object
Campi obbligatori
modelprompt

Corpo della richiesta obbligatorio

  • image_urlsarrayFacoltativo

    Elenco URL di riferimento secondo modello; Qwen/Ark hanno limiti propri, Venice testo-immagine sincrono rifiuta questo campo.

    Campi figli di image_urls (1)
    • []stringFacoltativo
  • modelstringObbligatorio

    ID pubblico del modello nel catalogo della Key corrente.

  • promptstringObbligatorio

    Prompt di generazione.

  • nintegerFacoltativo

    Numero di immagini richiesto, sempre soggetto al massimo del modello.

  • sizestringFacoltativo

    Dimensione restituita da image-models per il modello scelto; capacità e dimensioni validate separatamente per modello.

  • response_formatstringFacoltativo

    Formato di output secondo modello; non presumere che ognuno accetti tutti i formati.

  • userunknownFacoltativo

    Valore JSON definito dallo schema o protocollo dello strumento scelto; non presumere campi fissi.

  • extra_bodyunknownFacoltativo

    Valore JSON definito dallo schema o protocollo dello strumento scelto; non presumere campi fissi.

Risposte ed errori

HTTP 200

Immagine sincrona generata

application/json

Tipo
object
Campi obbligatori
createddata
  • createdintegerObbligatorio

    Ora di generazione della risposta immagine in secondi Unix.

  • dataarrayObbligatorio

    Array dei dati della pagina/del catalogo corrente.

    Campi figli di data (1)
    • []objectFacoltativo
      Campi figli di [] (7)
      • file_idstringFacoltativo

        ID pubblico del file ospitato dello stesso account e della stessa Key.

      • storage_statusstringFacoltativo

        Stato di archiviazione del file; il download ospitato è garantito solo dopo ready.

      • storage_errorstringFacoltativo

        Categoria pubblica dell'errore di archiviazione del file.

      • expires_atintegerFacoltativo

        Scadenza in secondi Unix; 0 indica nessuna scadenza fissa.

      • urlstringFacoltativo

        URL di accesso al risultato o riferimento; gli URL firmati sono temporanei.

      • b64_jsonstringFacoltativo

        Stringa Base64 dell'immagine; non richiederla come URL.

      • revised_promptstringFacoltativo

        Prompt rivisto restituito dal servizio, se presente.

HTTP 400

Campi o parametri della richiesta non validi.

application/json

Tipo
object
Campi obbligatori
error

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 404

Oggetto/funzionalità non disponibile o disabilitata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 409

Conflitto di idempotenza/preventivo, oggetto non pronto o ancora referenziato.

application/json

Tipo
object
Campi obbligatori
error

HTTP 429

Limite di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error

HTTP 503

Servizio, prezzi o storage non disponibile.

application/json

Tipo
object
Campi obbligatori
error