07Failure modes
Errors
All errors return JSON: { "error": "<message>" }
400
Bad Request
Bad RequestMissing/unknown model, missing prompt, bad image data, maxRefs exceeded, non-PNG to remove-background.
401
Unauthorized
UnauthorizedMissing or invalid bearer token.
404
Not Found
Not FoundUnknown model id, job id, or image.
502
Bad Gateway
Bad GatewayUpstream model/tool error — message includes details.
503
Service Unavailable
Service UnavailableCredentials not configured on the server.
"generate HTTP 401: ..." // token invalid/expired — refresh credentials
"job failed: ..." // model rejected the request — check payload
"storage upload HTTP ..." // image upload failed — check base64 / mime