Saltar al contenido
Cheapest Imagen
Guías

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ímiteValorError al superarlo
Solicitudes por minuto, por cuenta300429 rate_limit_exceeded
Solicitudes en curso, por cuenta50429 concurrency_limit_exceeded
Imágenes por solicitud (n)10 en 1K, 4 en 2K, 2 en 4K400 invalid_value
Prompts rechazados por hora10429 moderation_paused durante una hora
Tiempo de una solicitud420 segundos504 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 502 y 504 la solicitud no se cobró; envíala de nuevo.
  • Añade una cabecera Idempotency-Key a cada trabajo. Si una solicitud con esa clave sigue en curso o ya tuvo éxito, una repetición responde 409 idempotency_key_in_use y 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.

En esta página