Guida · Ghost mannequin

Che cos'è un'API di ghost mannequin? lo scatto con manichino invisibile

In sintesi

Un'API di ghost mannequin riceve la fotografia di un capo su manichino e restituisce lo stesso capo privo del supporto e con l'interno ricostruito, dando l'impressione che il capo mantenga autonomamente la propria forma.

Ottieni una chiave API Leggi la documentazione

Tempo tipico: 1.5–4 min
Credits: 4 credits a 2K · 5 credits a 4K
Elaborazione: asincrono, polling

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

In breve

La fotografia ghost mannequin — chiamata anche hollow man o manichino invisibile — mostra un capo che mantiene la propria forma senza alcun corpo al suo interno. Tradizionalmente viene composta in post-produzione unendo diversi scatti da studio: il capo sul manichino, la rimozione del manichino e infine il compositing dell'interno del colletto e dei polsini.

Un'API ghost mannequin esegue tutto questo in una sola chiamata. Invii la fotografia su manichino, il servizio rimuove il supporto, ricostruisce ciò che dovrebbe essere visibile all'interno del capo — interno dello scollo, fodera dei polsini, girovita — e restituisce l'immagine finita. Come per il try-on, la chiamata è asincrona: invio, polling, download.

È il trattamento standard per le pagine di dettaglio prodotto nell'abbigliamento; di conseguenza, i client tipici sono i team di gestione catalogo e i marketplace che necessitano di un aspetto coerente su migliaia di articoli senza dover prenotare sessioni in studio per ogni capo.

L'endpoint dedicato

Estratto dalla documentazione dell'API Photta, non redatto manualmente.

Panoramica

Endpoint: POST /api/v1/ghost-mannequin
Autenticazione: API key Bearer
Elaborazione: Asincrona — effettua il polling dell'endpoint di stato
Tempo tipico: 1.5–4 min
Credits: 4 credits a 2K · 5 credits a 4K
Rapporti d'aspetto: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Limiti di input: Fino a 10 MB per immagine; JPEG, PNG, WebP
Idempotente: No

Cosa valutare in un'API di ghost mannequin

Cosa inviare
Il capo fotografato su un manichino, oltre a una vista posteriore opzionale. Photta accetta JPEG, PNG e WebP fino a 10 MB per immagine.
Quale finitura si ottiene
L'endpoint di Photta accetta uno stile: 3d mantiene il volume tridimensionale del capo, flat_lay lo appiattisce in un layout frontale pulito.
Quanto costa
4 credits a 2K e 5 a 4K su Photta — un credito in meno rispetto al try-on per ciascun livello, con rimborso automatico in caso di job fallito.
Supporto per l'elaborazione batch
Il lavoro sui cataloghi procede a stock, non per singoli pezzi. Photta dispone di un endpoint batch che accetta un array, riserva i credits in anticipo e restituisce lo stato per ciascun elemento.

La prima richiesta

La stessa chiamata in cURL, Node.js e 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')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "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"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Domande sulle API di ghost mannequin

Che cos'è una foto ghost mannequin?

Uno scatto di prodotto in cui il capo sembra fluttuare, mantenendo la propria forma senza alcun corpo o gruccia visibile. Mostra contemporaneamente la vestibilità e la struttura interna, motivo per cui rappresenta lo standard nelle pagine prodotto di abbigliamento.

Cosa devo inviare all'endpoint?

Una fotografia del capo su manichino. Una vista posteriore è opzionale e migliora la ricostruzione quando il capo è aperto o reversibile.

Dovrei scegliere 3d o flat lay?

3d quando vuoi che il capo risulti indossato — volume, spalle, maniche. flat_lay quando l'inserzione richiede una forma frontale uniforme, come spesso accade sui marketplace.

Quanto costa una singola immagine?

Su Photta, 4 credits a 2K e 5 a 4K. In un batch, lo stesso prezzo per immagine viene riservato in anticipo per l'intera esecuzione.

Posso elaborare un intero catalogo?

Sì, tramite l'endpoint batch. Sia la dimensione del batch sia il numero di batch eseguibili contemporaneamente dipendono dal tuo piano, quindi un catalogo di grandi dimensioni viene elaborato come una sequenza di batch.

Continua a leggere

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Elabora un singolo capo

Una fotografia in ingresso, uno scatto con manichino invisibile in uscita.

Crea un account e ottieni una chiave API Vedi l'endpoint

1.5–4 min
4 credits a 2K · 5 credits a 4K
asincrono, polling