Errores
Los errores incluyen un código legible por máquinas y un mensaje. Distingue una solicitud rechazada de un resultado incierto que puede haber utilizado ya capacidad del proveedor.
Formato de error
{
"error": {
"message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
"type": "invalid_request_error",
"code": "insufficient_credit"
}
}Utiliza el x-request-id de la respuesta y tus registros de actividad para investigar una solicitud. Nunca incluyas la clave secreta ni el contenido de la conversación en un informe de soporte.
Códigos de estado
| Estado | Significado / acción |
|---|---|
| 400 | Cuerpo no válido, campos desconocidos, límite de contexto o capacidad no admitida. |
| 401 | Clave Bearer ausente, no válida o revocada. |
| 402 | Crédito disponible insuficiente o se ha alcanzado el límite de gasto de la clave de API. |
| 403 | Cuenta no disponible o modelo fuera de la lista de permitidos de la clave. |
| 404 | Endpoint desconocido o ID de modelo no aprobado. |
| 409 | Ya se utilizó una referencia de idempotencia. |
| 413 / 415 | Cuerpo demasiado grande o tipo de contenido distinto de application/json. |
| 429 | Límite de frecuencia, solicitudes o concurrencia. Espera el intervalo de Retry-After antes de reintentar; las reservas pendientes pueden requerir conciliación. |
| 502 | Fallo del proveedor, flujo no válido o uso no disponible. |
| 503 | Mantenimiento, disponibilidad del proveedor o configuración de lanzamiento. |
Resultados inciertos
Un tiempo de espera agotado del proveedor o una respuesta usage_unavailable puede dejar una retención pendiente. Estos errores incluyen X-Should-Retry: false para impedir las repeticiones automáticas del SDK. Los códigos de error del proveedor distinguen entre modelos no disponibles, parámetros no válidos, autenticación, cuota y limitación de solicitudes sin devolver detalles privados del proveedor. Revisa la actividad y concilia el primer resultado antes de decidir si envías una nueva llamada.
Idempotencia
Una Idempotency-Key opcional contiene de 1–128 letras, dígitos, puntos, guiones bajos, dos puntos o guiones. Reutilizar una referencia devuelve 409 y no repite la inferencia. Esto evita duplicados; no reproduce respuestas almacenadas en caché.