Errors

Region

Errors return a JSON body with a code and a message. The message says what happened and what to do.

Error body

{
  "error": {
    "code": "region_unavailable",
    "message": "No capacity in region au-syd; request was not routed elsewhere; retry after 30 s"
  }
}

HTTP	Code and message	What to do
400	invalid_request "Field messages is required"	Fix the request. The message names the field.
401	invalid_api_key "API key not recognised"	Check the key was copied in full, or create a new one.
402	insufficient_credits "Workspace has $0.00 in credits; this request needs $0.02"	Add credits on the billing page.
404	model_not_in_region "Model deepseek-r2 is not served in region us-mem"	Pick another model, or send the request to a region that serves it.
404	not_found "No route for POST /v1/embeddings"	See Compatibility for what is served.
429	rate_limited "Rate limit of 60 requests / min reached; retry after 12 s"	Wait for `Retry-After`, then retry.
503	model_unavailable "Model deepseek-flash is not accepting requests"	Try another model or retry after `Retry-After`.
503	region_unavailable "No capacity in region au-syd; request was not routed elsewhere; retry after 30 s"	Retry after `Retry-After`. The request was not sent anywhere else.

429 and 503 carry a Retry-After header in seconds. A request is never retried in another region on your behalf. If you want a fallback region, call it yourself.

NextRate limits Retention