Référence · Rate limits
Rate limits de l'API Photta et comment effectuer un polling propre
En une phrase
L'API Photta autorise 600 requêtes par minute et par clé API dans une fenêtre fixe. Une 429 renvoie Retry-After: 30. Effectuez un polling d'un job toutes les 3 secondes ; les tâches simultanées sont limitées selon le forfait.
- Limites: 600 requêtes/min
- Retry-After: Retry-After: 30s
- Traitement: asynchrone, polling
Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié
Les limites publiées
Débit, fenêtre, retry, taille d'image et formats, tels qu'indiqués dans la documentation.
Limites
- 600 requêtes par minute par clé API (Fenêtre fixe ; la limite est identique sur tous les forfaits)
- Une 429 renvoie Retry-After: 30 secondes
- Jusqu'à 10 Mo par image
- Formats: JPEG, PNG, WebP
- Lots simultanés par forfait: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Polling uniquement — l'API n'envoie aucun webhook.
Tâches simultanées par forfait
Combien de lots peuvent être en cours en même temps avant qu'une soumission ne renvoie une 409.
Lots en cours par forfait
Free
Simultané: 1
Hobby
Simultané: 2
Seller
Simultané: 3
Brand
Simultané: 4
Studio
Simultané: 6
Rester dans les limites
Une fenêtre fixe
La limite est décomptée par clé API dans une fenêtre fixe, et reste identique pour chaque forfait. Deux clés signifient deux budgets.
Effectuez un polling toutes les 3 secondes
Le polling est l'unique signal de fin d'exécution — l'API n'envoie pas de webhooks. 3 secondes est l'intervalle documenté ; aller plus vite épuise votre budget sur des réponses vides.
Appliquez un backoff exponentiel
Après un 429, attendez le nombre de secondes indiqué par Retry-After, puis augmentez l’intervalle à chaque échec supplémentaire au lieu de réessayer à fréquence fixe.
Les lots sont limités séparément
Le rate limit décompte les requêtes ; la limite de concurrence décompte les tâches en cours. Un lot qui dépasse cette limite renvoie 409, pas 429.
Questions sur les rate limits
Quel est le rate limit ?
600 requêtes par minute par clé d’API, sur une fenêtre fixe. La documentation indique le même chiffre sur chaque endpoint.
À quelle fréquence dois-je faire du polling sur un job ?
Toutes les 3 secondes. Il n’y a pas de webhooks, le polling est donc la méthode documentée pour savoir qu’un job est terminé.
Combien de rendus peuvent tourner simultanément ?
Les lots en cours sont plafonnés selon le forfait : Free 1, Hobby 2, Seller 3, Brand 4 et Studio 6. Au-delà du plafond, une soumission renvoie 409.
Que dois-je faire en cas de 429 ?
Lisez l’en-tête Retry-After, attendez ce nombre de secondes, puis réessayez avec un backoff exponentiel. Mettez le travail en file d’attente plutôt que de l’abandonner.
Endpoints et références
Fonctionnalités
API de try-on virtuel pour les vêtements
API REST qui positionne des vêtements sur des mannequins générés par IA. Traitement asynchrone, génération en 1.5–4 minutes, 5 crédits en 2K, 6 en 4K. Exemples en cURL, Node.js et Python.
LireFonctionnalités
API de try-on de bijoux pour colliers, bagues, bracelets et boucles d'oreilles
Positionnez colliers, bagues, bracelets et boucles d'oreilles sur des modèles IA via REST. 5 crédits en 2K, mannequins gros plan intégrés, rendu gérant les reflets d'après la documentation de Photta.
LireFonctionnalités
API mannequin fantôme pour des photos de produits sur mannequin invisible
Endpoint AI de mannequin fantôme. Supprimez le mannequin d'une photo de vêtement et préservez les détails intérieurs. 3D ou flat-lay, traitement par lots, 4 crédits en 2K.
LireRéférence
Première image Photta en moins de cinq minutes.
Inscrivez-vous, générez une clé d'API, lancez votre premier appel cURL, effectuez le polling jusqu'à la complétion, persistez le résultat. Cinq étapes documentées de bout en bout.
LireRéférence
Authentification de l’API Photta
Comment s’authentifier auprès de l’API Photta : l’en-tête Authorization, le préfixe de clé, l’endroit où les clés sont créées et comment en effectuer la rotation en toute sécurité.
LireRéférence
Tarification de l'API Photta
Le coût en crédits de chaque endpoint de l’API Photta en 2K et 4K, le fonctionnement de la facturation et des remboursements, et les endpoints gratuits. Aucun prix monétaire par image.
LireRéférence
Erreurs de l’API Photta
La liste complète des types d’erreurs de l’API Photta avec leurs codes de statut, la structure du corps d’erreur et les échecs pouvant être réessayés.
LireRéférence
Endpoints de ressources de l'API Photta
Listez les mannequins, poses, arrière-plans, chaussures et étiquettes de marque, importez les vôtres et consultez votre solde de crédits. Les référentiels derrière chaque génération.
Lire
Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié
Testez l'API en cinq minutes
Générez une clé d'API Photta, collez le snippet cURL ci-dessus, et vous obtiendrez votre première photo portée sur modèle avant même que le café ait fini de couler.
- 600 requêtes/min
- Retry-After: 30s
- asynchrone, polling