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.
Los límites
| Límite | Valor | Error al superarlo |
|---|---|---|
| Solicitudes por minuto, por cuenta | 300 | 429 rate_limit_exceeded |
| Solicitudes en curso, por cuenta | 50 | 429 concurrency_limit_exceeded |
Imágenes por solicitud (n) | 10 en 1K, 4 en 2K, 2 en 4K | 400 invalid_value |
| Prompts rechazados por hora | 10 | 429 moderation_paused durante una hora |
| Tiempo de una solicitud | 420 segundos | 504 upstream_timeout, no se cobra |
Los límites son por cuenta, y los comparten todas sus claves de API y el sitio. No hay niveles de uso.
Una solicitud no tiene que mantener una conexión abierta tanto tiempo: enviada con async: true, responde al instante con una tarea que lees más tarde. Consulta Solicitudes síncronas y asíncronas.
Cuántas imágenes son
Con 50 solicitudes en curso y 10 imágenes en cada una, se están creando hasta 500 imágenes de 1K a la vez. Una imagen de 1K suele tardar de 20 a 40 segundos, así que los límites dejan margen para decenas de miles de imágenes por hora en una sola cuenta. Si necesitas más, escribe a support@cheapestimagen.com con tu volumen.
Reintentar sin pagar dos veces
- Ante un
429, espera y vuelve a enviar la solicitud; duplica la espera cada vez. - Ante
502y504la solicitud no se cobró; envíala de nuevo. - Añade una cabecera
Idempotency-Keya cada trabajo. Si una solicitud con esa clave sigue en curso o ya tuvo éxito, una repetición responde409 idempotency_key_in_usey no se genera ni se cobra nada otra vez. Tras un fallo se puede volver a usar la clave.
import asyncio
from openai import AsyncOpenAI, RateLimitError, APIStatusError
client = AsyncOpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
gate = asyncio.Semaphore(50) # solicitudes en curso: el límite de la cuenta
async def make(prompt: str, key: str):
async with gate:
for attempt in range(6):
try:
r = await client.images.generate(
model="nano-banana-2.1",
prompt=prompt,
size="1024x1024",
response_format="url",
extra_headers={"Idempotency-Key": key},
)
return r.data[0].url
except RateLimitError:
await asyncio.sleep(2 ** attempt)
except APIStatusError as e:
if e.status_code not in (502, 504):
raise
await asyncio.sleep(2 ** attempt)
async def main(prompts):
return await asyncio.gather(*(make(p, f"job-{i}") for i, p in enumerate(prompts)))Conserva los resultados
Un enlace de response_format: "url" funciona durante 72 horas. Copia los archivos a tu propio almacenamiento a medida que lleguen.
Cuánto cuesta un fallo
Nada. Solo pagas las imágenes que recibes; cuando una solicitud de varias imágenes devuelve menos, solo se cobran esas. Los canales estables (ids que terminan en -1k, -2k, -4k) son la excepción: cobran una imagen rechazada por su contenido. Todos los códigos están en Errores.
Solicitudes síncronas y asíncronas
Dos formas de llamar a la API de imágenes: espera la imagen en una solicitud, o envía async true, recibe un id de tarea al instante y consulta tareas o usa un webhook.
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.