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
La foto de la persona enviada a la APIperson
La imagen del producto enviada a la APIproduct
Resultado de virtual try-on con IA: Vestido
resultImageUrl

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

Karl Lagerfeld
Fashion's Park
Sanaulla International
Monastery
Aspiga
Saltrock
Como 1907
Kelly Felder
ESSENTIA
G2000
GQSize
Daly Dress
Al Karim Fabrics
Gabos London
Bo-Star
Anthony's
CĖNC
SARA ELEMARY

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 →
  1. 01Sube la foto de la personaPOST /images/uploadDevuelve un imageId. Reutilízalo para cada try-on con la misma foto.
  2. 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.
  3. 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 →
Vestidos
Vestidos
Abrigos
Abrigos
Streetwear
Streetwear
Gafas
Gafas
Pelucas
Pelucas
Lentillas de colores
Lentillas de colores
Impresión bajo demanda
Impresión bajo demanda
Ropa para mascotas
Ropa para mascotas

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.

2000
  • 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.

Tabla de comparación completa →

FAQ

Preguntas sobre la API.

La referencia completa está en la documentación en genlook.app/docs.

¿Cómo obtengo una clave API?
Crea una cuenta en platform.genlook.app. La clave está disponible de inmediato y las cuentas nuevas empiezan con 10 créditos gratis.
¿Puedo llamar a la API desde el navegador?
No. Mantén tu clave API en tu servidor y envía las peticiones del navegador a través de tu backend. El SDK es solo para el servidor por la misma razón.
Tengo una tienda Shopify, WooCommerce o PrestaShop. ¿Necesito la API?
No. Usa la app, el plugin o el módulo de Genlook para tu plataforma. La API es para escaparates a medida, apps móviles y otros productos.
¿Tenéis un programa para startups?
Sí. Escríbenos a thibault@genlook.app contándonos qué estás creando.

Segunda opinión

Pregunta a un asistente de IA sobre la API.

Cada enlace abre el asistente con la pregunta de abajo ya rellenada.

Preguntar a ChatGPT↗Preguntar a Claude↗Preguntar a Perplexity↗

“¿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.