# Limites

## 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](/contact) 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 |
