Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dolphy.chat/llms.txt

Use this file to discover all available pages before exploring further.

​
Error envelope

All errors follow OpenAI’s shape: 
{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_api_key",
    "code": null,
    "param": null
  }
}
The type field is the most useful for programmatic handling.

​
Status codes

StatustypeMeaning
400invalid_request_errorMalformed body, bad field, validation failed
401invalid_api_keyMissing, malformed, revoked, or wrong API key
402insufficient_quotaNot enough credits to complete the request
403—API access requires an active membership; or trying to retrieve another user’s video
404—Video / resource not found
422content_policyUpstream content policy rejected the prompt (mostly happens on Google/OpenAI image models, never on uncensored ones)
429rate_limitPer-key rate limit hit. Wait the Retry-After value or back off exponentially
502upstream_errorUpstream provider returned an unexpected error
503service_unavailableUpstream provider out of balance or temporarily down

​
Retry strategy

  • 5xx errors → retry with exponential backoff (1s, 2s, 4s, 8s, give up at 30s)
  • 429 → wait the Retry-After header value, then retry
  • 402 → no point retrying until you top up credits
  • 4xx (other) → fix your request; don’t retry blindly