Vêtements · Fonctionnalité

API d'essayage virtuel — Photta

Un seul appel REST transforme une photo de vêtement à plat en une image sur mannequin prête pour une campagne. Asynchrone, 1.5–4 minutes par génération, 5 crédits à 2K ou 7 crédits à 4K.

En une phrase

L'API d'essayage virtuel de Photta accepte une image de vêtement à plat, un mannequin_id et un pose_id, puis renvoie une photo sur mannequin en 2K ou 4K. Vous vous authentifiez avec `Authorization: Bearer photta_live_xxx`, effectuez un POST sur `/api/v1/tryon/apparel`, interrogez le même endpoint avec l'ID de génération reçu toutes les 3–5 secondes, et téléchargez le résultat quand le statut passe à `completed`.

Obtenir une clé API→Lire la documentation

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

À quoi s'attendre

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Code, de bout en bout

Choisissez votre langage

Le même endpoint, trois guides exécutables. Chaque extrait correspond à la documentation officielle de Photta.

SDK

→

Node.js

fetch natif dans Node 18+ · Prêt pour les server actions Next.js

SDK

→

Python

requests + un wrapper de 30 lignes · Django / FastAPI / Celery

SDK

→

cURL

Test shell de deux minutes · pipelines jq · zéro installation

Comment ça marche

Quatre appels API, une photo de produit

Choisissez un mannequin et une pose, soumettez la tâche, interrogez jusqu'à la fin, téléchargez le résultat.

01
Étape 1
Générer une clé API
Inscrivez-vous sur ai.photta.app, ouvrez l'onglet Développeurs, cliquez sur Générer une clé API. Les clés de production commencent par `photta_live_`. Stockez la clé dans `PHOTTA_API_KEY` — ne la committez jamais.
02
Étape 2
Choisir un mannequin et une pose
Appelez GET `/api/v1/mannequins` et `/api/v1/poses` pour lister les options disponibles. Choisissez des IDs qui correspondent à votre marque — la morphologie, l'expression, l'ethnicité et la catégorie de pose sont filtrables.
03
Étape 3
Soumettre la tâche d'essayage
Envoyez un POST à `/api/v1/tryon/apparel` avec `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. L'API renvoie 202 Accepted avec un ID de génération.
04
Étape 4
Interroger jusqu'à la fin de la tâche
Appelez GET `/api/v1/tryon/apparel/:id` toutes les 3 secondes. Quand `data.status` passe à `completed`, le payload inclut `output_url` et `thumbnail_url`. Fixez une limite maximale pour éviter qu'une tâche bloquée ne paralyse votre requête.
05
Étape 5
Télécharger et stocker
Récupérez les octets depuis `output_url` et stockez-les dans votre propre stockage objet. L'URL du CDN est stable mais votre produit ne devrait pas en dépendre pour l'affichage.

Questions fréquentes des développeurs

Questions des développeurs avant de déployer l'essayage de vêtements

Qu'est-ce que l'API d'essayage virtuel de Photta ?+

Un endpoint REST qui prend une image de produit à plat et une paire d'IDs (mannequin + pose) et renvoie une image réaliste sur mannequin. C'est le même pipeline que l'application grand public de Photta. Six types de produits sont supportés : haut, bas, haut+bas, robe, une-pièce, combinaison.

Quel est le coût par appel ?+

5 crédits pour un résultat en 2K, 7 crédits pour du 4K. Les crédits sont inclus dans votre abonnement et peuvent être rechargés. Les générations échouées ne coûtent pas de crédits — ils sont remboursés.

Combien de temps prend une génération ?+

La durée typique est de 1.5 à 4 minutes, mesurée de bout en bout. Le POST renvoie un ID de génération en moins d'une seconde ; le travail GPU se fait en arrière-plan pendant que vous interrogez l'API.

Quels types de produits sont supportés ?+

Six : `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Chacun attend une structure `product_images` différente — par exemple `top_and_bottom` nécessite les URLs de `top_image` et `bottom_image`.

Puis-je utiliser mon propre mannequin ?+

Oui. Téléchargez une photo de mannequin via `/api/v1/mannequins/upload` ou générez un nouveau mannequin IA avec `/api/v1/mannequins/generate-model`. L'ID retourné s'utilise directement dans la requête d'essayage.

Comment interroger le résultat ?+

Effectuez un GET sur `/api/v1/tryon/apparel/:id` toutes les 3 à 5 secondes jusqu'à ce que `data.status` soit `completed` ou `failed`. Fixez une limite de tentatives — 120 × 3s couvre largement la fenêtre documentée.

Contenu lié