Pular para o conteúdo
Cheapest Imagen
Guias

Limites de uso e geração em lote

Os limites da API do Cheapest Imagen (300 por minuto, 50 ao mesmo tempo), o que significa um 429 e como gerar milhares de imagens com novas tentativas sem cobrança dupla.

Os limites

LimiteValorErro ao exceder
Requisições por minuto, por conta300429 rate_limit_exceeded
Requisições em andamento, por conta50429 concurrency_limit_exceeded
Imagens por requisição (n)10 em 1K, 4 em 2K, 2 em 4K400 invalid_value
Prompts recusados por hora10429 moderation_paused por uma hora
Tempo de uma requisição420 segundos504 upstream_timeout, sem cobrança

Os limites valem por conta e são compartilhados por todas as suas chaves de API e pelo site. Não há faixas de uso.

Uma requisição não precisa manter a conexão aberta por todo esse tempo: enviada com async: true, ela responde na hora com uma tarefa que você consulta depois. Veja Requisições síncronas e assíncronas.

Quantas imagens isso dá

Com 50 requisições em andamento e 10 imagens em cada, até 500 imagens em 1K estão sendo geradas ao mesmo tempo. Uma imagem em 1K costuma levar de 20 a 40 segundos, então os limites deixam espaço para dezenas de milhares de imagens por hora em uma conta. Se você precisar de mais, escreva para support@cheapestimagen.com informando o seu volume.

Tente de novo sem pagar duas vezes

  • Em 429, espere e envie a requisição de novo; dobre a espera a cada tentativa.
  • Em 502 e 504, a requisição não foi cobrada; envie de novo.
  • Adicione um cabeçalho Idempotency-Key a cada trabalho. Se uma requisição com essa chave ainda está em andamento ou já deu certo, uma repetição responde 409 idempotency_key_in_use e nada é gerado nem cobrado outra vez. Depois de uma falha, a chave pode ser usada de novo.
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)  # requisições em andamento: o limite da conta

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)))

Guarde os resultados

Um link de response_format: "url" funciona por 72 horas. Copie os arquivos para o seu próprio armazenamento conforme eles chegam.

Quanto custa uma falha

Nada. Você paga só pelas imagens que recebe; quando uma requisição de várias imagens devolve menos, só essas são cobradas. Os canais estáveis (ids que terminam em -1k, -2k, -4k) são a exceção: eles cobram por uma imagem recusada por causa do conteúdo. Todos os códigos estão em Erros.

Nesta página