Errors

{
  "error": {
    "type": "invalid_request",
    "message": "request validation failed",
    "detail": [{ "path": ["max_results"], "message": "Too big: expected number to be <=100" }]
  }
}

​

Handling them

• Retry 502 and 503 with backoff, or switch provider. They describe the provider, not your request.
• Do not retry 400, 401, or 402. Fix the request, the key, or the balance.
• Transcription jobs fail in the job, not the submission. A 202 means the job was accepted; a provider failure later shows up as status: "failed" with error on the job, and you are not charged.
• Include the response id (srch_…, ext_…, job_…) when writing to support. Every request is traceable by it.