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
- Iscriviti gratuitamente. Ogni account parte con 10 prove gratuite.
- Apri Dashboard > Chiavi API e crea una chiave. Inizia con
tk_dev_v1_e viene visualizzata una sola volta, quindi copiala subito. - Salvalo come variabile d'ambiente sul tuo server:
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.
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:
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.pngresult.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
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
- Esempi completi in Node.js, Next.js, Python e PHP
- Errori e quando riprovare
- Operazioni asincrone, batch e webhook per lavori lunghi e cataloghi
- Crea una chiave per ogni app o ambiente, con un limite mensile di crediti facoltativo, in API Keys
- Acquista crediti quando sei pronto per andare online