Reference API

Chyby

Chyby vracejí jiný stav než 2xx a tělo JSON. Tvar odpovídá OpenAI, takže je OpenAI SDK vyhodí jako běžné výjimky.

Tvar chyby

json

{
  "error": {
    "code": "insufficient_balance",
    "type": "insufficient_quota",
    "message": "Your balance is too low for this request. Top up in the console.",
    "request_id": "6f1d2c9e-4b7a-4f0e-9a51-0c2e8b3d7a11"
  }
}

code je stabilní a můžete se podle něj rozhodovat. message je pro lidi a může se měnit. request_id odpovídá hlavičce odpovědi x-request-id.

Chybové kódy

Chyby
Kód	HTTP	Co se stalo	Opakovat?	Co dělat
`unauthorized`	`401`	API klíč chybí, je špatný, vypnutý nebo zrušený.	Ne	Zkontrolujte klíč a hlavičku `Authorization: Bearer`.
`validation_error`	`400`	Tělo není platný JSON nebo je špatně některé pole.	Ne	Přečtěte si zprávu, která pole jmenuje, a opravte požadavek.
`content_policy`	`400`	Požadavek byl odmítnut.	Ne	Upravte požadavek. Nic se neúčtovalo.
`insufficient_balance`	`402`	Zůstatek na požadavek nestačí.	Ne	Dobijte zůstatek na stránce Platby.
`not_found`	`404`	Úloha neexistuje nebo patří jinému účtu.	Ne	Zkontrolujte id úlohy a že používáte správný klíč.
`rate_limited`	`429`	Příliš mnoho požadavků, nebo je model chvilkově vytížený.	Po `Retry-After`	Počkejte podle `Retry-After` a zkuste to znovu. Pokud se to děje často, požádejte nás o vyšší limit.
`capacity_full`	`503`	Generování obrázků nebo videí má plnou kapacitu.	Ne	Ozvěte se nám a zapíšeme vás na čekací listinu.
`generation_failed`	`502`	Model nedokázal vytvořit odpověď.	Ano, s prodlevou	Zkuste to znovu s prodlevou. Nic se neúčtovalo.
`internal`	`500`	Chyba na naší straně.	Ano, s prodlevou	Zkuste to znovu s prodlevou. Pokud to přetrvává, kontaktujte nás s `request_id`.

Bezpečné opakování

OpenAI SDK samo opakuje 429 a chyby serveru a čeká podle Retry-After. Nastavte počet opakování a časový limit, nebo přidejte jednoduchou smyčku, pokud voláte API napřímo:

python

client = OpenAI(
    base_url="https://api.sweetrouter.com/v1",
    api_key=os.environ["SWEETROUTER_API_KEY"],
    max_retries=3,   # retries 429 and 5xx with backoff, honours Retry-After
    timeout=60,      # seconds
)

Id požadavků

Každá odpověď má hlavičku x-request-id. Uveďte ji, když nás kontaktujete, a najdeme přesné volání.