指南
调用限制和批量生成
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 结尾的稳定通道,因内容被拒的图照扣。所有错误码见错误说明。