Photta API
Photta API try-on virtuel, mannequin fantôme et photographie produit via REST
En une phrase
L'API Photta est une API REST basée sur des crédits : envoyez une photo de produit en POST à l'endpoint d'une fonctionnalité, interrogez son statusEndpoint toutes les quelques secondes, téléchargez l'image finale. Huit fonctionnalités, une seule clé, un seul solde de crédits.
- Fonctionnalités: 8 fonctionnalités
- Rate limit: 600 requêtes/min
- Authentification: Clé Bearer
- Pattern: asynchrone, polling
Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": True,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
},
)
data = res.json()["data"] # data["id"], data["status"]Fonctionnalités
Tous les endpoints, par fonctionnalité
Méthode, chemin, crédits et temps indicatif, directement issus de la documentation de l'API. Les informations de cette page sont vérifiées par rapport à la documentation à la date indiquée en bas.
- POST/api/v1/tryon/apparel
Try-on virtuel (Vêtements)
Appliquez un vêtement à plat (flat-lay) sur un mannequin IA avec l'expression et la morphologie de votre choix. Quatre types de produits, cinq ratios d'aspect.
5 crédits en 2K · 6 crédits en 4K1.5–4 min
Voir l'endpoint - POST/api/v1/tryon/jewelry
Try-on de bijoux
Gros plans serrés de colliers, bagues, bracelets et boucles d'oreilles sur des mannequins dédiés aux bijoux — reflets et surfaces minuscules gérés.
5 crédits en 2K · 6 crédits en 4K1.5–4 min
Voir l'endpoint - POST/api/v1/ghost-mannequin
Mannequin invisible (Ghost Mannequin)
Supprimez le mannequin d'une photo de vêtement tout en préservant la structure intérieure intacte. Rendu 3D ou à plat (flat-lay), adapté au traitement par lot.
4 crédits en 2K · 5 crédits en 4K1.5–4 min
Voir l'endpoint - POST/api/v1/ghost-mannequin/batch
Ghost Mannequin par lot
Soumettez une série complète de photos de vêtements en un seul appel et effectuez le polling sur un seul identifiant de lot ; chaque image est tarifiée et suivie individuellement.
4 crédits en 2K · 5 crédits en 4K1.5–4 min per image
Voir l'endpoint - POST/api/v1/eyewear-studio
Studio Lunettes
Lunettes de vue et lunettes de soleil générées sur des modèles en gros plan, avec une monture fidèle à votre photo produit.
5 crédits en 2K · 6 crédits en 4K20–60 sec
Voir l'endpoint - POST/api/v1/detail-photos
Photos de détails
Gros plans sur les coutures, le tissu, les ferrures et les étiquettes à partir d'une seule photo produit ; un analyseur suggère les zones à photographier.
3 crédits20–60 sec
Voir l'endpoint - POST/api/v1/mannequins/generate
Génération de mannequins
Générez vos propres mannequins de vêtements ou de bijoux à partir d'options, puis réutilisez leurs identifiants dans chaque appel de try-on.
4 crédits30-60s
Voir l'endpoint - POST/api/v1/workflows/{workflow_id}
Workflows
Exécutez un workflow prédéfini — un plan principal (hero shot) pour un bijou, par exemple — en un seul appel et obtenez un ensemble d'images finalisées.
4 crédits en 2K · 5 crédits en 4K20–60 sec / image
Voir l'endpoint
Langages
Pas encore de SDK — et vous n'en avez pas besoin.
Trois guides prêts à copier-coller, conformes à ce que la documentation de Photta recommande aujourd'hui.
Node.js
Node.js
fetch natif dans Node 18+, helper de 20 lignes, prêt pour les server actions Next.js.
LirePython
Python
Bibliothèque requests + un wrapper de 30 lignes. Fonctionne avec Django, FastAPI, Celery, Lambda.
LirecURL
cURL
Smoke test de deux minutes pour n'importe quel endpoint. À combiner avec jq pour vos pipelines shell.
Lire
Démarrage rapide
De l'inscription à la première image en cinq minutes.
Chaque fonctionnalité suit le même schéma : authentification, soumission, polling. Apprenez-le une seule fois.
Étape 1: Inscrivez-vous sur ai.photta.app et générez une clé d'API live depuis le tableau de bord Developers.
Étape 2: Envoyez le job en POST avec votre clé dans le header Authorization — l'API renvoie immédiatement un ID de génération.
Étape 3: Interrogez le même endpoint en polling toutes les 3 secondes jusqu'à ce que le statut passe à completed, puis téléchargez l'URL du résultat.
Questions
Ce que les développeurs demandent avant de s'inscrire
Qu'est-ce que l'API Photta ?
L'API de Photta est un service REST basé sur des crédits qui génère des photographies de mode professionnelles à partir de vos photos de produits. C'est le même pipeline qui alimente les applications grand public de Photta — try-on virtuel de vêtements, try-on de bijoux et extraction de mannequin fantôme, exposé sous forme de huit fonctionnalités pour permettre aux développeurs de créer leurs propres outils.
Comment obtenir une clé d'API ?
Inscrivez-vous sur ai.photta.app, ouvrez la section Developers du tableau de bord, cliquez sur Generate API key. Votre clé live commence par `photta_live_` suivi de 32 caractères hexadécimaux. Conservez-la dans une variable d'environnement — ne la committez jamais dans votre gestionnaire de versions, ne l'exposez jamais côté navigateur.
Existe-t-il une offre gratuite ?
Les nouveaux comptes reçoivent des crédits d'essai utilisables sur n'importe quelle fonctionnalité. Dès que vous êtes prêt pour la production, souscrivez à un forfait avec un solde mensuel de crédits plus élevé. Le rate limit est identique pour tous les forfaits : 600 requêtes par minute et par clé d'API. Aucun minimum par appel.
Quelle est la vitesse de génération ?
Les jobs de try-on et de mannequin fantôme prennent généralement entre 1.5 et 4 minutes ; les photos de lunettes, photos de détails et images de workflow entre 20 et 60 secondes ; la génération de mannequin entre 30 et 60 secondes. Chaque endpoint de génération est asynchrone : le POST renvoie immédiatement un ID de génération, et vous effectuez un polling toutes les 3 à 5 secondes jusqu'à la fin du traitement. Aucune connexion HTTP longue durée à maintenir.
Existe-t-il un SDK Photta officiel ?
Pas pour le moment. L'intégration recommandée se fait directement en REST via cURL, le fetch natif de Node ou la bibliothèque requests de Python — tous trois documentés de bout en bout sur ce site, pour chaque fonctionnalité.
Référence
Les sections de la documentation que vous consulterez plus d'une fois.
Ré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 credits 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
Rate limits de l'API Photta
La rate limit de l'API Photta, sa fenêtre, l'en-tête Retry-After, l'intervalle de polling et les plafonds de simultanéité par forfait, tels que documentés dans l'API.
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 credits. Les référentiels derrière chaque génération.
LireGuides
Qu'est-ce qu'une API de virtual try-on ?
Une API de virtual try-on génère le rendu d'un vêtement sur un mannequin à partir d'une seule photo de produit. Ce qu'elle accepte, ce qu'elle renvoie, ce qu'elle coûte et sa durée d'exécution.
LireGuides
Qu’est-ce qu’une API de ghost mannequin ?
Une API de ghost mannequin supprime le mannequin d’une photo de vêtement et reconstruit l’intérieur. Les entrées requises, le retour fourni et le coût.
LireGuides
Migrer de FASHN vers Photta
Ce qui change lors du passage d'une intégration virtual try-on de FASHN à Photta : authentification, corps de la requête, polling et facturation des credits.
LireDévelopper
Développer avec l’API Photta
Huit recettes de bout en bout pour l’API Photta : une application de try-on, une application Shopify, un plugin WooCommerce, un worker Django, des catalogues par lots et de l’automatisation no-code.
LireComparer
Meilleures API de virtual try-on
Comment fonctionnent cinq API de virtual try-on — Photta, FASHN, FitRoom, Pixazo et Ayna. Ce que chacune publie, ce qu'elle ne publie pas, et où consulter les détails.
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.
- 8 fonctionnalités
- 600 requêtes/min
- Clé Bearer
- asynchrone, polling