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
- Regístrate gratis. Cada cuenta empieza con 10 pruebas gratuitas.
- 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. - Guárdalo como variable de entorno en tu servidor:
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.
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:
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 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
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 en Node.js, Next.js, Python y PHP
- Errores y cuándo volver a intentarlo
- Tareas asíncronas, lotes y webhooks 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 cuando estés listo para poner en marcha el servicio