Non-streaming errors

HTTP statusWhat it means
400Invalid parameters (e.g. empty model, unsupported option)
401Invalid or missing API key
404No available route for this model, or task ID not found
502All upstream routes returned a server error

Example:

HTTP/1.1 400 Bad Request
{
  "error": { "message": "model is required", "type": "invalid_request_error" }
}

Streaming errors

When streaming, errors come in two forms:

A specific image failed (other images may still succeed):

event: error
data: {"created":1719000000,"index":0,"error":{"code":"content_policy_violation","message":"prompt rejected"}}

All routes failed (nothing more to read):

data: {"error":{"message":"Failed to generate image (500): ...","type":"upstream_error"}}

data: [DONE]

See also

Stream responses · Gateway errors