Admesh/documentosEmpezar

Códigos de error

Updated 19/9/2026

Las solicitudes fallidas devuelven una estructura de error unificada; el campo code es un código legible por máquina.

Tabla de códigos de error

HTTP código Facturado Descripción
400 invalid_request No Parámetros de solicitud no válidos
401 invalid_api_key No Clave API ausente o no válida
402 insufficient_balance No Saldo insuficiente: recargar
403 model_not_allowed No Modelo no autorizado para esta clave
429 rate_limit_exceeded No Límite de frecuencia alcanzado: reintentar más tarde
500 billing_settlement_error Reconciliación asíncrona Fallo en la liquidación de facturación
502 upstream_error Normalmente no Error del servicio de origen
503 model_provider_unavailable No Servicio del modelo temporalmente no disponible
504 upstream_timeout Normalmente no Tiempo de espera agotado en el servicio de origen

Solución de problemas

  1. 401: comprueba que el valor de Authorization: Bearer sea el secreto completo de sk-live-* y que la clave no esté revocada.
  2. 402: recarga en la consola.
  3. 429: reduce la concurrencia o espera a que se resuelva retry-after antes de volver a intentarlo.
  4. 5xx: vuelve a intentarlo más tarde; si el problema persiste, ponte en contacto con el servicio de asistencia indicando el request_id.

Ejemplo de error

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}