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
| Limite | Valor | Erro ao exceder |
|---|---|---|
| Requisições por minuto, por conta | 300 | 429 rate_limit_exceeded |
| Requisições em andamento, por conta | 50 | 429 concurrency_limit_exceeded |
Imagens por requisição (n) | 10 em 1K, 4 em 2K, 2 em 4K | 400 invalid_value |
| Prompts recusados por hora | 10 | 429 moderation_paused por uma hora |
| Tempo de uma requisição | 420 segundos | 504 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
502e504, a requisição não foi cobrada; envie de novo. - Adicione um cabeçalho
Idempotency-Keya cada trabalho. Se uma requisição com essa chave ainda está em andamento ou já deu certo, uma repetição responde409 idempotency_key_in_usee 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.
Requisições síncronas e assíncronas
Duas formas de chamar a API de imagens: espere a imagem em uma requisição, ou envie async true, receba um id de tarefa na hora e consulte tarefas ou use um webhook.
Erros
Todos os status HTTP e códigos de erro que a API do Cheapest Imagen devolve, o que cada um significa, se houve cobrança e o que fazer em seguida.