Search docs

Search the TryOnCloud API docs

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

  1. Inscreva-se gratuitamente. Cada conta começa com 10 experimentações gratuitas.
  2. 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.
  3. Guarde-a como uma variável de ambiente no seu servidor:
bash
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.

bash
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:

bash
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.png

result.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

bash
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