Aller au contenu
Cheapest Imagen
Guides

Limites de débit et génération en masse

Les limites de l’API Cheapest Imagen (300 par minute, 50 à la fois), ce que signifie une erreur 429, et comment générer des milliers d’images sans double facturation.

Les limites

LimiteValeurErreur en cas de dépassement
Requêtes par minute, par compte300429 rate_limit_exceeded
Requêtes en cours, par compte50429 concurrency_limit_exceeded
Images par requête (n)10 en 1K, 4 en 2K, 2 en 4K400 invalid_value
Prompts refusés par heure10429 moderation_paused pendant une heure
Durée d’une requête420 secondes504 upstream_timeout, non facturé

Les limites sont par compte, partagées par toutes ses clés API et par le site. Il n’y a pas de paliers d’utilisation.

Une requête n’a pas besoin de garder une connexion ouverte aussi longtemps : envoyée avec async: true, elle répond tout de suite avec une tâche que vous lisez plus tard. Voir Requêtes synchrones et asynchrones.

Combien d’images cela représente

Avec 50 requêtes en cours et 10 images dans chacune, jusqu’à 500 images 1K sont en cours de création en même temps. Une image 1K prend en général de 20 à 40 secondes, donc les limites laissent la place à des dizaines de milliers d’images par heure sur un seul compte. Si vous avez besoin de plus, écrivez à support@cheapestimagen.com en indiquant votre volume.

Réessayer sans payer deux fois

  • Sur 429, patientez puis renvoyez la requête ; doublez l’attente à chaque fois.
  • Sur 502 et 504, la requête n’a pas été facturée ; renvoyez-la.
  • Ajoutez un en-tête Idempotency-Key à chaque tâche. Si une requête avec cette clé est encore en cours ou a déjà réussi, une répétition répond 409 idempotency_key_in_use et rien n’est généré ni facturé de nouveau. Après un échec, la clé peut être réutilisée.
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)  # requests in progress: the account limit

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)))

Conserver les résultats

Un lien obtenu avec response_format: "url" fonctionne 72 heures. Copiez les fichiers dans votre propre stockage à mesure qu’ils arrivent.

Ce que coûte un échec

Rien. Vous ne payez que les images que vous recevez ; quand une requête de plusieurs images en renvoie moins, seules celles-ci sont facturées. Les canaux stables (identifiants finissant par -1k, -2k, -4k) font exception : ils facturent une image refusée pour son contenu. Tous les codes sont dans Erreurs.

Sur cette page