Referência da API
Limites
Limites de taxa, limites de imagens, tempos de espera e velocidade.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
Limites de taxa
| Ponto final | Limite | Quando for excedido |
|---|---|---|
POST /generate | 300 pedidos por minuto por chave API, 600 por minuto por conta | 429 RATE_LIMITED com Retry-After |
Modo de teste (mock=true) | 30 pedidos por minuto e 500 por dia por conta | 429 RATE_LIMITED com Retry-After |
GET /credits | 60 pedidos por minuto por chave API | 429 RATE_LIMITED |
| Chamadas à ferramenta MCP | 60 por minuto por chave API | Resultado do erro |
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id | 120 pedidos por minuto por chave de API | 429 RATE_LIMITED |
GET /results/:id, GET /generations/:id, GET /batches/:id | 300 pedidos por minuto por chave API | 429 RATE_LIMITED |
POST /generations, POST /batches | Contar para o limite de 300 por minuto | 429 RATE_LIMITED |
| Tarefas assíncronas a serem executadas simultaneamente | 50 por conta (os lotes são separados) | 429 TOO_MANY_JOBS |
O limite de geração é uma medida de segurança contra fugas de chaves e loops descontrolados. As integrações reais não atingem esse limite. No caso de um volume sustentado muito elevado, contacte-nos antes do lançamento para que possamos planear a capacidade.
Imagens
| Limite | Valor |
|---|---|
| Formatos | JPEG, PNG, WebP, HEIC (verificados pelo conteúdo, e não pelo nome do ficheiro) |
| Tamanho máximo | 15 MB por imagem |
garment_url | URL pública https na porta 443 ou 80. Os endereços internos, privados e de metadados na nuvem estão bloqueados, inclusive através de redirecionamentos |
| Resultado | Um ficheiro PNG por pedido, com cerca de 1 megapixel (da classe «1K»), com o formato da fotografia da pessoa. Ainda não estão disponíveis resoluções mais elevadas |
Hora
| Geração típica | Mediana de cerca de 19 segundos, 90 % dentro de cerca de 24 segundos (tráfego de produção dos últimos 30 dias) |
| Tempo máximo de pedido | 120 segundos. Defina o tempo limite do cliente para 120 segundos |
| Peças de vestuário repetidas | A análise da peça de roupa fica armazenada em cache durante 30 dias, pelo que uma nova experiência com a mesma fotografia da peça de roupa permite poupar cerca de 2 segundos de preparação |
Créditos
| Compra | Qualquer quantidade entre 50 e 100 000 por encomenda |
| Prazo de validade | Nunca |
| Experiências de vestido que não deram certo | Reembolsado automaticamente |
| Limite mensal por chave | Opcional, definido aquando da criação da chave. Contabiliza este mês civil (UTC); após essa data, a chave recebe o código de erro 402 KEY_LIMIT_REACHED até ao dia 1. |
| Caducidade da chave | Data opcional; a chave deixa de funcionar após esse dia (UTC) |
Tarefas assíncronas e lotes
| Tamanho do lote | Até 500 itens (10 no modo de teste) |
| Resultados | Ficam guardados durante 7 dias e, depois, são eliminados |
| Resposta do webhook | Responda com 2xx no prazo de 8 segundos; as outras respostas serão repetidas até um dia |
| URLs de webhooks | https público na porta padrão; os redirecionamentos não são seguidos |
| Testar o webhook | Até 5 por minuto a partir do painel de controlo |