跳到內文
Cheapest Imagen
指南

呼叫限制和批次生成

Cheapest Imagen API 的呼叫限制(每分鐘 300 次、同時 50 個),429 是什麼意思,以及怎樣批次生成幾千張圖、重試時不會重複扣費。

限制

限制數值超過時的錯誤
每個帳號每分鐘的請求數300429 rate_limit_exceeded
每個帳號同時進行的請求數50429 concurrency_limit_exceeded
每次請求的張數(n)1K 10 張,2K 4 張,4K 2 張400 invalid_value
每小時被拒的提示詞10429 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 結尾的穩定通道,因內容被拒的圖照扣。所有錯誤碼見錯誤說明。

本頁內容