Search docs

Search the TryOnCloud API docs

Référence de l'API

Limites

Limites de fréquence, limites d'images, délais d'expiration et vitesse.

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

Limites de débit

Point d'extrémitéLimiteEn cas de dépassement
POST /generate300 requêtes par minute et par clé API, 600 par minute et par compte429 RATE_LIMITED avec Retry-After
Mode test (mock=true)30 requêtes par minute et 500 par jour et par compte429 RATE_LIMITED avec Retry-After
GET /credits60 requêtes par minute et par clé API429 RATE_LIMITED
Appels à l'outil MCP60 par minute par clé APIRésultat de l'erreur
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 requêtes par minute et par clé API429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 requêtes par minute et par clé API429 RATE_LIMITED
POST /generations, POST /batchesEst pris en compte dans la limite de 300 générations par minute429 RATE_LIMITED
Tâches asynchrones s'exécutant simultanément50 par compte (les lots sont traités séparément)429 TOO_MANY_JOBS

La limite de génération constitue un dispositif de sécurité contre les fuites de clés et les boucles incontrôlées. Les intégrations réelles n'atteignent jamais cette limite. En cas de volume soutenu très élevé, veuillez nous contacter avant le lancement afin que nous puissions prévoir la capacité nécessaire.

Images

LimiteValeur
FormatsJPEG, PNG, WebP, HEIC (vérification en fonction du contenu, et non du nom du fichier)
Taille maximale15 Mo par image
garment_urlURL publique https sur le port 443 ou 80. Les adresses internes, privées et celles des métadonnées cloud sont bloquées, y compris via des redirections
RésultatUn fichier PNG par demande, d'environ 1 mégapixel (catégorie « 1K »), dont la forme correspond à celle de la photo de la personne. Les résolutions supérieures ne sont pas encore disponibles.

Heure

Production typeMédiane d'environ 19 secondes, 90 % des temps se situant dans une fourchette d'environ 24 secondes (trafic de production des 30 derniers jours)
Durée maximale d'une requête120 secondes. Définissez le délai d'expiration du client sur 120 secondes.
Vêtements en doubleL'analyse du vêtement est mise en cache pendant 30 jours ; ainsi, lorsqu'on essaie à nouveau le même vêtement à partir de la même photo, le temps de préparation est réduit d'environ 2 secondes.

Crédits

AchatTout montant compris entre 50 et 100 000 par commande
Date d'expirationJamais
Essais infructueuxRemboursé automatiquement
Limite mensuelle par cléFacultatif, à définir lors de la création de la clé. Tient compte du mois civil en cours (UTC) ; passé ce délai, la clé renvoie l'erreur 402 KEY_LIMIT_REACHED jusqu'au 1er du mois.
Expiration de la cléDate facultative ; la clé cesse de fonctionner après ce jour-là (UTC)

Tâches asynchrones et traitements par lots

Taille du lotJusqu'à 500 éléments (10 en mode test)
RésultatsConservés pendant 7 jours, puis supprimés
Réponse au webhookRépondez par 2xx dans les 8 secondes ; les autres réponses feront l'objet de nouvelles tentatives pendant un jour maximum.
URL des webhookshttps public sur le port standard ; les redirections ne sont pas suivies
Tester le webhookJusqu'à 5 par minute depuis le tableau de bord