Documentazione

Riferimento API

Ottieni un preventivo per immagine persistente

POST/v1/image-quotes

Verifica solo input e autorizzazioni, senza bloccare le immagini. Preventivo valido 60 secondi; instradamento, prezzi e richiesta vengono ricontrollati alla creazione. Servizio disabilitato: 503.

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
modelpromptsize
Proprietà aggiuntive
false

Corpo della richiesta obbligatorio

  • modelstringObbligatorio

    ID pubblico del modello nel catalogo della Key corrente.

    Lunghezza massima
    191
  • promptstringObbligatorio

    Non vuoto, massimo 32000 byte UTF-8. OpenAPI maxLength conta i caratteri; non viene inventato un limite di caratteri.

  • sizestringObbligatorio

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

  • nintegerFacoltativo

    Omesso o 0 è normalizzato a 1. Il massimo effettivo è max_n di image-models; il limite globale non è una capacità del modello.

    Valore predefinito
    1
    Minimo
    1
    Massimo
    6
  • referencesarrayFacoltativo

    Ogni elemento sceglie solo file_id, asset_id oppure url; quantità effettiva secondo max_references.

    Numero massimo di elementi
    14
    Campi figli di references (1)
    • []objectFacoltativo
      Campi figli di [] (3)
      • file_idstringFacoltativo

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

      • asset_idstringFacoltativo

        ID risorsa caricata dello stesso account e della stessa Key.

      • urlstringFacoltativo

        URL HTTPS pubblico, senza userinfo o fragment; soggetto a verifica SSRF.

        Formato
        "uri"
      Ramo oneOf 1

      Obbligatorio in questo ramo: file_id

      Ramo oneOf 2

      Obbligatorio in questo ramo: asset_id

      Ramo oneOf 3

      Obbligatorio in questo ramo: url

  • source_task_idstringFacoltativo

    Attività sorgente facoltativa della stessa Key, solo per tracciabilità; non sostituisce references.

    Lunghezza massima
    64
  • quote_idstringFacoltativo

    Alla creazione deve essere un preventivo valido e corrispondente alla richiesta; ignorato nelle richieste di preventivo.

Risposte ed errori

HTTP 200

Preventivo per immagine persistente ottenuto

application/json

Tipo
object
Campi obbligatori
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
  • pricing_notestringObbligatorio

    Descrizione dei prezzi del modello; addebito finale secondo la misurazione confermata.

  • idstringObbligatorio

    Identificatore pubblico dell'oggetto, usato nel relativo percorso dei dettagli.

  • expires_atintegerObbligatorio

    Scadenza in secondi Unix; 0 indica nessuna scadenza fissa.

  • reserved_quotaintegerObbligatorio

    Prenotazione in unità quota della piattaforma, non in dollari.

  • estimated_costnumberObbligatorio

    Costo di vendita stimato nella valuta del preventivo.

  • currencystringObbligatorio

    Valuta del preventivo/della contabilità.

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