Referência · Rate limits
Rate limits da API Photta e como fazer polling de forma educada
Em uma frase
A API Photta permite 600 requisições por minuto por chave de API em uma janela fixa. Um 429 traz Retry-After: 30. Faça polling de um job a cada 3 segundos; o trabalho simultâneo é limitado pelo plano.
- Limites: 600 requisições/min
- Retry-After: Retry-After: 30s
- Processamento: assíncrono, polling
Todos os números nesta página vêm de a documentação da API da Photta · verificado
Os limites publicados
Taxa, janela, novas tentativas, tamanho de imagem e formatos, conforme descritos na documentação.
Limites
- 600 requisições por minuto por API key (Janela fixa; o limite é o mesmo em todos os planos)
- Um 429 retorna Retry-After: 30 segundos
- Até 10 MB por imagem
- Formatos: JPEG, PNG, WebP
- Batches concorrentes por plano: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Apenas polling — a API não envia webhooks.
Trabalho simultâneo por plano
Quantos lotes podem estar em andamento simultaneamente antes que um envio retorne 409.
Lotes em andamento por plano
Free
Simultâneos: 1
Hobby
Simultâneos: 2
Seller
Simultâneos: 3
Brand
Simultâneos: 4
Studio
Simultâneos: 6
Ficando dentro dos limites
Uma janela fixa
O limite é contabilizado por chave de API em uma janela fixa e é o mesmo em todos os planos. Duas chaves significam dois orçamentos.
Faça polling a cada 3 segundos
O polling é o único sinal de conclusão — a API não envia webhooks. A cada 3 segundos é o intervalo documentado; uma frequência maior consome sua cota com respostas vazias.
Use backoff exponencial
Após um 429, aguarde os segundos de Retry-After e aumente o intervalo a cada falha subsequente, em vez de tentar novamente a uma taxa fixa.
Batches possuem limites separados
O rate limit conta requisições; o limite de concorrência conta o trabalho em andamento. Um batch que excede o limite retorna 409, não 429.
Perguntas sobre rate limits
Qual é o rate limit?
600 requisições por minuto por chave de API, em uma janela fixa. A documentação publica o mesmo valor em todos os endpoints.
Com que frequência devo fazer polling de um job?
A cada 3 segundos. Não há webhooks, portanto o polling é o método documentado para saber se um job foi concluído.
Quanto é possível renderizar simultaneamente?
Batches em andamento são limitados por plano: Free 1, Hobby 2, Seller 3, Brand 4 e Studio 6. Acima do limite, o envio retorna 409.
O que devo fazer diante de um 429?
Leia o cabeçalho Retry-After, aguarde esse número de segundos e tente novamente com backoff exponencial. Enfileire o trabalho em vez de descartá-lo.
Endpoints e referências
Recursos
API de try-on virtual para roupas
API REST que veste roupas em manequins de IA. Assíncrona, geração em 1.5–4 minutos, 5 credits em 2K, 6 em 4K. Exemplos em cURL, Node.js e Python.
LerRecursos
API de try-on de joias para colares, anéis, pulseiras e brincos
Insira colares, anéis, pulseiras e brincos em modelos de IA via REST. 5 credits em 2K, manequins em close-up integrados, renderização sensível a reflexos direto da documentação da Photta.
LerRecursos
API de manequim invisível para fotos de produtos em manequim invisível
Endpoint de IA para manequim invisível. Remova o manequim de uma foto de roupa e preserve os detalhes internos. 3D ou flat-lay, processamento em lote, 4 credits em 2K.
LerReferência
Primeira imagem no Photta em menos de cinco minutos.
Cadastre-se, gere uma chave de API, execute sua primeira chamada cURL, faça polling até a conclusão, persista o resultado. Cinco etapas, documentadas de ponta a ponta.
LerReferência
Autenticação da Photta API
Como se autenticar na Photta API: o cabeçalho Authorization, o prefixo da chave, onde as chaves são criadas e como rotacioná-las com segurança.
LerReferência
Preços da API Photta
Quanto custa em credits cada endpoint da Photta API em 2K e 4K, como funcionam as cobranças e reembolsos, e quais endpoints são gratuitos. Sem preço monetário por imagem.
LerReferência
Erros da Photta API
A lista completa de tipos de erro da Photta API com seus status codes, o formato do corpo de erro e quais falhas valem a pena tentar novamente.
LerReferência
Endpoints de recursos da API Photta
Liste manequins, poses, fundos, calçados e etiquetas de marca, envie os seus próprios e consulte o saldo de credits. As consultas por trás de cada geração.
Ler
Todos os números nesta página vêm de a documentação da API da Photta · verificado
Experimente a API em cinco minutos
Gere uma chave de API do Photta, cole o snippet de cURL acima e você terá sua primeira imagem com modelo antes que o café termine de passar.
- 600 requisições/min
- Retry-After: 30s
- assíncrono, polling