Errori

Come leggere un errore

Lo stato HTTP descrive la richiesta all'API. error.code descrive il motivo del fallimento. Sono campi distinti: HTTP 200 non è un codice di errore di business.

Un invio rifiutato restituisce uno stato HTTP di errore con un oggetto error.
Un'interrogazione riuscita restituisce HTTP 200. Leggi status per capire se la generazione è processing, completed o failed.
Per un'attività fallita, ramifica su error.code, non sul testo di message. Motivi di fallimento diversi hanno codici diversi; lo stesso motivo usa lo stesso codice su tutti i modelli.
60002 è il valore di ripiego quando non è possibile determinare una causa pubblica più precisa. Tratta i codici futuri che non riconosci come un errore generico.

I codici e i messaggi della tabella seguente sono restituiti testualmente dall'API e restano quindi in inglese: corrispondono parola per parola all'error.message che il tuo client riceve davvero.

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

Se è l'invio stesso ad andare in timeout, controlla lo storico delle attività prima di inviare di nuovo: la prima richiesta potrebbe essere già stata accettata.

Come leggere un errore

Request errors

Task failures

On this page