Documentation Index
Fetch the complete documentation index at: https://docs.raziel.fun/llms.txt
Use this file to discover all available pages before exploring further.
When a request to the Raziel gateway fails, the response body is a JSON object with a consistent shape. Each error has an HTTP status code, an error type string, and a human-readable message. This page lists every error you can encounter and what to do about each one.
All gateway errors follow this structure:
{
"type": "error",
"error": {
"type": "auth_error",
"message": "Invalid or revoked Raziel key"
}
}
Top-level envelope field. Always "error" for error responses.
Machine-readable error category. Use this field to branch your error-handling logic.
Human-readable description of what went wrong.
Error reference
401 — auth_error
{
"type": "error",
"error": {
"type": "auth_error",
"message": "Invalid or revoked Raziel key"
}
}
rz_live_… key is missing, malformed, or has been revoked.
What to do: Verify the key in your request matches the one issued in the dashboard. If you rotated or deleted the key, issue a new one from Customer → API Keys. Keys are shown in full only at creation — if you no longer have it, create a replacement.
402 — auth_error (insufficient balance)
{
"type": "error",
"error": {
"type": "auth_error",
"message": "Insufficient balance — deposit more USDC"
}
}
503 — no_listing
{
"type": "error",
"error": {
"type": "no_listing",
"message": "No live providers for this model — try again shortly"
}
}
claude-opus-4-7 to claude-sonnet-4-6. See available models for the full list.
502 — upstream_error
{
"type": "error",
"error": {
"type": "upstream_error",
"message": "All candidate providers failed — retry with backoff"
}
}
import time
import anthropic
client = anthropic.Anthropic(
base_url="https://raziel.fun/gateway",
api_key="rz_live_xxxxxxxxxxxx",
)
for attempt in range(4):
try:
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=512,
messages=[{"role": "user", "content": "Hello"}],
)
break
except anthropic.APIStatusError as e:
if e.status_code == 502 and attempt < 3:
time.sleep(2 ** attempt)
else:
raise
Summary table
| Status | error.type | Cause | Action |
|---|
401 | auth_error | Invalid or revoked API key | Issue a new key from Customer → API Keys |
402 | auth_error | Insufficient USDC balance | Deposit USDC at Customer → Deposit |
503 | no_listing | No live providers for the requested model | Wait and retry, or switch to a different model |
502 | upstream_error | All candidate providers failed | Retry with exponential backoff |
