Search docs

Search the TryOnCloud API docs

Inizia

Guida rapida

La tua prima prova in cinque minuti: ottieni una chiave, prova gratuitamente, genera.

Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.

La tua prima prova tra cinque minuti.

1. Ottenere una chiave API

  1. Iscriviti gratuitamente. Ogni account parte con 10 prove gratuite.
  2. Apri Dashboard > Chiavi API e crea una chiave. Inizia con tk_dev_v1_ e viene visualizzata una sola volta, quindi copiala subito.
  3. Salvalo come variabile d'ambiente sul tuo server:
bash
export TRYONCLOUD_API_KEY="tk_dev_v1_your_key_here"

2. Provalo gratuitamente con la modalità simulata

Aggiungi ?mock=true. La richiesta viene autenticata ed entrambe le immagini vengono convalidate esattamente come in una chiamata reale, ma non viene generato nulla e non viene addebitato alcun costo. L'immagine della persona viene restituita senza modifiche.

bash
curl -X POST "https://www.tryoncloud.com/api/v1/generate?mock=true" \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY" \
  -F "garment_image=@shirt.jpg" \
  -F "person_image=@person.jpg" \
  -o mock.png -D -

Cerca X-Mock: 1ne nelle intestazioni della risposta. Utilizza la modalità mock durante la compilazione.

3. Generare una prova virtuale

Rimuovere ?mock=true:

bash
curl -X POST "https://www.tryoncloud.com/api/v1/generate" \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY" \
  -F "garment_image=@shirt.jpg" \
  -F "person_image=@person.jpg" \
  -o result.png

result.png mostra il cliente che indossa il capo. Un risultato tipico richiede circa 20 secondi, quindi imposta un timeout di almeno 120 secondi per il tuo client HTTP.

4. Controlla cosa ti è rimasto

bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Le foto migliori per ottenere i risultati migliori

  • Persona: una sola persona, a figura intera, di fronte alla fotocamera, ben illuminata, se possibile su uno sfondo semplice.
  • Capo di abbigliamento: una foto chiara del prodotto vista di fronte, indossata da un modello o disposta in piano su uno sfondo a tinta unita.
  • I capi drappeggiati (sari, dhoti) rendono al meglio quando la foto del prodotto mostra il capo drappeggiato su una modella.

Prossimi passi