Error Codes

HTTP status codes, error response format, and handling guidance.

Error response format

All errors return a JSON body following the OpenAI error schema:

{
  "error": {
    "message": "Insufficient credit balance",
    "type": "insufficient_funds",
    "code": "balance_exceeded"
  }
}

Status	Meaning	What to do
`400`	Bad request	Check your request body for malformed JSON or missing fields.
`401`	Unauthorized	Verify your API key is correct and starts with `tr-`.
`402`	Insufficient balance	Add credits or enable auto-recharge in your API Dashboard.
`404`	Model not found	Check the model ID against available models.
`429`	Rate limited	Wait for `Retry-After` seconds before retrying.
`500`	Internal server error	Retry after a brief delay. Contact support if persistent.
`502`	Provider error	Retry — the router will try an alternative provider if available.

For exponential backoff, timeouts, and retry budgets, see Retries and transient errors.

If you want the router to try alternative routes inside one request, see Routing failover.

Models

Attestation