Documentazione

Errori / Limiti di frequenza

Errori

Gli errori HTTP contengono un oggetto error con code e message. Un task accettato correttamente può comunque fallire in una fase successiva; interroga lo stato del task o gestisci la chiamata di callback per l'errore.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Campo	Cosa fare
400	`invalid_request`	Correggi il formato JSON, il prompt mancante, l'intervallo dei parametri o l'URL del file multimediale prima di riprovare.
401	`invalid_api_key`	Controlla il token Bearer e verifica che la chiave API sia attiva.
402	`insufficient_credits`	Aggiungi crediti o riduci il costo del task. La risposta potrebbe indicare i crediti richiesti e quelli effettivamente disponibili.
403	`forbidden`	Verifica le limitazioni a livello di account descritte nel messaggio di errore.
404	`not_found`	Verifica l'ID del task e accertati che la chiave appartenga all'utente che ha avviato il task.
429	`rate_limited`	Attendi l'intervallo indicato in Retry-After prima di effettuare un nuovo tentativo.
500	`internal_error`	Verifica il messaggio d'errore e i log delle API. Riprova con attenzione: l'invio ripetuto di una richiesta di creazione può generare un nuovo task addebitabile.

Limiti di frequenza

Creazione task: per impostazione predefinita, ciascuna chiave API consente fino a 100 richieste al minuto. Al momento non sono disponibili limiti di frequenza personalizzati.

Interrogazione task: per impostazione predefinita, ciascuna chiave API consente fino a 120 richieste al minuto. Le richieste di interrogazione e quelle di creazione dei task vengono conteggiate separatamente.

Le richieste di creazione di immagini e video condividono lo stesso limite di frequenza (rate limit) della chiave API.

La risposta HTTP 429 include Retry-After: 60 per la creazione e Retry-After: 5 per le query. Applica un backoff ed evita di interrogare lo stato con una frequenza eccessiva.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}