Rate Limits und Massenerstellung
Die Limits der Cheapest Imagen API (300 pro Minute, 50 gleichzeitig), was ein 429 bedeutet und wie Sie Tausende Bilder mit Wiederholungen ohne Doppelabrechnung erstellen.
Die Limits
| Limit | Wert | Fehler bei Überschreitung |
|---|---|---|
| Anfragen pro Minute, pro Konto | 300 | 429 rate_limit_exceeded |
| Laufende Anfragen, pro Konto | 50 | 429 concurrency_limit_exceeded |
Bilder pro Anfrage (n) | 10 bei 1K, 4 bei 2K, 2 bei 4K | 400 invalid_value |
| Abgelehnte Prompts pro Stunde | 10 | 429 moderation_paused für eine Stunde |
| Zeit für eine Anfrage | 420 Sekunden | 504 upstream_timeout, nicht berechnet |
Die Limits gelten pro Konto, geteilt von allen seinen API-Schlüsseln und der Website. Es gibt keine Nutzungsstufen.
Eine Anfrage muss nicht so lange eine Verbindung offen halten: Mit async: true gesendet, antwortet sie sofort mit einem Task, den Sie später lesen. Siehe Synchrone und asynchrone Anfragen.
Wie viele Bilder das sind
Bei 50 laufenden Anfragen mit je 10 Bildern entstehen bis zu 500 1K-Bilder gleichzeitig. Ein 1K-Bild dauert meist 20 bis 40 Sekunden, die Limits lassen also Platz für Zehntausende Bilder pro Stunde bei einem Konto. Wenn Sie mehr brauchen, schreiben Sie mit Ihrem Volumen an support@cheapestimagen.com.
Wiederholen, ohne doppelt zu zahlen
- Warten Sie bei
429und senden Sie die Anfrage erneut; verdoppeln Sie die Wartezeit jedes Mal. - Bei
502und504wurde die Anfrage nicht berechnet; senden Sie sie erneut. - Fügen Sie jedem Auftrag einen Header
Idempotency-Keyhinzu. Läuft eine Anfrage mit diesem Schlüssel noch oder war sie schon erfolgreich, antwortet eine Wiederholung mit409 idempotency_key_in_use, und es wird nichts erneut erstellt oder berechnet. Nach einem Fehlschlag kann der Schlüssel wieder verwendet werden.
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) # laufende Anfragen: das Limit des Kontos
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)))Die Ergebnisse sichern
Ein Link aus response_format: "url" funktioniert 72 Stunden. Kopieren Sie die Dateien in Ihren eigenen Speicher, sobald sie ankommen.
Was ein Fehlschlag kostet
Nichts. Sie zahlen nur für Bilder, die Sie erhalten; wenn eine Anfrage für mehrere Bilder weniger zurückgibt, werden nur diese berechnet. Die Stable-Kanäle (IDs mit -1k, -2k, -4k am Ende) sind die Ausnahme: Sie berechnen ein wegen seines Inhalts abgelehntes Bild. Jeder Code steht unter Fehler.
Synchrone und asynchrone Anfragen
Zwei Wege, die Bild-API aufzurufen: in einer Anfrage auf das Bild warten, oder async true senden, sofort eine Task-ID erhalten und Tasks per Abfrage oder Webhook lesen.
Fehler
Jeder HTTP-Status und Fehlercode, den die Cheapest Imagen API zurückgibt, was er bedeutet, ob berechnet wurde und was Sie als Nächstes tun sollten.