Erreurs

Comment lire une erreur

Le statut HTTP décrit la requête envoyée à l'API. error.code décrit la raison de l'échec. Ce sont deux champs distincts : HTTP 200 n'est pas un code d'erreur métier.

Une soumission refusée renvoie un statut HTTP d'erreur accompagné d'un objet error.
Une requête de tâche réussie renvoie HTTP 200. Lisez status pour savoir si la génération est processing, completed ou failed.
Pour une tâche échouée, aiguillez votre code sur error.code, et non sur le texte de message. Des raisons d'échec différentes ont des codes différents ; une même raison utilise le même code d'un modèle à l'autre.
60002 est la valeur de repli lorsqu'aucune cause publique plus précise ne peut être déterminée. Traitez les futurs codes non reconnus comme un échec générique.

Les codes et messages du tableau ci-dessous sont renvoyés tels quels par l'API et restent donc en anglais : ils correspondent mot pour mot à l'error.message que votre client reçoit réellement.

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."
  }
}

Si la soumission elle-même dépasse le délai, vérifiez votre historique de tâches avant de soumettre à nouveau : la première requête a peut-être déjà été acceptée.

Comment lire une erreur

Request errors

Task failures

On this page