FASHN
FASHN Tryon v1.6
fashn-tryon-v1.6
Modello di prova virtuale: basta inserire un'immagine della persona e un'immagine del capo per generare l'effetto indossato dalla modella, con output nativo 864x1296, supporto per l'input di immagini flat lay e tre modalità di qualità
Prova fashn-tryon-v1.6
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
fashn-tryon-v1.6 per image
| Prezzo unitario | $0.1072 |
|---|
Panoramica e posizionamento
fashn-tryon-v1.6 è un modello di immagini per il virtual try-on pensato per l'e-commerce di abbigliamento e la produzione di contenuti visivi: riceve in input una foto di una persona e un'immagine di un capo d'abbigliamento e restituisce un'immagine composita in cui la modella o il modello indossa quel capo. Rispetto alla generazione precedente, la risoluzione nativa dell'output sale a 864x1296, con una resa più nitida dei dettagli come texture dei tessuti, motivi e scritte, e un'illuminazione più naturale. È adatto a sviluppatori e team e-commerce che devono produrre in batch immagini di capi indossati per pagine di dettaglio prodotto, materiali di marketing o fasi di validazione del design.
Punti di forza principali
- Output nativo a risoluzione 864x1296——circa il 50% in più rispetto alla generazione precedente: texture dei tessuti, motivi e dettagli delle scritte risultano più nitidi e utilizzabili alle dimensioni delle pagine di dettaglio.
- Compatibilità con due tipi di materiale del capo: foto su modello e foto flat-lay——tramite garment_photo_type si specifica model, flat-lay oppure auto per il riconoscimento automatico, adattandosi a diverse condizioni di scatto.
- Tre modalità di qualità selezionabili in base alle esigenze——performance, balanced e quality consentono di passare tra velocità di generazione e precisione di rendering, utile per chiamate differenziate in ambienti di produzione.
- Risultati riproducibili con seed fisso——passando lo stesso seed e gli stessi input si ottiene un output identico, il che facilita la riproduzione dei risultati e la diagnosi nella produzione in batch.
Descrizione delle capacità
Sintesi del try-on tra persona e capo: basta inviare due URL, quello della foto della persona e quello dell'immagine del capo, per ottenere un'immagine del capo indossato; l'output è in png o jpeg e può entrare direttamente nei flussi di immagini prodotto o materiali.
Adattamento alla categoria del capo e alla forma di scatto: category supporta tops, bottoms, one-pieces e auto per il riconoscimento automatico, mentre garment_photo_type distingue le foto indossate da quelle flat-lay, riducendo il lavoro di pre-elaborazione.
Controllo della qualità dell'output: con mode si sceglie la priorità alla velocità o alla precisione, moderation_level permette di bloccare contenuti espliciti secondo le esigenze aziendali, e il livello conservative blocca anche capi intimi e costumi da bagno.
Generazione in batch riproducibile: con un seed fisso gli stessi input riproducono lo stesso risultato, facilitando l'individuazione dei problemi e la riesecuzione dei campioni falliti nella pipeline di produzione.
Casi d'uso
- Produzione in batch di immagini di capi indossati per team e-commerce——generare in batch immagini di capi indossati a partire da foto flat-lay e foto di modelle o modelli, da usare come immagini principali e per la presentazione degli stili nelle pagine di dettaglio del negozio.
- Validazione visiva nella fase di campionatura del design di abbigliamento——generare rapidamente immagini combinando bozzetti di design o foto di campioni con foto di modelle e modelli, per verificare la resa di vestibilità e motivi prima di investire in servizi fotografici reali.
- Generazione rapida di materiali di marketing per più stili——generare immagini separate per la stessa modella o lo stesso modello con più stili, per creare materiali a più varianti destinati a pagine promozionali, pubblicazioni sui social e altro.
- Conversione di immagini prodotto flat-lay in presentazioni indossate——trasformare materiali già disponibili scattati in flat-lay o su appendiabiti invisibile in immagini del capo indossato, valorizzando l'archivio esistente di immagini prodotto.
Limiti e consigli per la scelta
Il modello è pensato per scenari di presentazione di capi a figura intera con risoluzione fissa e le dimensioni dell'output non sono regolabili liberamente. In modalità quality la precisione di rendering è maggiore ma i tempi sono più lunghi: per le attività in batch occorre distribuire i livelli tra velocità ed efficacia; generare più risultati per singola richiesta è una pratica comune per aumentare il tasso di utilizzo, ma comporta un costo proporzionale. Il livello di moderazione conservative blocca capi intimi e costumi da bagno: in questi casi va scelto un livello più permissivo. Se l'azienda privilegia la stabilità produttiva su esecuzioni prolungate rispetto alla precisione, occorre valutare se adottare una versione precedente più matura.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello fashn-tryon-v1.6 per il virtual try-on
Domande frequenti
Vedi tutte le domande →-
Che cos'è FASHN Try-On v1.6?
È un modello dedicato al virtual try-on. Carichi una foto di una persona e un'immagine di un capo d'abbigliamento: il modello indossa il capo sulla persona e restituisce un'immagine verticale del try-on; non richiede prompt e non accetta descrizioni testuali. L'output è adatto per essere inserito direttamente in una pagina di dettaglio prodotto, in materiali per i social media o in un'anteprima pubblicitaria.
-
È necessario scrivere un prompt?
No. Riceve solo la foto della persona e l'immagine del capo; l'effetto del prova-abiti è determinato dalle due immagini e dai parametri opzionali categoria, modalità e tipo di immagine del capo. Non includere un campo prompt aggiuntivo nella richiesta: il backend lo rifiuterà come campo sconosciuto.
-
È necessario caricare due immagini contemporaneamente?
Sì. La foto della persona e l'immagine del capo di abbigliamento sono entrambe obbligatorie; se ne manca una, sia il Playground che l'API bloccheranno l'invio. Il pulsante di esecuzione si abilita solo dopo aver caricato entrambe le immagini; l'API restituirà un errore di convalida dei parametri.
-
Quali categorie di abbigliamento sono supportate?
Sono supportati top (tops), pantaloni e gonne (bottoms) e capi interi (one-pieces); è anche possibile scegliere il riconoscimento automatico. Se la categoria non è certa, usa prima l'automatico; se il riconoscimento non è accurato, specifica esplicitamente la categoria. Per cataloghi con categorie miste, si consiglia di inviare i dati raggruppati per categoria, per ridurre le distorsioni dovute al riconoscimento automatico.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: fashn-tryon-v1.6
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per fashn-tryon-v1.6 e la route default — vedi la tabella dei parametri sotto.
modestringOpzionalePredefinito: "balanced"Modalità che regola il compromesso tra qualità e velocità di generazione, valore di enumerazione stringa, predefinito balanced; performance è più veloce, la modalità qualità è più lenta ma con dettagli più ricchi.
performancebalancedqualityseedintegerOpzionaleSeme casuale, valore intero; lo stesso seme con lo stesso input consente di riprodurre i risultati.
categorystringOpzionalePredefinito: "auto"Categoria di abbigliamento, valore stringa, predefinito auto, ovvero rilevamento automatico della categoria dall'immagine del capo.
topsbottomsone-piecesautomodel_imagestringObbligatoriominLength 1pattern ^https?://Foto di una persona che indossa il capo, valore URL http(s).
garment_imagestringObbligatoriominLength 1pattern ^https?://Immagine di prodotto del capo da provare, valore URL http(s).
output_formatstringOpzionalePredefinito: "png"Formato dell'immagine di output, valore stringa, predefinito png; png offre la qualità più alta, jpeg è più veloce.
pngjpegmoderation_levelstringOpzionalePredefinito: "permissive"Livello di moderazione dei contenuti, valore stringa, predefinito permissive; permissive blocca i contenuti espliciti, conservative blocca anche i contenuti di biancheria intima e costumi da bagno.
nonepermissiveconservativesegmentation_freebooleanOpzionalePredefinito: trueInterruttore booleano, predefinito true; se attivato disabilita il parsing del corpo umano (human parsing) sull'immagine della persona.
garment_photo_typestringOpzionalePredefinito: "auto"Tipo di immagine del capo, valore stringa, predefinito auto; model indica una foto con modello che indossa il capo, flat-lay indica un'immagine distesa o su manichino invisibile, auto indica rilevamento automatico.
automodelflat-laycallbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "fashn-tryon-v1.6",
"input": {
"mode": "balanced",
"category": "auto",
"model_image": "…",
"garment_image": "…",
"output_format": "png",
"moderation_level": "permissive",
"segmentation_free": true,
"garment_photo_type": "auto"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "fashn-tryon-v1.6",
input: {
"mode": "balanced",
"category": "auto",
"model_image": "…",
"garment_image": "…",
"output_format": "png",
"moderation_level": "permissive",
"segmentation_free": true,
"garment_photo_type": "auto"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "fashn-tryon-v1.6",
"input": {
"mode": "balanced",
"category": "auto",
"model_image": "…",
"garment_image": "…",
"output_format": "png",
"moderation_level": "permissive",
"segmentation_free": True,
"garment_photo_type": "auto"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
FIBO 1.5 Bria $0.058 /immagine -
Grok Imagine Quality xAI $0.070 /immagine -
GPT Image 2 OpenAI $0.007 /immagine -
BRIA Product Shot Bria $0.058 /immagine -
Nano Banana 2 Google $0.036 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
Ideogram V3 Character Ideogram $0.090 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Nano Banana Pro Google $0.057 /immagine -
Krea 3 Krea $0.036 /immagine











