# Guide de démarrage rapide

Votre premier essayage dans cinq minutes.

## 1. Obtenir une clé API

1. [Inscrivez-vous gratuitement](/signup). Chaque compte dispose d'un crédit initial de 10 essais gratuits.
2. Ouvrez **Dashboard > Clés API** et créez une clé. Elle commence par `tk_dev_v1_` et n'apparaît **qu'une seule fois** ; copiez-la donc dès maintenant.
3. Enregistrez-la en tant que variable d'environnement sur votre serveur :

```bash
export TRYONCLOUD_API_KEY="tk_dev_v1_your_key_here"
```

## 2. Testez gratuitement grâce au mode simulation

Ajoutez `?mock=true`. La requête est authentifiée et les deux images sont validées exactement comme lors d'un appel réel, mais rien n'est généré et rien n'est facturé. L'image de la personne est renvoyée telle quelle.

```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 -
```

Recherchez la valeur `X-Mock: 1`` dans les en-têtes de réponse. Utilisez le mode « mock » pendant la compilation.

## 3. Simuler un véritable essayage

Supprimez `?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` : il s'agit de la cliente portant le vêtement. Un résultat typique prend environ 20 secondes ; veillez donc à définir un délai d'expiration d'au moins 120 secondes pour votre client HTTP.

## 4. Vérifiez ce qu'il vous reste

```bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"
```

## Les meilleures photos pour un résultat optimal

- **Personne :** une seule personne, en pied, face à l'appareil photo, bien éclairée, sur fond uni si possible.
- **Vêtement :** une photo claire du produit vue de face, sur un mannequin ou à plat sur un fond uni.
- **Les vêtements drapés** (saris, dhotis) sont mieux mis en valeur lorsque la photo du produit montre le vêtement drapé sur un mannequin.

## Prochaines étapes

- [Exemples complets](/docs/examples) en Node.js, Next.js, Python et PHP
- [Erreurs](/docs/errors) et quand réessayer
- [Tâches asynchrones, lots et webhooks](/docs/async) pour les tâches longues et le travail sur catalogue
- Créez une clé par application ou environnement, avec une limite mensuelle de crédits facultative, dans **API Keys**
- [Achetez des crédits](/pricing#developer-api) lorsque vous êtes prêt à mettre votre site en ligne
