Abbigliamento · Funzionalità

Virtual Try-On API — Photta

Una sola chiamata REST trasforma una foto flat-lay di abbigliamento in un'immagine professionale su modella. Asincrona, 1.5–4 minuti per generazione, 5 crediti a 2K o 7 crediti a 4K.

In una frase

L'API virtual try-on di Photta accetta l'immagine di un capo flat-lay, un ID manichino e un ID posa, restituendo una foto 2K o 4K su modella. Autenticazione con Authorization: Bearer photta_live_xxx, POST su /api/v1/tryon/apparel, polling dello stesso endpoint con l'ID generazione ogni 3–5 secondi e download del risultato quando lo stato diventa completed.

Ottieni una API key→Leggi la documentazione

POST/api/v1/tryon/apparel

cURL

curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "dress",
    "product_images": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

Cosa aspettarsi

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Codice, end to end

Scegli il tuo linguaggio

Stesso endpoint, tre guide eseguibili. Ogni snippet corrisponde alla documentazione ufficiale di Photta.

SDK

→

Node.js

fetch nativo in Node 18+ · Pronto per le server actions di Next.js

SDK

→

Python

requests + wrapper di 30 righe · Django / FastAPI / Celery

SDK

→

cURL

Test da terminale di due minuti · pipeline jq · nessuna installazione

Come funziona

Quattro chiamate API, una sola foto prodotto

Scegli un manichino e una posa, invia il job, effettua il polling fino al termine, scarica il risultato.

01
Step 1
Genera una API key
Registrati su ai.photta.app, apri il tab Developers, clicca su Generate API key. Le chiavi live iniziano con photta_live_. Inserisci la chiave in PHOTTA_API_KEY — non caricarla mai nel codice.
02
Step 2
Scegli un manichino e una posa
GET /api/v1/mannequins e /api/v1/poses per l'elenco delle opzioni. Scegli gli ID adatti al tuo brand — taglia, espressione, etnia e categoria posa sono tutti filtrabili.
03
Step 3
Invia il job di try-on tramite POST
Invia una POST a /api/v1/tryon/apparel con product_type, product_images, mannequin_id, pose_id, resolution, aspect_ratio. L'API restituisce 202 Accepted con un ID di generazione.
04
Step 4
Esegui il polling fino al termine del job
GET /api/v1/tryon/apparel/:id ogni 3 secondi. Quando data.status diventa completed, il payload include output_url e thumbnail_url. Imposta un limite massimo di tentativi per evitare che un job bloccato blocchi la richiesta.
05
Step 5
Scarica e salva
Scarica i byte da output_url e salvali nel tuo storage. L'URL della CDN è stabile, ma il tuo prodotto non dovrebbe dipendere da esso per il rendering.

Domande frequenti degli sviluppatori

Domande frequenti prima di integrare il try-on abbigliamento

Cos'è l'API virtual try-on di Photta?+

Un endpoint REST che accetta l'immagine di un prodotto flat-lay e una coppia di ID (manichino + posa) e restituisce un'immagine fotorealistica su modella. Stessa pipeline dell'app consumer di Photta. Sono supportati sei tipi di prodotto: top, bottom, top+bottom, dress, one-piece, jumpsuit.

Quanto costa per chiamata?+

5 crediti per un risultato 2K, 7 crediti per il 4K. I crediti sono inclusi nell'abbonamento e possono essere ricaricati. Le generazioni fallite non costano crediti — vengono rimborsate.

Quanto dura la generazione?+

Il completamento avviene solitamente tra 1.5 e 4 minuti, misurati end-to-end. La POST restituisce un ID di generazione in meno di un secondo; l'elaborazione GPU avviene in background durante il polling.

Quali tipi di prodotto sono supportati?+

Sei: top, bottom, top_and_bottom, dress, one_piece, jumpsuit. Ognuno richiede una struttura product_images differente — per esempio top_and_bottom richiede gli URL sia di top_image che di bottom_image.

Posso usare il mio manichino?+

Sì. Carica la foto di un manichino su /api/v1/mannequins/upload o generane uno nuovo tramite AI con /api/v1/mannequins/generate-model. L'ID restituito si inserisce direttamente nella richiesta di try-on.

Come effettuo il polling per il risultato?+

GET /api/v1/tryon/apparel/:id ogni 3-5 secondi finché data.status è completed o failed. Imposta un limite massimo — 120 × 3s copre la finestra documentata con ampio margine.

Correlati