Лимиты запросов и массовая генерация
Лимиты запросов API Cheapest Imagen (300 в минуту, 50 одновременно), ошибка 429 и массовая генерация тысяч изображений с повторами, которые не оплачиваются дважды.
Лимиты
| Лимит | Значение | Ошибка при превышении |
|---|---|---|
| Запросов в минуту на аккаунт | 300 | 429 rate_limit_exceeded |
| Запросов в работе на аккаунт | 50 | 429 concurrency_limit_exceeded |
Изображений в запросе (n) | 10 в 1K, 4 в 2K, 2 в 4K | 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) # 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 часа. Копируйте файлы в своё хранилище по мере поступления.
Сколько стоит неудача
Ничего. Вы платите только за полученные изображения; если на запрос из нескольких изображений пришло меньше, оплачиваются только они. Исключение — стабильные каналы (ID с окончанием -1k, -2k, -4k): они берут плату за изображение, отклонённое из-за содержимого. Все коды описаны в разделе Ошибки.
Синхронные и асинхронные запросы
Два способа вызвать API изображений: дождаться изображения в одном запросе или передать async true, сразу получить id задачи и читать задачи опросом либо через вебхук.
Ошибки
Все HTTP-статусы и коды ошибок API Cheapest Imagen: что означает каждый, списываются ли кредиты и что делать дальше.