# Guida rapida

La tua prima prova tra cinque minuti.

## 1. Ottenere una chiave API

1. [Iscriviti gratuitamente](/signup). 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: 1`ne 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

- [Esempi completi](/docs/examples) in Node.js, Next.js, Python e PHP
- [Errori](/docs/errors) e quando riprovare
- [Operazioni asincrone, batch e webhook](/docs/async) 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](/pricing#developer-api) quando sei pronto per andare online
