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
- Inscrivez-vous gratuitement. Chaque compte dispose d'un crédit initial de 10 essais gratuits.
- 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. - Enregistrez-la en tant que variable d'environnement sur votre serveur :
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.
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 :
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 : 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
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 en Node.js, Next.js, Python et PHP
- Erreurs et quand réessayer
- Tâches asynchrones, lots et webhooks 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 lorsque vous êtes prêt à mettre votre site en ligne