Błędy

Jak czytać błąd

Status HTTP opisuje samo żądanie do API, a error.code opisuje przyczynę niepowodzenia. To dwa odrębne pola: HTTP 200 nie jest biznesowym kodem błędu.

Odrzucone wysłanie zwraca status HTTP błędu wraz z obiektem error.
Udane odpytanie zadania zwraca HTTP 200. Z pola status odczytasz, czy generowanie jest w stanie processing, completed czy failed.
W nieudanym zadaniu rozgałęziaj kod według error.code, a nie według treści message. Różne przyczyny niepowodzenia mają różne kody; ta sama przyczyna używa tego samego kodu we wszystkich modelach.
60002 jest wartością zapasową, gdy nie da się ustalić bardziej szczegółowej, jawnej przyczyny. Nieznane kody, które pojawią się w przyszłości, traktuj jako ogólne niepowodzenie.

Kody i komunikaty w poniższej tabeli API zwraca dosłownie, dlatego pozostają po angielsku: są znak w znak zgodne z error.message, który faktycznie otrzymuje Twój klient.

Request errors

These HTTP statuses describe a rejected or unconfirmed submission, or a failed task query. A submission timeout does not prove that no task was created.

Error code (`error.code`)	HTTP status	Meaning	Next step
`10001`	401	The API key is missing or invalid.	Check the Authorization header and API key.
`10002`	403	You do not have permission to make this request.	Check access permissions.
`20001`	400, 413, 422	The request was rejected. Check the parameters against the API documentation.	Correct the request parameters before retrying.
`20002`	400	The requested model is not available.	Select a model listed in the model catalog.
`30001`	402	Not enough credits to run this request.	Add credits before submitting.
`30002`	429	Too many requests. Please wait and try again.	Wait and retry with backoff. Do not repeat accepted submissions.
`50001`	404	Task not found.	Check the task ID and use the owning account’s key.
`50002`	503	Submission could not be confirmed. Check your tasks before submitting again.	Check task history before submitting again; the request may have been accepted.
`90001`	503	The service is temporarily unavailable.	Back off; retain any task ID already received.

A successful task query returns HTTP 200 even when generation failed. Check status: "failed" and error.code in the response. These codes describe the task outcome, not the HTTP request. Failed tasks are not charged.

Error code (`error.code`)	Meaning	Next step
`20001`	The request was rejected. Check the parameters against the API documentation.	Correct the request parameters before retrying.
`50003`	The task did not complete within the allowed time. Please try again.	The task is not charged. You may submit a new task.
`60001`	The request was rejected by the content policy. Please revise the prompt or input images.	Revise the prompt or media input.
`60002`	Generation could not be completed. Please try again.	The task is not charged. You may submit a new task.
`60003`	No output was generated. Please revise the prompt or try again.	Revise the input or submit a new task.
`60004`	The generated output could not be delivered. Please try again.	The task is not charged. Try again later.
`90001`	The service is temporarily unavailable.	Back off; retain any task ID already received.

{
  "id": "task_...",
  "status": "failed",
  "error": {
    "code": 60002,
    "message": "Generation could not be completed. Please try again."
  }
}

Jeśli limit czasu został przekroczony przy samym wysyłaniu, przed ponownym wysłaniem sprawdź historię zadań: pierwsze żądanie mogło już zostać przyjęte.

Jak czytać błąd

Request errors

Task failures

On this page