LogoLogoDocumentação da API
LogoLogoDocumentação da API
Página inicial
Visão geralAutenticação e idempotênciaGeração de imagensEdição de imagensConversão de imagensJobs e espera limitadaCréditosErrosLimites de requisição e concorrênciaChangelog da API
Documentação da API

Limites de requisição e concorrência

Limites por chave e limites de jobs por conta

Os limites protegem a disponibilidade do serviço e são aplicados antes de qualquer trabalho caro.

LimiteValor atual
Criação de jobs10 requisições por minuto por chave de API, somando todos os endpoints de criação
Leituras autenticadas120 requisições por minuto por chave de API
Jobs ativos8 jobs em queued ou processing por conta
Tamanho do loteaté 4 saídas por job de geração ou edição
Espera limitadaaté 30 segundos

Estourar um limite de requisições ou o de jobs ativos retorna HTTP 429 com RATE_LIMIT_EXCEEDED. Use backoff exponencial com jitter e respeite o Retry-After quando ele estiver presente. As chaves de idempotência devem permanecer inalteradas enquanto você repete a mesma requisição lógica.

O limite de jobs ativos vale para a conta inteira, mesmo com várias chaves de API. Jobs concluídos não contam.

Com o lote máximo, oito jobs ativos de geração ou edição podem pedir até 32 saídas no total. Esse é um limite de capacidade de submissão, não uma garantia de que todas as saídas rodem ao mesmo tempo.

Erros

Envelopes de erro estáveis, códigos e status HTTP

Changelog da API

Mudanças versionadas do contrato público