Ghost Mannequin · Funzionalità
API Ghost Mannequin — Photta
Rimuovi il manichino dalla foto di un capo e mantieni la struttura interna — cuciture, fodere, etichette — completamente intatta. Finitura hollow-man o flat-lay, pronto per il batch, 4 crediti a 2K.
In una frase
L'API ghost mannequin di Photta accetta la foto di un capo su manichino e restituisce un'immagine con manichino invisibile e interno ricostruito. POST su /api/v1/ghost-mannequin con product_image_url, uno style (hollow_man o flat_lay) e una risoluzione. Polling di /api/v1/ghost-mannequin/:id ogni 3 secondi fino a quando lo stato diventa completed.
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"
}'Cosa aspettarsi
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
Codice, end to end
Scegli il tuo linguaggio
Stesso contratto REST; l'endpoint ghost mannequin supporta anche l'elaborazione batch per cataloghi voluminosi.
Come funziona
Una foto in ingresso, un'immagine con manichino invisibile in uscita
Carica la sorgente, scegli uno stile, invia, polling, scarica.
- 01
Step 1
Genera una API key
Il ghost mannequin usa le stesse credenziali di ogni altra funzionalità Photta — una chiave, un saldo crediti.
- 02
Step 2
Carica la foto sorgente
Puoi passare un URL pubblico in product_image_url o caricare i byte tramite /api/v1/uploads. L'endpoint accetta JPG, PNG e WebP.
- 03
Step 3
Invia il job ghost mannequin tramite POST
Invia una POST a /api/v1/ghost-mannequin con product_image_url, style (hollow_man o flat_lay), resolution. Passa webhook_url se desideri una notifica al termine del job — il polling rimane comunque il metodo primario.
- 04
Step 4
Esegui il polling fino al termine del job
GET /api/v1/ghost-mannequin/:id ogni 3 secondi. Il ghost mannequin è più veloce del try-on — solitamente tra 1 e 3 minuti — perché non viene renderizzata nessuna nuova persona.
- 05
Step 5
Scarica e salva
L'output è un PNG con il manichino rimosso e l'interno del capo ricostruito. Ideale per schede prodotto ghost, gallerie 3D e inserti flat-lay.
Domande frequenti degli sviluppatori
Domande frequenti prima di integrare il ghost mannequin
Cos'è la fotografia ghost mannequin?+
Un trattamento per schede prodotto dove il capo sembra galleggiare su un corpo invisibile, mostrando volume e struttura interna simultaneamente. Storicamente si ottiene unendo più scatti studio; l'API di Photta lo produce con una singola chiamata da una sola foto su manichino.
Quanto costa il ghost mannequin?+
4 crediti a 2K, 6 crediti a 4K — un credito in meno per ogni tier rispetto al try-on. I job falliti vengono rimborsati automaticamente.
Qual è la differenza tra lo stile hollow-man e flat-lay?+
Hollow-man mantiene la forma 3D del manichino — il capo conserva volume, spalle e maniche sono naturali e l'interno è ricostruito. Flat-lay comprime il capo in un layout 2D pulito, ideale per collezioni capsule o marketplace che richiedono una forma frontale consistente.
Posso processare più foto in batch?+
Sì. Invia una POST a /api/v1/ghost-mannequin/batch con un array di immagini sorgente. La risposta fornisce un batch ID oltre agli ID di generazione per ogni elemento. Polling di /api/v1/ghost-mannequin/batch/:id per uno stato aggregato o per ogni singolo elemento.
Preserva le cuciture interne e le etichette?+
Sì — il modello ricostruisce l'interno del capo (interno scollatura, interno polsini, fodera vita) invece di allucinare una superficie generica. Le etichette visibili nella foto originale vengono mantenute quando possibile.
Come effettuo il polling per il risultato?+
GET /api/v1/ghost-mannequin/:id ogni 3 secondi. I job batch interrogano un endpoint padre che restituisce lo stato aggregato e il dettaglio per elemento.
Ghost Mannequin · Funzionalità
Crea un account e ottieni una API key
L'API ghost mannequin di Photta accetta la foto di un capo su manichino e restituisce un'immagine con manichino invisibile e interno ricostruito. POST su /api/v1/ghost-mannequin con product_image_url, uno style (hollow_man o flat_lay) e una risoluzione. Polling di /api/v1/ghost-mannequin/:id ogni 3 secondi fino a quando lo stato diventa completed.