指南
呼叫限制和批次生成
Cheapest Imagen API 的呼叫限制(每分鐘 300 次、同時 50 個),429 是什麼意思,以及怎樣批次生成幾千張圖、重試時不會重複扣費。
限制
| 限制 | 數值 | 超過時的錯誤 |
|---|---|---|
| 每個帳號每分鐘的請求數 | 300 | 429 rate_limit_exceeded |
| 每個帳號同時進行的請求數 | 50 | 429 concurrency_limit_exceeded |
每次請求的張數(n) | 1K 10 張,2K 4 張,4K 2 張 | 400 invalid_value |
| 每小時被拒的提示詞 | 10 | 429 moderation_paused,暫停一小時 |
| 單次請求的時長 | 420 秒 | 504 upstream_timeout,不扣費 |
限制按帳號計算,帳號下的所有 API 金鑰和網頁共用。沒有用量等級。
請求不一定要一直佔著連線等這麼久:加上 async: true,會立刻回傳一個任務,之後再來取結果。見同步請求和非同步請求。
這相當於多少張
同時 50 個請求、每個 10 張,也就是最多有 500 張 1K 圖同時在生成。一張 1K 圖一般 20 到 40 秒,按這個限制一個帳號一小時可以出幾萬張。需要更多的話,寄信到 support@cheapestimagen.com 說明用量。
重試不會重複扣費
- 遇到
429,等一會兒再送,間隔逐次加倍。 - 遇到
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) # 同時進行的請求數:帳號上限
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 小時。請在拿到後把檔案存到自己的儲存空間裡。
失敗要不要錢
不要。只為收到的圖片扣費;一次要多張但只回傳了一部分時,只扣回傳的那幾張。例外是名稱以 -1k、-2k、-4k 結尾的穩定通道,因內容被拒的圖照扣。所有錯誤碼見錯誤說明。