422 with detail.error.code: "validation_error" and an additional fields array inside detail.error, identifying field locations and messages. Responses include an X-Request-ID for support. Errors from an upstream proxy may have a different body; always check HTTP status first.
Team not enabled:
503 workspace_not_enabled means Team access is not enabled
for the address you called. Check the base URL in API Access and contact support
with the X-Request-ID; a new key or another submission will not fix it.
Rate-limited API-key responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (Unix seconds). Honor Retry-After on 429 and use exponential backoff with jitter for transient failures. Retry a generation with its original Idempotency-Key so a retry never creates a second job.
See the OpenAPI specification for request schemas and the interactive reference to try requests.
Report a failure
Include the HTTP status,detail.error.code, X-Request-ID, job or batch ID, and the failed operation. For an accepted job, also include job.error and failure_stage when available. Do not send API keys or private download URLs. A successful HTTP poll can report a failed job: check both HTTP and job status.
See Track, cancel & retry for safe recovery.