# Guía de inicio rápido

Tu primera prueba de ropa en cinco minutos.

## 1. Obtener una clave API

1. [Regístrate gratis](/signup). Cada cuenta empieza con 10 pruebas gratuitas.
2. Abre **Panel de control > Claves API** y crea una clave. Empieza por `tk_dev_v1_` y solo se muestra **una vez**, así que cópiala ahora.
3. Guárdalo como variable de entorno en tu servidor:

```bash
export TRYONCLOUD_API_KEY="tk_dev_v1_your_key_here"
```

## 2. Prueba gratis con el modo de simulación

Añade `?mock=true`. La solicitud se autentifica y ambas imágenes se validan exactamente igual que en una llamada real, pero no se genera nada ni se cobra nada. La imagen de la persona se devuelve sin cambios.

```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 -
```

Busca `X-Mock: 1` en los encabezados de la respuesta. Utiliza el modo simulado mientras compilas.

## 3. Generar una prueba de vestimenta realista

Elimina `?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` muestra al cliente con la prenda puesta. Un resultado típico tarda unos 20 segundos, así que configura tu cliente HTTP con un tiempo de espera de al menos 120 segundos.

## 4. Comprueba lo que te queda

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

## Las mejores fotos para obtener los mejores resultados

- **Persona:** una persona, de cuerpo entero, mirando a la cámara, con buena iluminación y, a ser posible, con un fondo liso.
- **Prenda de ropa:** una foto nítida del producto vista de frente, con un modelo o colocada en plano sobre un fondo liso.
- **Las prendas drapeadas** (saris, dhotis) quedan mejor cuando la foto del producto muestra la prenda colocada sobre una modelo.

## Próximos pasos

- [Ejemplos completos](/docs/examples) en Node.js, Next.js, Python y PHP
- [Errores](/docs/errors) y cuándo volver a intentarlo
- [Tareas asíncronas, lotes y webhooks](/docs/async) para trabajos largos y catálogos
- Crea una clave por aplicación o entorno, con un límite mensual de créditos opcional, en **API Keys**
- [Compra créditos](/pricing#developer-api) cuando estés listo para poner en marcha el servicio
