Guida · Virtual try-on

Cos'è un'API di virtual try-on? e cosa restituisce

In sintesi

Un'API di virtual try-on riceve la foto di un capo d'abbigliamento e restituisce l'immagine di quel capo indossato da una modella o un modello. Invii una richiesta POST con la foto, un manichino e una posa, esegui il polling del job e infine scarichi il risultato.

Ottieni una chiave APILeggi la documentazione
  • Tempo tipico: 1.5–4 min
  • Credits: 5 credits a 2K · 6 credits a 4K
  • Elaborazione: asincrono, polling

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

In breve

Un'API di virtual try-on è un endpoint HTTP che renderizza un capo su un modello. Invii la fotografia del prodotto — di solito lo scatto flat lay o su manichino che hai già — e il servizio restituisce l'immagine di quel capo indossato. Nessuno studio, nessun ingaggio di modelli, nessun reshoot se cambia la variante colore.

La chiamata è asincrona perché il rendering richiede più tempo di quanto una richiesta debba attendere. Invii una POST con il capo insieme al modello e alla posa desiderati, l'API accetta il job e restituisce un id, quindi effettui il polling su un endpoint di stato finché il job non risulta completato. L'immagine finale viene fornita sotto forma di URL che scarichi e archivi autonomamente.

I chiamanti abituali sono i team di gestione catalogo che necessitano di immagini su modello per prodotti che non arrivano mai in studio, i marketplace che ricevono fotografie flat dai venditori e le app che consentono all'acquirente di visualizzare un capo su un corpo diverso dall'unico modello di riferimento del brand.

L'endpoint preposto

Estratto dalla documentazione delle API di Photta, non scritto a mano.

Panoramica

Endpoint
POST /api/v1/tryon/apparel
Autenticazione
API key Bearer
Elaborazione
Asincrona — effettua il polling dell'endpoint di stato
Tempo tipico
1.5–4 min
Credits
5 credits a 2K · 6 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 try-on

  • Cosa inviare

    La fotografia di un capo tramite URL https o data URI base64, insieme al modello e alla posa scelti. Photta accetta JPEG, PNG e WebP fino a 10 MB per immagine.

  • I tempi di esecuzione

    Il tempo necessario non consente la gestione all'interno di una singola richiesta web sincrona. Photta indica un tempo medio di completamento per ciascun endpoint e prevede un polling ogni 3 secondi — non sono disponibili webhook.

  • I costi

    Photta addebita credits per ogni chiamata, 5 a 2K e 6 a 4K per il try-on di abbigliamento, scalati all'avvio del job e rimborsati automaticamente in caso di errore.

  • I limiti previsti

    Un rate limit dichiarato di 600 richieste al minuto per chiave e un limite sul numero di rendering simultanei definito dal piano. È consigliabile verificarli entrambi prima di avviare elaborazioni sull'intero catalogo.

La prima richiesta

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

Domande sulle API di virtual try-on

Cosa restituisce un'API di try-on?

Un'immagine del capo indossato dal modello selezionato, fornita come URL nel job completato. È necessario scaricarla e archiviarla — l'URL di consegna non funge da hosting permanente.

Serve la foto di un modello?

No. Photta include un catalogo di manichini tra cui scegliere; puoi inoltre generare il tuo modello a partire da attributi specifici o caricarne uno personalizzato. La fotografia del capo è l'unica immagine obbligatoria da fornire.

In cosa differisce da un camerino virtuale?

Il camerino virtuale è una funzionalità rivolta all'utente finale. Un'API di try-on è il passaggio di rendering sottostante: una chiamata in ingresso, un'immagine in uscita. Puoi sviluppare un camerino virtuale su questa base o utilizzarla esclusivamente per produrre scatti da catalogo.

Quanto costa una chiamata di try-on?

Con Photta, 5 credits a 2K e 6 a 4K. I job non riusciti vengono rimborsati, quindi il costo di un retry coincide semplicemente con quello della chiamata stessa.

Quanto tempo richiede una singola immagine?

L'endpoint indica il tempo medio di completamento e il job ne segnala lo stato. Effettua il polling ogni 3 secondi invece di assumere una durata a priori.

Continua a leggere

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

Provalo sulla foto del tuo prodotto

Una richiesta, un poll, un'immagine.

Crea un account e ottieni una chiave APIVedi l'endpoint
  • 1.5–4 min
  • 5 credits a 2K · 6 credits a 4K
  • asincrono, polling