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é | Limite | En cas de dépassement |
|---|---|---|
POST /generate | 300 requêtes par minute et par clé API, 600 par minute et par compte | 429 RATE_LIMITED avec Retry-After |
Mode test (mock=true) | 30 requêtes par minute et 500 par jour et par compte | 429 RATE_LIMITED avec Retry-After |
GET /credits | 60 requêtes par minute et par clé API | 429 RATE_LIMITED |
| Appels à l'outil MCP | 60 par minute par clé API | Résultat de l'erreur |
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id | 120 requêtes par minute et par clé API | 429 RATE_LIMITED |
GET /results/:id, GET /generations/:id, GET /batches/:id | 300 requêtes par minute et par clé API | 429 RATE_LIMITED |
POST /generations, POST /batches | Est pris en compte dans la limite de 300 générations par minute | 429 RATE_LIMITED |
| Tâches asynchrones s'exécutant simultanément | 50 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
| Limite | Valeur |
|---|---|
| Formats | JPEG, PNG, WebP, HEIC (vérification en fonction du contenu, et non du nom du fichier) |
| Taille maximale | 15 Mo par image |
garment_url | URL 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ésultat | Un 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 type | Mé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ête | 120 secondes. Définissez le délai d'expiration du client sur 120 secondes. |
| Vêtements en double | L'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
| Achat | Tout montant compris entre 50 et 100 000 par commande |
| Date d'expiration | Jamais |
| Essais infructueux | Remboursé 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 lot | Jusqu'à 500 éléments (10 en mode test) |
| Résultats | Conservés pendant 7 jours, puis supprimés |
| Réponse au webhook | Répondez par 2xx dans les 8 secondes ; les autres réponses feront l'objet de nouvelles tentatives pendant un jour maximum. |
| URL des webhooks | https public sur le port standard ; les redirections ne sont pas suivies |
| Tester le webhook | Jusqu'à 5 par minute depuis le tableau de bord |