Zum Inhalt springen
Cheapest Imagen
Anleitungen

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

LimitWertFehler bei Überschreitung
Anfragen pro Minute, pro Konto300429 rate_limit_exceeded
Laufende Anfragen, pro Konto50429 concurrency_limit_exceeded
Bilder pro Anfrage (n)10 bei 1K, 4 bei 2K, 2 bei 4K400 invalid_value
Abgelehnte Prompts pro Stunde10429 moderation_paused für eine Stunde
Zeit für eine Anfrage420 Sekunden504 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 429 und senden Sie die Anfrage erneut; verdoppeln Sie die Wartezeit jedes Mal.
  • Bei 502 und 504 wurde die Anfrage nicht berechnet; senden Sie sie erneut.
  • Fügen Sie jedem Auftrag einen Header Idempotency-Key hinzu. Läuft eine Anfrage mit diesem Schlüssel noch oder war sie schon erfolgreich, antwortet eine Wiederholung mit 409 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.

Auf dieser Seite