Search docs

Search the TryOnCloud API docs

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 finalLimiteQuando for excedido
POST /generate300 pedidos por minuto por chave API, 600 por minuto por conta429 RATE_LIMITED com Retry-After
Modo de teste (mock=true)30 pedidos por minuto e 500 por dia por conta429 RATE_LIMITED com Retry-After
GET /credits60 pedidos por minuto por chave API429 RATE_LIMITED
Chamadas à ferramenta MCP60 por minuto por chave APIResultado do erro
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 pedidos por minuto por chave de API429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 pedidos por minuto por chave API429 RATE_LIMITED
POST /generations, POST /batchesContar para o limite de 300 por minuto429 RATE_LIMITED
Tarefas assíncronas a serem executadas simultaneamente50 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

LimiteValor
FormatosJPEG, PNG, WebP, HEIC (verificados pelo conteúdo, e não pelo nome do ficheiro)
Tamanho máximo15 MB por imagem
garment_urlURL 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
ResultadoUm 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ípicaMediana 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 pedido120 segundos. Defina o tempo limite do cliente para 120 segundos
Peças de vestuário repetidasA 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

CompraQualquer quantidade entre 50 e 100 000 por encomenda
Prazo de validadeNunca
Experiências de vestido que não deram certoReembolsado automaticamente
Limite mensal por chaveOpcional, 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 chaveData opcional; a chave deixa de funcionar após esse dia (UTC)

Tarefas assíncronas e lotes

Tamanho do loteAté 500 itens (10 no modo de teste)
ResultadosFicam guardados durante 7 dias e, depois, são eliminados
Resposta do webhookResponda com 2xx no prazo de 8 segundos; as outras respostas serão repetidas até um dia
URLs de webhookshttps público na porta padrão; os redirecionamentos não são seguidos
Testar o webhookAté 5 por minuto a partir do painel de controlo