Documentație

Erori / Limite de rată

Erori

Erorile HTTP conțin un obiect error cu proprietățile code și message. O sarcină acceptată cu succes poate eșua ulterior; interoghează sarcina sau gestionează callback-ul de eșec primit.

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

HTTP	Câmp	Soluție recomandată
400	`invalid_request`	Corectează codul JSON, promptul lipsă, limitele parametrilor sau URL-ul media înainte de a reîncerca.
401	`invalid_api_key`	Verifică tokenul Bearer și dacă cheia API este activă.
402	`insufficient_credits`	Adaugă credite sau redu costul sarcinii. Răspunsul poate include sumele necesare și cele disponibile.
403	`forbidden`	Verificați restricția la nivel de cont descrisă în mesajul de eroare.
404	`not_found`	Verifică ID-ul sarcinii și asigură-te că cheia aparține utilizatorului care a creat sarcina.
429	`rate_limited`	Așteaptă intervalul indicat în antetul Retry-After înainte de a reîncerca.
500	`internal_error`	Inspectează mesajul de eroare și jurnalele API. Reîncearcă cu atenție; retrimiterea unei solicitări de creare poate genera o nouă sarcină facturabilă.

Limite de rată

Crearea de sarcini: în mod implicit, fiecare cheie API permite maximum 100 de solicitări pe minut. Limitele personalizate de rată nu sunt disponibile în prezent.

Interogarea sarcinilor: în mod implicit, fiecare cheie API permite maximum 120 de solicitări pe minut. Solicitările de interogare și cele de creare a sarcinilor sunt contorizate separat.

Solicitările de creare a imaginilor și videoclipurilor folosesc aceeași limită de frecvență a cererilor pentru cheia API.

Codul HTTP 429 include Retry-After: 60 pentru creare și Retry-After: 5 pentru interogări. Folosește o strategie de backoff și evită interogările mai frecvente decât este necesar.

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

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