本文へスキップ
Cheapest Imagen
ガイド

レート制限と大量生成

Cheapest Imagen API のリクエスト制限(1 分あたり 300、同時 50)、429 の意味、二重課金されない再試行で数千枚の画像を生成する方法を説明します。

制限

制限値超えた場合のエラー
アカウントごとの 1 分あたりのリクエスト数300429 rate_limit_exceeded
アカウントごとの処理中のリクエスト数50429 concurrency_limit_exceeded
1 リクエストあたりの枚数(n)1K は 10、2K は 4、4K は 2400 invalid_value
1 時間あたりの拒否されたプロンプト数10429 moderation_paused(1 時間)
1 リクエストの所要時間420 秒504 upstream_timeout(課金なし)

制限はアカウントごとで、すべての API キーとサイトで共有されます。利用ティアはありません。

リクエストは、それほど長く接続を保持する必要はありません。async: true を付けて送ると、すぐにタスクが返り、結果はあとで取得できます。同期リクエストと非同期リクエストをご覧ください。

何枚まで生成できるか

処理中のリクエストが 50 件、それぞれ 10 枚なら、最大 500 枚の 1K 画像を同時に生成しています。1K の画像は通常 20〜40 秒で生成されるため、この制限なら、1 つのアカウントで 1 時間に数万枚を生成できます。それ以上が必要な場合は、想定量を添えて support@cheapestimagen.com までご連絡ください。

二重に課金されない再試行

  • 429 の場合は、待ってからリクエストを再送します。待ち時間は毎回 2 倍にしてください。
  • 502 と 504 ではリクエストは課金されていません。再送してください。
  • ジョブごとに Idempotency-Key ヘッダーを付けます。そのキーのリクエストが実行中か、すでに成功している場合、再送には 409 idempotency_key_in_use が返り、再生成も再課金も行われません。失敗したあとは、同じキーを再利用できます。
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)))

結果を保存する

response_format: "url" で得たリンクは 72 時間有効です。ファイルは届いたらすぐに、ご自身のストレージにコピーしてください。

失敗した場合の料金

かかりません。お支払いいただくのは、受け取った画像の分だけです。複数枚のリクエストで返った枚数が少ない場合は、返った分だけが課金されます。stable チャンネル(ID が -1k、-2k、-4k で終わるもの)は例外で、コンテンツを理由に拒否された画像にも課金されます。すべてのコードはエラーに記載しています。

このページの内容