Skip to main content
Todas las respuestas de error siguen el formato estándar de OpenAI: 
{
  "error": {
    "message": "Insufficient balance. Recharge at https://app.geekhub.mx/dashboard/billing.",
    "type": "insufficient_balance",
    "code": "insufficient_balance",
    "request_id": "req_aacb6a7d478c2fdea077ca09"
  }
}
El request_id es trazable de extremo a extremo. Si reportas un bug, inclúyelo — podemos buscar tu request en logs.

​
Catálogo de errores

HTTPcodeQué hacer
400invalid_request_errorRevisa el body (Zod te dirá el campo exacto en message)
401missing_api_keyManda header Authorization: Bearer ghub_sk_...
401invalid_api_keyVerifica que la key sea correcta y no esté revocada
401key_revokedGenera una nueva en /dashboard/keys
402insufficient_balanceRecarga en /dashboard/billing/recharge
404model_not_foundLlama GET /v1/models para ver el catálogo válido
429rate_limit_exceededReintenta con exponential backoff (próximo Sprint)
500internal_errorReintenta. Si persiste, abre ticket con request_id
502provider_unavailableEl proveedor (Anthropic/OpenAI/etc) está caído o tu prompt no es aceptable. Reintenta o cambia modelo

​
Errores específicos del proveedor

Si el code es provider_unavailable, el message viene del proveedor original tal cual. Ejemplos comunes: 
404 The model 'gpt-4o' does not exist            ← Tu cuenta no tiene acceso
content_filter triggered                          ← Anthropic / OpenAI bloquearon el prompt
rate limit reached for model xxx                 ← Sobrecarga temporal del proveedor

​
Retry recomendado

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

Si pides stream: true y algo falla después de que arranca el stream, recibes un mensaje SSE final con el shape de error: 
data: {"error":{"message":"...","type":"provider_unavailable","code":"provider_unavailable","request_id":"req_xxx"}}
Tu parser debe revisar si la línea contiene error además de [DONE].