API DE TRY-ON · REST · SDK EN TYPESCRIPT
La API de virtual try-on.
Una petición, cualquier producto.
Envía la foto de una persona y la imagen de un producto. Unos ocho segundos después recibirás una foto de esa persona llevando el producto. Es el mismo motor que impulsa Genlook en Shopify, WooCommerce y PrestaShop.
- de media, desde la petición al resultado
- 8,2 s
- el precio más bajo por try-on
- $0.015
- créditos gratis al registrarte
- 10
person
product
Texto del producto enviado con esta petición
"title": "Cocktail mini dress""description": "Party cocktail mini dress, fitted bodice, short hemline, evening occasion"
Usado por más de 900 tiendas de moda
01 · Cómo funciona
Tres peticiones desde la foto hasta el resultado.
No hay que sincronizar ningún catálogo de antemano. Los productos se crean en la propia llamada de try-on, y las generaciones se ejecutan en segundo plano. Usa el SDK en TypeScript o REST simple desde cualquier lenguaje.
Guía de inicio rápido →- 01Sube la foto de la personaPOST /images/uploadDevuelve un imageId. Reutilízalo para cada try-on con la misma foto.
- 02Crea el try-onPOST /try-onEnvía el producto (título, descripción e imagen) con el imageId. El producto se guarda bajo tu externalId, así que en las siguientes llamadas solo necesitas el ID.
- 03Obtén el resultadoGET /generations/:idConsulta hasta que el estado sea COMPLETED, llama a waitFor() en el SDK, o recibe un webhook configurado en el dashboard.
Mantén tu clave API en tu servidor. El SDK es solo para el lado del servidor, por lo que las peticiones del navegador deben pasar por tu backend.
import { Genlook } from "@genlook/api";
import { readFile } from "node:fs/promises";
const client = new Genlook({ apiKey: process.env.GENLOOK_API_KEY! });
// 1. Upload the customer photo once, reuse the imageId.
const { imageId } = await client.images.upload(
await readFile("./customer.jpg"),
{ mimeType: "image/jpeg" },
);
// 2. Create the try-on. The product is created inline.
const { generationId } = await client.tryOn.create({
products: [{
externalId: "hoodie-42",
title: "Oversized cotton hoodie",
description: "Relaxed fit, dropped shoulders, hip length.",
images: [{ source: { url: "https://cdn.example.com/hoodie.jpg" } }],
}],
person: { image: { source: { id: imageId } } },
});
// 3. Wait for the result (or use a webhook).
const result = await client.generations.waitFor(generationId);
console.log(result.resultImageUrl);GET /generations/:id200 · COMPLETED{
"generationId": "cm8gen456xyz",
"status": "COMPLETED",
"resultImageUrl": "https://storage.googleapis.com/...",
"createdAt": "2026-03-30T10:00:00.000Z",
"updatedAt": "2026-03-30T10:00:10.000Z"
}02 · Resultados
Resultados reales, cualquier tipo de producto.
Cada imagen a continuación es el resultado de una única petición de try-on. Pasa el ratón por encima para ver la foto enviada. La imagen del producto está en la esquina.
Más ejemplos por categoría →























03 · Detalles de la API
Lo que debes saber antes de integrar.
El dashboard muestra logs, uso y gasto por cada clave API.
Referencia de errores →- Velocidad
- 8,2 s de media
- El primer try-on de un producto nuevo tarda unos segundos más, ya que se analiza una vez y luego se reutiliza.
- Webhooks
- generation.completed
- Configura una URL de webhook en el dashboard para recibir los eventos generation.completed y generation.failed en lugar de hacer consultas.
- Imágenes
- JPEG, PNG, WebP, HEIC
- Hasta 10 MB por imagen. Envía un archivo, una URL o un imageId subido anteriormente.
- Productos
- Sin sincronización de catálogo
- Los productos se crean de forma integrada en la misma llamada de try-on y se guardan durante 15 días tras su último uso.
- Conjuntos
- Hasta 4 productos
- Combina hasta 4 prendas en un solo try-on, como un top, un pantalón y una chaqueta. Solo cambian esas prendas. 1 crédito por producto.
- Errores
- 402 INSUFFICIENT_CREDITS
- Cada error devuelve un código, un mensaje y un estado. Las generaciones fallidas se reembolsan.
- Datos de usuario
- DELETE /customers/:id
- Borra cualquier imagen vinculada a tus usuarios. Configura keepForDays en 1, 3 o 7 días por subida.
- Resultados
- Marca de agua y etiqueta de IA
- Añade tu logo a los resultados. La etiqueta de la Ley de IA de la UE viene activada por defecto y puede desactivarse por petición.
- Motor
- Siempre actualizado
- Las mejoras del motor llegan a tu integración automáticamente. No hay que adoptar nuevas versiones ni cambiar el código.
- Hosting
- Nada que ejecutar
- Olvídate de GPUs, pesos de modelos o colas. Preparado para tráfico de producción, incluidos los picos del día de lanzamiento.
- Pruebas
- Producto con título "mock"
- Devuelve la foto de la persona sin cambios y de forma rápida, para que puedas probar tu flujo de integración.
04 · SDK y herramientas
Librerías y ejemplos para empezar.
05 · Precios
Un crédito por try-on. Elige el plan que mejor se adapte a tu volumen.
Todas las opciones usan la misma API y el mismo motor. Los planes mensuales reducen el precio por try-on, los try-ons incluidos se reinician cada mes y puedes cancelar en cualquier momento. Las generaciones fallidas se reembolsan.
Por encima del plan Scale, los planes personalizados empiezan en 1.000 $ al mes para volúmenes comprometidos o capacidad dedicada. Para estos planes o el programa para startups, escribe a thibault@genlook.app.
- Pago por uso0,04 $ por try-on, en paquetes de créditos desde 5 $. Los créditos de los paquetes no caducan nunca.80,00 US$/ mes0,04 US$ por try-on
- StarterMenor coste20 $ al mes con 1.000 try-ons incluidos, después 0,02 $ cada uno.40,00 US$/ mes0,02 US$ por try-on
- Growth99 $ al mes con 6.000 try-ons incluidos, después 0,018 $ cada uno.99,00 US$/ mes0,0495 US$ por try-on
- Scale300 $ al mes con 20.000 try-ons incluidos, después 0,015 $ cada uno.300 US$/ mes0,15 US$ por try-on
Estimación sin impuestos. Los try-ons adicionales en los planes mensuales se facturan en bloques a la tarifa del plan. Las cuentas nuevas reciben 10 créditos gratis.
06 · Comparativas
FAQ
Preguntas sobre la API.
La referencia completa está en la documentación en genlook.app/docs.
¿Cómo obtengo una clave API?
¿Puedo llamar a la API desde el navegador?
Tengo una tienda Shopify, WooCommerce o PrestaShop. ¿Necesito la API?
¿Tenéis un programa para startups?
Segunda opinión
Pregunta a un asistente de IA sobre la API.
Cada enlace abre el asistente con la pregunta de abajo ya rellenada.
“¿Qué tan fácil es integrar la API de Virtual Try-On de genlook.app en una app a medida?”
Empieza con 10 créditos gratis.
Crea una cuenta, obtén una clave API y ejecuta tu primer try-on en pocos minutos.











