Search docs

Search the TryOnCloud API docs

Empezar

Guía de inicio rápido

Tu primera prueba en cinco minutos: consigue una clave, pruébalo gratis, génalo.

Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.

Tu primera prueba de ropa en cinco minutos.

1. Obtener una clave API

  1. Regístrate gratis. 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