Mannequin fantôme · Fonctionnalité

API Mannequin fantôme — Photta

Retirez le mannequin d'une photo de vêtement en préservant la structure interne — coutures, doublures, étiquettes. Finition effet creux ou à plat, prêt pour le traitement par lots, 4 crédits à 2K.

En une phrase

L'API mannequin fantôme de Photta prend une photo de vêtement sur mannequin et renvoie une image avec mannequin invisible et reconstruction de l'intérieur. Effectuez un POST sur `/api/v1/ghost-mannequin` avec un `product_image_url`, un `style` (hollow_man ou flat_lay), et une résolution. Interrogez `/api/v1/ghost-mannequin/:id` toutes les 3 secondes jusqu'à `completed`.

Obtenir une clé API→Lire la documentation

POST/api/v1/ghost-mannequin

cURL

curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://example.com/tshirt-on-model.jpg",
    "style": "hollow_man",
    "resolution": "2K"
  }'

À quoi s'attendre

Typical completion

1–3min

2K / 4K credits

4 / 6

Styles

Batch-ready

yes

Code, de bout en bout

Choisissez votre langage

Même contrat REST ; l'endpoint mannequin fantôme supporte également le traitement par lots pour les catalogues volumineux.

SDK

→

Node.js

fetch natif · se combine parfaitement avec BullMQ ou Inngest pour les tâches par lots

SDK

→

Python

requests + asyncio pour les soumissions parallèles

SDK

→

cURL

Idéal pour tester les charges utiles par lots avant l'intégration finale

Comment ça marche

Une photo en entrée, une photo avec mannequin invisible en sortie

Téléchargez la source, choisissez un style, soumettez, interrogez, téléchargez.

01
Étape 1
Générer une clé API
Le mannequin fantôme utilise les mêmes identifiants que les autres fonctionnalités de Photta — une seule clé, un seul solde de crédits.
02
Étape 2
Télécharger la photo source
Vous pouvez passer une URL publique dans `product_image_url` ou télécharger les octets via `/api/v1/uploads`. L'endpoint accepte JPG, PNG et WebP.
03
Étape 3
Soumettre la tâche mannequin fantôme
POST sur `/api/v1/ghost-mannequin` avec `product_image_url`, `style` (hollow_man ou flat_lay), `resolution`. Passez un `webhook_url` si vous souhaitez une notification à la fin — le polling reste la méthode principale.
04
Étape 4
Interroger jusqu'à la fin de la tâche
GET sur `/api/v1/ghost-mannequin/:id` toutes les 3 secondes. Le mannequin fantôme est plus rapide que l'essayage — généralement 1 à 3 minutes — car aucune personne n'est générée.
05
Étape 5
Télécharger et stocker
La sortie est un PNG avec mannequin retiré et intérieur reconstitué. Idéal pour les fiches produits, les galeries 3D et les catalogues à plat.

Questions fréquentes des développeurs

Questions des développeurs avant de déployer le mannequin fantôme

Qu'est-ce que la photographie de mannequin fantôme ?+

Un traitement pour fiches produits où le vêtement semble flotter sur un corps invisible, montrant à la fois la forme et la construction intérieure. Historiquement, c'est un assemblage de plusieurs clichés studio ; l'API de Photta le produit en un seul appel à partir d'une photo sur mannequin.

Combien coûte le mannequin fantôme ?+

4 crédits en 2K, 6 crédits en 4K — soit un crédit de moins par palier que l'essayage. Les échecs sont remboursés automatiquement.

Quelle est la différence entre hollow-man et flat-lay ?+

Hollow-man conserve la forme 3D du mannequin — le vêtement garde son volume, les épaules et manches sont naturelles, et l'intérieur est reconstruit. Flat-lay aplatit le vêtement pour un rendu 2D propre, idéal pour les collections capsules ou les marketplaces exigeant une forme frontale constante.

Puis-je traiter plusieurs photos par lots ?+

Oui. POST sur `/api/v1/ghost-mannequin/batch` avec un tableau d'images sources. La réponse fournit un ID de lot ainsi que des IDs de génération par article. Interrogez `/api/v1/ghost-mannequin/batch/:id` pour un statut global ou chaque article individuellement.

Préserve-t-il les coutures intérieures et les étiquettes ?+

Oui — le modèle reconstruit l'intérieur du vêtement (encolure, revers, doublure) plutôt que d'halluciner une surface générique. Les étiquettes visibles sur la photo d'origine sont conservées dans la mesure du possible.

Comment interroger le résultat ?+

GET sur `/api/v1/ghost-mannequin/:id` toutes les 3 secondes. Les tâches par lots interrogent un endpoint parent qui renvoie un statut global et le détail par article.

Contenu lié