Errores
Todos los estados HTTP y códigos de error que devuelve la API de Cheapest Imagen, qué significa cada uno, si se cobró y qué hacer a continuación.
Los errores tienen la misma forma que los de OpenAI:
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}Cada respuesta lleva una cabecera x-request-id. Inclúyela cuando contactes con soporte.
| Estado | code | Significado | Qué hacer |
|---|---|---|---|
| 400 | missing_required_parameter | Falta un campo obligatorio | Añade el campo indicado en param |
| 400 | invalid_value | Un campo tiene un valor que no se acepta | Corrige el campo indicado en param |
| 400 | unsupported_parameter | El campo no está disponible, o no en este modelo (por ejemplo svg en un modelo sin salida SVG) | Quita el campo o elige un modelo que lo tenga |
| 400 | model_not_found | El modelo no existe o no está abierto | Usa un modelo de GET /v1/models |
| 400 | moderation_blocked | Los filtros de contenido rechazaron el prompt o la imagen | Cambia el prompt. No se cobra, salvo en los canales estables de Nano Banana (-1k, -2k, -4k) |
| 401 | invalid_api_key | Falta la clave o es incorrecta | Revisa la cabecera Authorization |
| 402 | insufficient_credits | No hay créditos suficientes | Recarga |
| 403 | account_suspended | La cuenta o la clave está deshabilitada | Contacta con soporte |
| 409 | idempotency_key_in_use | La Idempotency-Key ya se usó | Espera a la primera solicitud o usa una clave nueva |
| 413 | request_too_large | La solicitud o una imagen es demasiado grande | Envía imágenes más pequeñas o menos |
| 429 | rate_limit_exceeded | Más de 300 solicitudes en un minuto | Ve más despacio y reintenta |
| 429 | concurrency_limit_exceeded | Más de 50 solicitudes a la vez | Espera a que termine una |
| 429 | moderation_paused | Más de 10 solicitudes rechazadas en una hora | Espera una hora |
| 502 | upstream_error | No se pudo generar la imagen | Reintenta. No se cobra |
| 504 | upstream_timeout | La generación tardó más de 420 segundos | Reintenta. No se cobra |
Cuándo se te cobra
Solo por las imágenes que recibes. Las solicitudes fallidas, con tiempo agotado o rechazadas no cuestan nada. La excepción: los canales estables de Nano Banana (-1k, -2k, -4k) cobran las imágenes rechazadas por su contenido, porque el proveedor las cobra.
Límites de uso y generación masiva
Los límites de la API de Cheapest Imagen (300 por minuto, 50 a la vez), qué significa un 429 y cómo generar miles de imágenes con reintentos que nunca cobran dos veces.
Cambiar desde OpenAI
Pasa el código que usa la API OpenAI Images a Cheapest Imagen cambiando solo la URL base y la clave de API; los campos de solicitud y respuesta siguen igual.