Riferimento API

Immagini: risposta diretta

Nessun modello lo supporta ancora

Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.

POST/v1/images/generations

Generazione di immagini sincrona per i modelli che servono questa route, in un unico corpo in formato OpenAI. La risposta contiene gli URL finali delle immagini.

#Parametri della richiesta

modelstringobbligatorio
Un modello di immagini che serve questa route sincrona. I modelli solo a task la rifiutano — usa /v1/images/tasks.
promptstringobbligatorio
Cosa disegnare.
nintegerfacoltativo
Numero di immagini (la fatturazione si moltiplica per immagine).
sizestringfacoltativo
Proporzioni predefinite come "16:9" — il formato della maggior parte dei modelli di immagini; i valori esatti sono nella scheda del modello. Alcuni modelli più vecchi accettano anche WIDTHxHEIGHT.
resolutionstringfacoltativo
Fascia di risoluzione dell'output come "1K", "2K" o "4K", se la scheda del modello la riporta — anche una dimensione della fascia di prezzo.
qualitystringfacoltativo
Livello di qualità del fornitore (per esempio standard / hd) — anche una dimensione della fascia di prezzo.
response_formatstringfacoltativo
"url" (predefinito) o "b64_json" per i byte inline.

Prezzi a fasce

size, quality e duration selezionano la fascia fatturata — la scheda del modello elenca il prezzo esatto per fascia e le chiamate fallite vengono rimborsate automaticamente.

#Errori correlati

422 unprocessable_entityIl fornitore ha rifiutato i valori dei parametri inoltrati dal gateway (per esempio dimensione o durata non supportate).
401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#Risposta

response.json

{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteMessages (formato Anthropic)SuccessivoImmagini: task asincroni