跳到正文
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 结尾的稳定通道,因内容被拒的图照扣。所有错误码见错误说明。

本页内容