Guides
Historique des modifications de l'API
Toutes les modifications apportées à l'API développeur, classées par ordre chronologique (les plus récentes en premier).
Les exemples de code, les points de terminaison et les codes d'erreur sont identiques dans tous les langages.
Modifications apportées à l'API pour développeurs, classées par ordre chronologique (les plus récentes en premier). Les formats de requêtes et de réponses existants ne sont pas modifiés sans préavis dans cette section ; de nouveaux champs et points de terminaison viennent s'y ajouter.
19 novembre 2026
- Nouveau : essais asynchrones : la requête
POST /api/v1/generationsrenvoie immédiatement une tâche ; vous pouvez la consulter viaGET /api/v1/generations/:id. Documentation - Nouveau : lots pouvant contenir jusqu'à 500 essais à partir d'URL d'images :
POST /api/v1/batches,GETetDELETE /api/v1/batches/:id(les articles annulés sont remboursés). Documentation - Nouveau : webhooks signés
generation.completed,generation.failedetbatch.completed, par requête (webhook_url) ou en tant que point de terminaison de compte avec sélection d'événements et événement de test dans Clés API > Webhooks. Documentation - Nouveau : la requête
GET /api/v1/results/:idpermet de télécharger un résultat enregistré associé à votre clé. Les résultats asynchrones sont conservés pendant 7 jours. - Nouveau : la commande
DELETE /api/v1/customers/:customer_idefface les résultats et les enregistrements stockés d'un utilisateur final. Le paramètrecustomer_idest accepté dans les commandes/generate,/generationset les éléments de traitement par lots. Documentation - Nouveauté : limite de crédit mensuelle et date d'expiration par clé, définies lors de la création de la clé. Dépassement de la limite :
402 KEY_LIMIT_REACHED. Documentation - Nouveau : mode test (
?mock=true) pour les tâches asynchrones et les traitements par lots (jusqu'à 10 éléments), gratuit. - Plus rapide : l'analyse du vêtement est mise en cache pendant 30 jours ; ainsi, lorsque vous essayez à nouveau le même produit à partir de la même photo, le temps de chargement est réduit d'environ 2 secondes.
- Tableau de bord : recherche par génération à l'aide de l'identifiant client ou de l'identifiant de demande, filtre par période, affichage en temps réel et exportation au format CSV. La vue d'ensemble affiche le temps médian et le temps p95, ainsi que l'autonomie financière.
- Sécurité : les webhooks sont envoyés uniquement vers des adresses publiques vérifiées au moment de la connexion ; ils ne suivent jamais les redirections.
18 novembre 2026
- Nouveau : en-tête
Idempotency-Keysur la requêtePOST /api/v1/generate; les tentatives de reconnexion ne sont jamais facturées deux fois. Documentation - Nouveauté : l'en-tête
X-Request-Iddans chaque réponse (et le champrequest_iddans le corps des messages d'erreur), ainsi que les en-têtesX-RateLimit-LimitetX-RateLimit-Remaining. - Nouveau : spécification OpenAPI 3.1 disponible à l'adresse
https://www.tryoncloud.com/api/v1/openapi.json. - Nouveau : les indicateurs de service public sont disponibles à l'adresse
GET /api/v1/statuset sur la page d'état. - Documentation : résolution de sortie indiquée : environ 1 mégapixel (classe 1K).
14 novembre 2026
- Nouveau : en-tête Webhook
x-tryoncloud-signature-v2, qui signe l'horodatage ainsi que le corps du message afin de permettre le rejet des anciennes livraisons. L'en-têtex-tryoncloud-signaturereste inchangé. Documentation - Modification : les limites de débit sont désormais appliquées sur tous les serveurs, avec une limite globale par compte de 600 requêtes de génération par minute et une limite distincte pour le mode test. Documentation
- Nouveau :
GET /api/v1/creditspour vérifier le nombre d'essais restants avec votre clé API. Documentation - Nouveau : serveur MCP à l'adresse
https://www.tryoncloud.com/api/mcppour Claude Code, Cursor et VS Code. Documentation - Nouveau : JavaScript/TypeScript SDK. Documentation
- Nouveau : mode test gratuit,
?mock=trueouX-Mock: true. Documentation - Nouveau :
DELETE /api/v1/results/:idpour supprimer prématurément un résultat enregistré. Documentation - Modification : le tarif « Enterprise » (à partir de 5 000 essais) passe de 0,08 $ à 0,07 $. En Inde, il reste à 6,50 ₹.
- Modification : les téléchargements via
garment_urlsont désormais vérifiés à chaque redirection et au moment de la connexion ; les adresses internes, privées et de métadonnées cloud sont refusées. - Documents : nouveaux documents de plusieurs pages comprenant des versions au format Markdown de chaque page, un accord de traitement des données et une autorisation de revente figurant dans les Conditions générales.
12 novembre 2026
- Modification : nouveaux tarifs pour chaque tranche : à partir de 50, 0,11 $ ; à partir de 300, 0,10 $ ; à partir de 1 000, 0,09 $ ; à partir de 5 000, 0,08 $.
- Nouveauté : clés API nommées, jusqu'à 5 clés actives, dates de dernière utilisation, révocation une par une.
5 novembre 2026
- Modification : la requête
POST /generaterenvoie désormais systématiquement le formatimage/png, conformément auContent-Typeindiqué dans la documentation.