Começar
Introdução rápida
A sua primeira experiência em cinco minutos: obtenha uma chave, teste gratuitamente, gere.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
A tua primeira prova de roupa daqui a cinco minutos.
1. Obter uma chave API
- Inscreva-se gratuitamente. Cada conta começa com 10 experimentações gratuitas.
- Aceda ao Painel > Chaves API e crie uma chave. Esta começa por
tk_dev_v1_e só é apresentada uma vez, por isso copie-a agora. - Guarde-a como uma variável de ambiente no seu servidor:
export TRYONCLOUD_API_KEY="tk_dev_v1_your_key_here"2. Experimente gratuitamente com o modo de simulação
Adicione ?mock=true. O pedido é autenticado e ambas as imagens são validadas exatamente como numa chamada real, mas nada é gerado e nada é cobrado. A imagem da pessoa é devolvida sem alterações.
curl -X POST "https://www.tryoncloud.com/api/v1/generate?mock=true" \
-H "X-API-KEY: $TRYONCLOUD_API_KEY" \
-F "garment_image=@shirt.jpg" \
-F "person_image=@person.jpg" \
-o mock.png -D -Procure por X-Mock: 1 nos cabeçalhos da resposta. Utilize o modo de simulação durante a compilação.
3. Simular uma experiência de experimentação real
Remova ?mock=true:
curl -X POST "https://www.tryoncloud.com/api/v1/generate" \
-H "X-API-KEY: $TRYONCLOUD_API_KEY" \
-F "garment_image=@shirt.jpg" \
-F "person_image=@person.jpg" \
-o result.pngresult.png mostra o cliente a usar a peça de roupa. Um resultado típico demora cerca de 20 segundos, por isso defina um tempo limite de, pelo menos, 120 segundos para o seu cliente HTTP.
4. Verifica o que ainda te resta
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"As melhores fotografias para os melhores resultados
- Pessoa: uma pessoa, corpo inteiro, de frente para a câmara, com boa iluminação e, se possível, num fundo liso.
- Peça de vestuário: uma fotografia nítida do produto vista de frente, com um modelo a vesti-la ou estendida sobre um fundo liso.
- As peças de vestuário drapeadas (saris, dhotis) ficam melhor quando a fotografia do produto mostra a peça drapeada num modelo.
Próximos passos
- Exemplos completos em Node.js, Next.js, Python e PHP
- Erros e quando voltar a tentar
- Tarefas assíncronas, lotes e webhooks para tarefas longas e trabalho de catálogo
- Crie uma chave por aplicação ou ambiente, com um limite mensal de créditos opcional, em API Keys
- Compre créditos quando estiver pronto para entrar em funcionamento