ガイド
レート制限と大量生成
Cheapest Imagen API のリクエスト制限(1 分あたり 300、同時 50)、429 の意味、二重課金されない再試行で数千枚の画像を生成する方法を説明します。
制限
| 制限 | 値 | 超えた場合のエラー |
|---|---|---|
| アカウントごとの 1 分あたりのリクエスト数 | 300 | 429 rate_limit_exceeded |
| アカウントごとの処理中のリクエスト数 | 50 | 429 concurrency_limit_exceeded |
1 リクエストあたりの枚数(n) | 1K は 10、2K は 4、4K は 2 | 400 invalid_value |
| 1 時間あたりの拒否されたプロンプト数 | 10 | 429 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 で終わるもの)は例外で、コンテンツを理由に拒否された画像にも課金されます。すべてのコードはエラーに記載しています。