Guias
Registo de alterações da API
Todas as alterações à API do Desenvolvedor, com as mais recentes em primeiro lugar.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
Alterações à API para programadores, com as mais recentes em primeiro lugar. Os formatos de pedidos e respostas existentes não sofrem alterações sem aviso prévio nesta secção; são adicionados novos campos e pontos de extremidade a par destes.
19 de novembro de 2026
- Novidade: Testes assíncronos:
POST /api/v1/generationsdevolve uma tarefa de uma só vez; consulte-a emGET /api/v1/generations/:id. Documentação - Novidade: Lotes de até 500 experimentações a partir de URLs de imagens:
POST /api/v1/batches,GETeDELETE /api/v1/batches/:id(os artigos cancelados são reembolsados). Documentação - Novidade: Webhooks assinados
generation.completed,generation.failedebatch.completed, por pedido (webhook_url) ou como um ponto final da conta com seleção de eventos e um evento de teste em Chaves API > Webhooks. Documentação - Novidade:
GET /api/v1/results/:idpermite descarregar um resultado guardado com a sua chave. Os resultados assíncronos são mantidos durante 7 dias. - Novo:
DELETE /api/v1/customers/:customer_idapaga os resultados e registos armazenados de um utilizador final. Ocustomer_idé aceite nas chamadas/generate,/generationse em itens em lote. Documentação - Novidade: Limite de crédito mensal por chave e data de validade, definidos aquando da criação da chave. Excedimento do limite:
402 KEY_LIMIT_REACHED. Documentação - Novidade: Modo de teste (
?mock=true) para tarefas assíncronas e lotes (até 10 itens), gratuito. - Mais rápido: a análise da peça de roupa fica armazenada em cache durante 30 dias, pelo que as novas experiências com a mesma fotografia do produto poupam cerca de 2 segundos.
- Painel: Pesquisa por gerações através do ID do cliente ou do ID do pedido, filtro de período, visualização em tempo real e exportação para CSV. A visão geral apresenta o tempo mediano e o tempo p95, bem como a autonomia de crédito.
- Segurança: Os webhooks são enviados apenas para endereços públicos verificados no momento da ligação, nunca seguindo redirecionamentos.
18 de novembro de 2026
- Novidade: cabeçalho
Idempotency-Keyna chamadaPOST /api/v1/generate; as tentativas de repetição nunca são cobradas duas vezes. Documentação - Novidade:
X-Request-Idem todas as respostas (erequest_idnos corpos das respostas de erro), além deX-RateLimit-LimiteX-RateLimit-Remaining. - Novidade: Especificação OpenAPI 3.1 em
https://www.tryoncloud.com/api/v1/openapi.json. - Novidade: Dados sobre os serviços públicos em
GET /api/v1/statuse na página de estado. - Documentação: Resolução de saída indicada: cerca de 1 megapixel (da classe 1K).
14 de novembro de 2026
- Novidade: o cabeçalho de webhook
x-tryoncloud-signature-v2, que assina o carimbo temporal juntamente com o corpo da mensagem, para que as entregas antigas possam ser rejeitadas. Ox-tryoncloud-signaturepermanece inalterado. Documentação - Alteração: Os limites de taxa são agora aplicados em todos os servidores, com um limite global por conta de 600 pedidos de geração por minuto e um limite separado para o modo de teste. Documentação
- Novo:
GET /api/v1/creditspara verificar as tentativas restantes com a sua chave API. Documentação - Novidade: servidor MCP em
https://www.tryoncloud.com/api/mcppara o Claude Code, o Cursor e o VS Code. Documentação - Novidade: JavaScript/TypeScript SDK. Documentação
- Novidade: Modo de teste gratuito,
?mock=trueouX-Mock: true. Documentação - Novidade:
DELETE /api/v1/results/:idpara eliminar antecipadamente um resultado armazenado. Documentação - Alteração: O preço para empresas (5 000 ou mais experimentações) foi reduzido de 0,08 $ para 0,07 $. Na Índia, mantém-se em 6,50 ₹.
- Alteração: os downloads de
garment_urlsão agora verificados em cada redirecionamento e no momento da ligação; os endereços internos, privados e de metadados na nuvem são recusados. - Documentação: Novos documentos com várias páginas, incluindo versões em Markdown de cada página, um Acordo de Tratamento de Dados e uma autorização de revenda nos Termos.
12 de novembro de 2026
- Alterado: Novos preços para cada quantidade: 50 ou mais = 0,11 $, 300 ou mais = 0,10 $, 1 000 ou mais = 0,09 $, 5 000 ou mais = 0,08 $.
- Novidade: Chaves API com nome, até 5 ativas, datas da última utilização, revogação uma de cada vez.
5 de novembro de 2026
- Alteração:
POST /generatedevolve sempreimage/png, em conformidade com oContent-Typedocumentado.