# Introdução rápida

A tua primeira prova de roupa daqui a cinco minutos.

## 1. Obter uma chave API

1. [Inscreva-se gratuitamente](/signup). 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

- [Exemplos completos](/docs/examples) em Node.js, Next.js, Python e PHP
- [Erros](/docs/errors) e quando voltar a tentar
- [Tarefas assíncronas, lotes e webhooks](/docs/async) 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](/pricing#developer-api) quando estiver pronto para entrar em funcionamento
