ErrorsQARate limits

Errors And Developer QA

Reserved docs for error codes, rate limits, auth failures, and task troubleshooting.

Error Shape

All API errors should use a stable structure with code, message, request_id, and optional details so developers can debug quickly.

json

{
  "code": "invalid_request",
  "message": "model is required",
  "request_id": "req_demo_123",
  "details": {}
}

1401 UnauthorizedCheck that the key exists, has not expired, and belongs to the right environment.
2429 Rate limitedReduce concurrency or use a background queue with retry and backoff.
3Task failedRead task error details and distinguish invalid params, model rejection, asset download failure, and system errors.