Guía · Virtual try-on

¿Qué es una API de virtual try-on? y qué devuelve

En una frase

Una API de virtual try-on recibe la fotografía de una prenda y devuelve una imagen de esa prenda vestida por un modelo. Envías la foto mediante un POST con un maniquí y una pose, haces polling del job y descargas el resultado.

Obtener una API keyLeer la documentación
  • Tiempo típico: 1.5–4 min
  • Credits: 5 credits a 2K · 6 credits a 4K
  • Procesamiento: asíncrono, polling

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado

Resumen rápido

Una API de virtual try-on es un endpoint HTTP que renderiza una prenda sobre una modelo. Envías una fotografía del producto —normalmente la toma en plano cenital o sobre maniquí que ya tienes— y el servicio devuelve una imagen de esa prenda siendo llevada puesta. Sin estudio, sin contratar modelos, sin repetir sesiones cuando cambia la gama de colores.

La llamada es asíncrona porque el renderizado tarda más de lo que una petición debería esperar. Haces un POST de la prenda con el modelo y la pose que deseas, la API acepta el trabajo y devuelve un id, y haces polling a un status endpoint hasta que el trabajo informe de que está completado. La imagen finalizada llega como una URL que descargas y almacenas por tu cuenta.

Los clientes habituales son equipos de catálogo que necesitan imágenes con modelo para productos que nunca llegan a un estudio, marketplaces que reciben fotos planas de los vendedores y aplicaciones que permiten a un comprador ver una prenda en un cuerpo distinto al del único modelo de prueba de la marca.

El endpoint que lo hace

Extraído de la documentación de la API de Photta, no redactado a mano.

De un vistazo

Endpoint
POST /api/v1/tryon/apparel
Autenticación
Bearer API key
Procesamiento
Asíncrono — realiza polling al endpoint de estado
Tiempo típico
1.5–4 min
Credits
5 credits a 2K · 6 credits a 4K
Relaciones de aspecto
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Límites de entrada
Hasta 10 MB por imagen; JPEG, PNG, WebP
Idempotente
No

Qué buscar en cualquier API de try-on

  • Qué envías

    Una fotografía de la prenda como una URL https o una data URI en base64, más el modelo y la pose que deseas. Photta acepta JPEG, PNG y WebP de hasta 10 MB por imagen.

  • Cuánto tarda

    Lo suficiente como para que no pueda realizarse dentro de una petición web. Photta publica un tiempo típico de finalización por endpoint y espera un polling cada 3 segundos —no hay webhooks.

  • Cuánto cuesta

    Photta cobra credits por llamada, 5 en 2K y 6 en 4K para apparel try-on, deducidos cuando el trabajo comienza y reembolsados automáticamente si falla.

  • Qué límites se aplican

    Un rate limit publicado de 600 peticiones por minuto por clave, y un límite por plan sobre cuánto se puede renderizar a la vez. Vale la pena leer ambos antes de una ejecución del tamaño de un catálogo.

La primera request

La misma llamada en cURL, Node.js y Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Preguntas sobre las API de virtual try-on

¿Qué devuelve una API de try-on?

Una imagen de la prenda vestida por el modelo que elegiste, entregada como una URL en el trabajo completado. Descárgala y almacénala —una URL de entrega no es un alojamiento permanente.

¿Necesito la foto de un modelo?

No. Photta incluye un catálogo de maniquíes entre los que puedes elegir, y puedes generar tu propio modelo a partir de atributos o subir uno. La fotografía de la prenda es la única imagen que debes proporcionar.

¿En qué se diferencia esto de un probador virtual?

Un probador es una funcionalidad orientada al comprador. Una API de try-on es el paso de renderizado que hay debajo: entra una llamada, sale una imagen. Puedes construir un probador encima, o utilizarla puramente para producir fotografías de catálogo.

¿Cuánto cuesta una llamada de try-on?

Con Photta, 5 credits en 2K y 6 en 4K. Los trabajos fallidos se reembolsan, por lo que el coste de un reintento es el reintento en sí.

¿Cuánto tarda una imagen?

El endpoint publica su tiempo típico de finalización, y el trabajo informa de su propio estado. Haz polling cada 3 segundos en lugar de asumir una duración.

Lectura recomendada

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado

Pruébalo con la foto de tu propio producto

Una petición, un polling, una imagen.

Crear una cuenta y obtener una API keyVer el endpoint
  • 1.5–4 min
  • 5 credits a 2K · 6 credits a 4K
  • asíncrono, polling