Ropa · Capacidad
API de Try-On Virtual — Photta
Una llamada REST convierte una foto de ropa en plano en una imagen con modelo lista para campaña. Asíncrono, 1.5–4 minutos por generación, 5 créditos en 2K o 7 créditos en 4K.
En una frase
La API de try-on virtual de Photta acepta una imagen de ropa en plano, un mannequin ID y un pose ID, luego devuelve una foto con modelo en 2K o 4K. Te autenticas con `Authorization: Bearer photta_live_xxx`, haces un POST a `/api/v1/tryon/apparel`, sondeas el mismo endpoint con el ID de generación devuelto cada 3–5 segundos y descargas el resultado cuando el status cambie a `completed`.
curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'Qué esperar
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
Código, de punta a punta
Elige tu lenguaje
Mismo endpoint, tres guías ejecutables. Cada fragmento coincide con la documentación oficial de Photta.
Cómo funciona
Cuatro llamadas a la API, una foto de producto
Elige un maniquí y una pose, envía el trabajo, sondea hasta que termine, descarga el resultado.
- 01
Paso 1
Genera una API key
Regístrate en ai.photta.app, abre la pestaña de Desarrolladores y haz clic en Generar API key. Las claves activas comienzan con `photta_live_`. Guarda la clave en `PHOTTA_API_KEY` — nunca la subas al repositorio.
- 02
Paso 2
Elige un maniquí y una pose
Usa GET en `/api/v1/mannequins` y `/api/v1/poses` para listar las opciones disponibles. Elige IDs que encajen con tu marca — el tamaño corporal, la expresión, la etnia y la categoría de pose son filtrables.
- 03
Paso 3
Envía el trabajo de try-on
Envía un POST a `/api/v1/tryon/apparel` con `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`. La API devuelve 202 Accepted con un ID de generación.
- 04
Paso 4
Sondea hasta que el trabajo se complete
GET `/api/v1/tryon/apparel/:id` cada 3 segundos. Cuando `data.status` pase a `completed`, la respuesta incluirá `output_url` y `thumbnail_url`. Pon un límite máximo de intentos para que un trabajo atascado no bloquee tu solicitud.
- 05
Paso 5
Descargar y persistir
Obtén los bytes de `output_url` y almacénalos en tu propio almacenamiento de objetos. La URL del CDN es estable, pero tu producto no debería depender de ella para el renderizado.
Preguntas de otros desarrolladores
Preguntas que los desarrolladores hacen antes de implementar el try-on de ropa
¿Qué es la API de try-on virtual de Photta?+
Un endpoint REST que toma una foto de producto en plano y un par de IDs (maniquí + pose) y devuelve una imagen fotorrealista con modelo. Es el mismo pipeline que la aplicación de consumo de Photta. Se soportan seis tipos de productos: superior, inferior, superior+inferior, vestido, una pieza, mono.
¿Cuánto cuesta por llamada?+
5 créditos para un resultado en 2K, 7 créditos para 4K. Los créditos vienen con tu suscripción y se pueden recargar. Las generaciones fallidas no cuestan créditos — se reembolsan.
¿Cuánto tiempo tarda una generación?+
La finalización típica es de 1.5 a 4 minutos, medida de extremo a extremo. El POST devuelve un ID de generación en menos de un segundo; el trabajo de GPU ocurre en segundo plano mientras realizas el polling.
¿Qué tipos de productos están soportados?+
Seis: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Cada uno espera una estructura de `product_images` diferente — por ejemplo, `top_and_bottom` requiere URLs tanto para `top_image` como para `bottom_image`.
¿Puedo usar mi propio maniquí?+
Sí. Sube una foto de maniquí a `/api/v1/mannequins/upload` o genera un nuevo maniquí de IA con `/api/v1/mannequins/generate-model`. El ID devuelto se inserta directamente en la solicitud de try-on.
¿Cómo realizo el polling para obtener el resultado?+
Haz un GET a `/api/v1/tryon/apparel/:id` cada 3 a 5 segundos hasta que `data.status` sea `completed` o `failed`. Establece un límite superior de intentos — 120 × 3s cubre la ventana documentada con margen de sobra.
Ropa · Capacidad
Crea una cuenta y obtén una API key
La API de try-on virtual de Photta acepta una imagen de ropa en plano, un mannequin ID y un pose ID, luego devuelve una foto con modelo en 2K o 4K. Te autenticas con `Authorization: Bearer photta_live_xxx`, haces un POST a `/api/v1/tryon/apparel`, sondeas el mismo endpoint con el ID de generación devuelto cada 3–5 segundos y descargas el resultado cuando el status cambie a `completed`.