Guide · Ghost mannequin

Qu’est-ce qu’une API de ghost mannequin ? le rendu mannequin invisible

En une phrase

Une API de ghost mannequin prend une photographie de vêtement sur mannequin et renvoie ce même vêtement sans le mannequin, avec l’intérieur reconstitué, pour donner l’impression que la pièce conserve sa propre forme.

  • Délai typique: 1.5–4 min
  • Crédits: 4 crédits en 2K · 5 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

La photographie ghost mannequin — également appelée mannequin invisible ou hollow man — montre un vêtement qui conserve sa forme sans aucun corps à l'intérieur. Traditionnellement, le rendu est assemblé en post-production à partir de plusieurs prises studio : le vêtement sur mannequin, le mannequin effacé, puis l'intérieur du col et des poignets réincrustés par composition.

Une API de ghost mannequin effectue cela en un seul appel. Vous envoyez la photo sur mannequin, le service supprime le support et reconstruit ce qui doit être visible à l'intérieur du vêtement — l'intérieur de l'encolure, la doublure des poignets, la ceinture — et renvoie l'image finale. Comme pour le try-on, l'appel est asynchrone : soumission, polling, téléchargement.

C'est le traitement standard des pages de détails de produits pour l'habillement. Les appelants sont donc des équipes de catalogue et des marketplaces qui exigent un rendu cohérent sur des milliers d'articles sans réserver de créneaux en studio par vêtement.

L’endpoint dédié

Issu de la documentation de l’API Photta, rédigé sans intervention manuelle.

En un coup d'œil

Endpoint
POST /api/v1/ghost-mannequin
Authentification
Clé API Bearer
Traitement
Asynchrone — interrogez l'endpoint de statut par polling
Délai typique
1.5–4 min
Crédits
4 crédits en 2K · 5 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 évaluer dans une API de ghost mannequin

  • Ce que vous envoyez

    Le vêtement photographié sur un mannequin, avec une vue arrière optionnelle. Photta accepte les formats JPEG, PNG et WebP jusqu'à 10 MB par image.

  • La finition obtenue

    L'endpoint de Photta prend un style : 3d conserve le volume tridimensionnel du vêtement, flat_lay l'aplatit en une disposition frontale nette.

  • Ce que cela coûte

    4 credits en 2K et 5 en 4K sur Photta — un credit de moins que le try-on à chaque niveau, remboursé automatiquement en cas d'échec du job.

  • Support du traitement par lot

    Le travail de catalogue arrive par séries, pas à l'unité. Photta propose un endpoint de batch qui accepte un tableau, réserve les credits à l'avance et renvoie l'état par article.

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/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Questions sur les API de ghost mannequin

Qu'est-ce qu'une photo ghost mannequin ?

Une photo de produit où le vêtement semble flotter, conservant sa forme sans corps ni cintre visible. Elle révèle simultanément la coupe et la structure intérieure, ce qui en fait le standard sur les fiches produits d'habillement.

Qu'est-ce que j'envoie à l'endpoint ?

Une photographie du vêtement sur un mannequin. Une vue arrière est optionnelle et améliore la reconstruction lorsque le vêtement est ouvert ou réversible.

Dois-je choisir 3d ou flat lay ?

3d lorsque vous voulez que le vêtement donne l'impression d'être porté — volume, épaules, manches. flat_lay lorsque la fiche requiert une forme frontale constante, ce qui est souvent le cas des marketplaces.

Combien coûte une image ?

Sur Photta, 4 credits en 2K et 5 en 4K. Dans un batch, le même tarif unitaire par image est réservé à l'avance pour l'ensemble du traitement.

Puis-je traiter un catalogue entier ?

Oui, via l'endpoint de batch. La taille du lot et le nombre de batches exécutables simultanément dépendent de votre forfait ; un catalogue volumineux s'exécute donc comme une séquence de batches.

Traiter un vêtement avec l’API

Une photo en entrée, un rendu mannequin invisible en sortie.

  • 1.5–4 min
  • 4 crédits en 2K · 5 crédits en 4K
  • asynchrone, polling