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
| Limite | Valeur | Erreur en cas de dépassement |
|---|---|---|
| Requêtes par minute, par compte | 300 | 429 rate_limit_exceeded |
| Requêtes en cours, par compte | 50 | 429 concurrency_limit_exceeded |
Images par requête (n) | 10 en 1K, 4 en 2K, 2 en 4K | 400 invalid_value |
| Prompts refusés par heure | 10 | 429 moderation_paused pendant une heure |
| Durée d’une requête | 420 secondes | 504 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
502et504, 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épond409 idempotency_key_in_useet 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.
Requêtes synchrones et asynchrones
Deux façons d’appeler l’API d’images : attendre l’image dans une requête, ou envoyer async true, obtenir un identifiant de tâche et le lire par interrogation ou webhook.
Erreurs
Tous les statuts HTTP et codes d’erreur renvoyés par l’API Cheapest Imagen, leur signification, s’ils sont facturés et que faire ensuite.