Search docs

Search the TryOnCloud API docs

Commencer

Guide de démarrage rapide

Votre premier essai en cinq minutes : récupérez une clé, testez gratuitement, générez.

Les exemples de code, les points de terminaison et les codes d'erreur sont identiques dans tous les langages.

Votre premier essayage dans cinq minutes.

1. Obtenir une clé API

  1. Inscrivez-vous gratuitement. 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