Перейти к содержимому
Cheapest Imagen
Руководства

Лимиты запросов и массовая генерация

Лимиты запросов API Cheapest Imagen (300 в минуту, 50 одновременно), ошибка 429 и массовая генерация тысяч изображений с повторами, которые не оплачиваются дважды.

Лимиты

ЛимитЗначениеОшибка при превышении
Запросов в минуту на аккаунт300429 rate_limit_exceeded
Запросов в работе на аккаунт50429 concurrency_limit_exceeded
Изображений в запросе (n)10 в 1K, 4 в 2K, 2 в 4K400 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)  # 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): они берут плату за изображение, отклонённое из-за содержимого. Все коды описаны в разделе Ошибки.

На этой странице