Errores

Cada código de error que devuelve la API, qué significa y qué hacer.

Formato de error

Los cuerpos de error son { "code": "…", "error": "…" }. Decide según code, no según el mensaje. Reintenta solo cuando conozcas el resultado; conserva la Idempotency-Key si el resultado de red es incierto. Las respuestas incluyen un encabezado x-request-id para citarlo en las solicitudes de soporte.

Códigos de error

HTTP	Código	Significado y acción
`401`	`AUTH_REQUIRED`	Falta la clave de API o la sesión, o no es válida.
`403`	`INSUFFICIENT_SCOPE`	La clave de API no tiene el permiso que necesita este endpoint.
`403`	`PERMISSION_DENIED`	Esta credencial no puede realizar la operación.
`429`	`API_KEY_RATE_LIMITED`	Se alcanzó el límite de frecuencia de la clave de API. Respeta Retry-After.
`429`	`API_KEY_USAGE_EXCEEDED`	La clave de API alcanzó su límite de uso. Crea una clave nueva.
`400`	`INVALID_REQUEST`	El cuerpo no es un objeto JSON o falta un valor obligatorio.
`400`	`INVALID_IDEMPOTENCY_KEY`	Idempotency-Key debe tener entre 1 y 128 caracteres ASCII imprimibles.
`400`	`INVALID_MODEL_INPUT`	input no coincide con el esquema del modelo (campo desconocido, campo obligatorio ausente o valor no válido).
`400 / 413`	`INPUT_TOO_LARGE`	El cuerpo de la solicitud supera los 256 KB. Sube primero los archivos multimedia y envía una referencia.
`404`	`REQUEST_NOT_FOUND`	No chat request with this ID belongs to your account.
`404`	`MODEL_NOT_FOUND`	Ningún modelo tiene este slug.
`404`	`JOB_NOT_FOUND`	Ninguna tarea con este ID pertenece a tu cuenta.
`409`	`IDEMPOTENCY_CONFLICT`	Esta Idempotency-Key se usó con otra entrada. Usa una clave nueva para una solicitud nueva.
`409`	`PRICE_CHANGED`	El precio difiere de expectedPriceMicros. Obtén el precio y vuelve a confirmarlo.
`409`	`MODEL_PRICE_UNAVAILABLE`	Este modelo aún no tiene precio configurado, por lo que no puede ejecutarse.
`409`	`PAYMENT_REVIEW_REQUIRED`	A refund left an uncovered balance. Contact support or cover the balance before submitting tasks.
`409`	`INSUFFICIENT_CREDITS`	Los créditos disponibles no cubren el precio de la tarea.
`429`	`RATE_LIMITED`	Demasiados envíos de tareas por minuto. Vuelve a intentarlo más tarde.
`429`	`CONCURRENCY_LIMITED`	Demasiadas tareas sin terminar. Espera a que termine alguna.
`503`	`EXECUTION_UNAVAILABLE`	La ejecución no está configurada para este modelo en este momento.
`429`	`UPSTREAM_RATE_LIMITED`	The model provider is rate limiting chat requests. Retry with backoff; nothing was charged.
`502`	`UPSTREAM_ERROR`	The model provider failed the chat request. Nothing was charged; retry later.
`503`	`PLATFORM_BUDGET_EXCEEDED`	This model is temporarily unavailable. Try again later.
`503`	`EXECUTION_TEMPORARILY_UNAVAILABLE`	La ejecución no está disponible temporalmente. Reintenta con la misma Idempotency-Key.
`503`	`AUTH_UNAVAILABLE`	La autenticación no está disponible temporalmente. Vuelve a intentarlo más tarde.
`503`	`API_UNAVAILABLE`	La API no está disponible temporalmente. Vuelve a intentarlo más tarde.