Guide · Virtual try-on

Qu'est-ce qu'une API de virtual try-on ? et ce qu'elle renvoie

En une phrase

Une API de virtual try-on prend une photo de vêtement et renvoie une image de ce vêtement porté par un mannequin. Vous envoyez la photo en POST avec un mannequin et une pose, effectuez le polling du job, puis téléchargez le résultat.

Obtenir une clé APIConsulter la documentation
  • Délai typique: 1.5–4 min
  • Crédits: 5 crédits en 2K · 6 crédits en 4K
  • Traitement: asynchrone, polling

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

La réponse courte

Une API de virtual try-on est un endpoint HTTP qui applique un vêtement sur un mannequin. Vous envoyez une photographie du produit — généralement la photo à plat ou sur mannequin que vous avez déjà — et le service renvoie une image de ce vêtement porté. Pas de studio, pas de réservation de modèle, pas de nouveau shooting quand le coloris change.

L’appel est asynchrone car le rendu prend plus de temps qu’une requête ne devrait attendre. Vous effectuez un POST du vêtement avec le modèle et la pose souhaités, l’API accepte le job et renvoie un id, puis vous effectuez un polling sur un endpoint de statut jusqu’à ce que le job indique qu’il est terminé. L’image finale arrive sous la forme d’une URL que vous téléchargez et stockez vous-même.

Les appelants habituels sont les équipes catalogue qui ont besoin de visuels portés pour des produits qui ne passent jamais en studio, les marketplaces qui reçoivent des photos à plat de la part des vendeurs, et les applications qui permettent à un acheteur de voir un vêtement sur une morphologie différente du mannequin unique de la marque.

L'endpoint dédié

Extrait de la documentation de l'API Photta, non rédigé à la main.

En un coup d'œil

Endpoint
POST /api/v1/tryon/apparel
Authentification
Clé API Bearer
Traitement
Asynchrone — interrogez l'endpoint de statut par polling
Délai typique
1.5–4 min
Crédits
5 crédits en 2K · 6 crédits en 4K
Rapports d'aspect
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Limites d'entrée
Jusqu'à 10 Mo par image ; JPEG, PNG, WebP
Idempotent
Non

Ce qu'il faut rechercher dans toute API de try-on

  • Ce que vous envoyez

    Une photographie du vêtement sous forme d’URL https ou d’URI de données base64, ainsi que le modèle et la pose souhaités. Photta accepte JPEG, PNG et WebP jusqu’à 10 MB par image.

  • Combien de temps cela prend

    Suffisamment longtemps pour ne pas pouvoir être géré au sein d’une requête web synchrone. Photta publie un délai d’exécution moyen par endpoint et attend un polling toutes les 3 secondes — il n’y a aucun webhook.

  • Combien cela coûte

    Photta facture des credits par appel, 5 en 2K et 6 en 4K pour le try-on de vêtements, déduits au lancement du job et remboursés automatiquement en cas d’échec.

  • Quelles sont les limites appliquées

    Un rate limit officiel de 600 requêtes par minute par clé, et un plafond par plan sur le volume pouvant être rendu simultanément. Il est recommandé de consulter ces deux informations avant de traiter un catalogue entier.

La première requête

Le même appel en cURL, Node.js et Python.

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')

Questions sur les API de virtual try-on

Que renvoie une API de try-on ?

Une image du vêtement porté par le modèle choisi, fournie sous la forme d’une URL dans le job terminé. Téléchargez-la et stockez-la — une URL de livraison n’est pas un hébergement permanent.

Ai-je besoin de la photo d’un modèle ?

Non. Photta fournit un catalogue de mannequins dans lequel vous pouvez faire votre choix, et vous pouvez générer votre propre modèle à partir d’attributs ou en importer un. La photographie du vêtement est la seule image que vous devez fournir.

En quoi cela diffère-t-il d’une cabine d’essayage virtuelle ?

Une cabine d’essayage est une fonctionnalité orientée utilisateur final. Une API de try-on est l’étape de rendu sous-jacente : un appel en entrée, une image en sortie. Vous pouvez construire une cabine d’essayage par-dessus, ou l’utiliser uniquement pour générer des photos de catalogue.

Combien coûte un appel de try-on ?

Avec Photta, 5 credits en 2K et 6 en 4K. Les jobs en échec sont remboursés, le coût d’un retry correspond donc au retry lui-même.

Combien de temps prend une image ?

L’endpoint affiche son délai d’exécution moyen, et le job indique son propre statut. Effectuez un polling toutes les 3 secondes plutôt que d’estimer une durée.

À lire ensuite

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

Testez sur votre propre photo de produit

Une requête, un polling, une image.

Créer un compte et obtenir une clé APIVoir l'endpoint
  • 1.5–4 min
  • 5 crédits en 2K · 6 crédits en 4K
  • asynchrone, polling