Dokumentace

Chyby / Limity četnosti požadavků

Chyby

Chyby HTTP obsahují objekt error s poli code a message. Úspěšně přijatá úloha může přesto později selhat; dotazujte se na stav úlohy nebo ošetřete callback o jejím selhání.

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

HTTP	Pole	Co dělat
400	`invalid_request`	Před dalším pokusem opravte JSON, chybějící prompt, rozsah parametrů nebo URL adresu média.
401	`invalid_api_key`	Zkontrolujte token Bearer a zda je API klíč aktivní.
402	`insufficient_credits`	Dobijte si kredity nebo snižte náročnost úlohy. Odpověď může obsahovat požadované a dostupné množství kreditů.
403	`forbidden`	Zkontrolujte omezení na úrovni účtu popsané v chybové zprávě.
404	`not_found`	Zkontrolujte ID úlohy a zda klíč patří uživateli, který úlohu vytvořil.
429	`rate_limited`	Před dalším pokusem vyčkejte po dobu uvedenou v intervalu Retry-After.
500	`internal_error`	Zkontrolujte chybovou zprávu a protokoly API. Opakujte pokus opatrně; opětovné odeslání požadavku na vytvoření může vytvořit další zpoplatněnou úlohu.

Limity četnosti požadavků

Vytváření úkolů: každý API klíč standardně umožňuje až 100 požadavků za minutu. Vlastní limity četnosti v současné době nejsou k dispozici.

Dotazování na úkoly: každý API klíč standardně umožňuje až 120 požadavků za minutu. Požadavky na dotazy a požadavky na vytváření úkolů se počítají samostatně.

Požadavky na tvorbu obrázků a videí sdílejí stejný limit frekvence volání (rate limit) pro daný API klíč.

Chyba HTTP 429 obsahuje hlavičku Retry-After: 60 pro vytváření úloh a Retry-After: 5 pro dotazy. Používejte odklad (backoff) a nedotazujte se častěji, než je nutné.

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

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