Skip to main content
All error responses follow the standard OpenAI format: 
{
  "error": {
    "message": "Insufficient balance. Recharge at https://app.geekhub.mx/dashboard/billing.",
    "type": "insufficient_balance",
    "code": "insufficient_balance",
    "request_id": "req_aacb6a7d478c2fdea077ca09"
  }
}
The request_id is end-to-end traceable. If you report a bug, include it — we can find your request in the logs.

​
Error catalog

HTTPcodeWhat to do
400invalid_request_errorReview the body (Zod tells you the exact field in message)
401missing_api_keySend Authorization: Bearer ghub_sk_... header
401invalid_api_keyVerify the key is correct and not revoked
401key_revokedGenerate a new one at /dashboard/keys
402insufficient_balanceTop up at /dashboard/billing/recharge
404model_not_foundCall GET /v1/models to see the valid catalog
429rate_limit_exceededRetry with exponential backoff (coming soon)
500internal_errorRetry. If it persists, open a ticket with request_id
502provider_unavailableThe provider (Anthropic/OpenAI/etc) is down or your prompt isn’t acceptable. Retry or switch model

​
Provider-specific errors

If code is provider_unavailable, the message comes from the original provider as-is. Common examples: 
404 The model 'gpt-4o' does not exist            ← Your account doesn't have access
content_filter triggered                          ← Anthropic / OpenAI blocked the prompt
rate limit reached for model xxx                 ← Temporary provider overload

import time
from openai import OpenAI

def call_with_retry(client, model, messages, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model=model,
                messages=messages,
            )
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            # Exponential backoff: 1s, 2s, 4s
            time.sleep(2 ** attempt)

​
Streaming errors

If you request stream: true and something fails after the stream starts, you receive a final SSE message with the error shape: 
data: {"error":{"message":"...","type":"provider_unavailable","code":"provider_unavailable","request_id":"req_xxx"}}
Your parser should check whether the line contains error in addition to [DONE].