Joyería · Capacidad
API de Try-On de Joyería — Photta
Collares, anillos, pulseras y pendientes colocados en modelos de IA en primer plano, con un manejo ajustado para superficies pequeñas y altamente reflectantes. Mismo precio 2K/4K que la ropa, mismo patrón asíncrono.
En una frase
La API de try-on de joyería de Photta acepta una foto de joyería más un `jewelry_type` (collar, anillo, pulsera o pendientes) y devuelve una foto en primer plano con modelo. POST a `/api/v1/tryon/jewelry` con `Authorization: Bearer photta_live_xxx`, sondea el ID devuelto cada 3 segundos y descarga el resultado cuando el status cambie a `completed`.
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_type": "necklace",
"jewelry_images": ["https://example.com/necklace.jpg"],
"mannequin_id": "mnq_jewelry_close_01",
"resolution": "2K",
"aspect_ratio": "1:1"
}'Qué esperar
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
Código, de punta a punta
Elige tu lenguaje
Mismas tres guías — cambia el endpoint, cambia el cuerpo de la solicitud.
Cómo funciona
El flujo de ropa, ajustado para artículos pequeños y muy reflectantes
Elige un maniquí de primer plano, envía, sondea, descarga.
- 01
Paso 1
Genera una API key
Mismo flujo que con la ropa — ai.photta.app → Desarrolladores → Generar API key. Una clave funciona en todos los endpoints; un solo saldo de créditos cubre cada capacidad.
- 02
Paso 2
Elige un maniquí de primer plano
Filtra `/api/v1/mannequins?jewelry_type=necklace` (o anillo / pulsera / pendientes) — Photta mantiene un conjunto especializado de maniquíes de primer plano con texturas de piel ajustadas para metal y piedras pequeñas.
- 03
Paso 3
Envía el trabajo de joyería
POST a `/api/v1/tryon/jewelry` con `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. El servicio escala automáticamente la colocación para la categoría de joyería.
- 04
Paso 4
Sondea hasta que el trabajo se complete
GET `/api/v1/tryon/jewelry/:id` cada 3 segundos. La estructura de la respuesta es idéntica a la de ropa — `data.status`, `data.output_url`, `data.thumbnail_url`.
- 05
Paso 5
Descargar y persistir
El recorte cerrado 1:1 funciona mejor para miniaturas de PDP; relaciones de aspecto más anchas para editorial. Almacena los bytes tú mismo en lugar de enlazar directamente al CDN.
Preguntas de otros desarrolladores
Preguntas que los desarrolladores hacen antes de implementar el try-on de joyería
¿Qué tipos de joyería están soportados?+
Cuatro categorías explícitas: collar, anillo, pulsera, pendientes. Cada categoría tiene su propio conjunto de maniquíes de primer plano y una heurística de colocación ajustada a ese formato. Los anillos y pendientes se benefician más de la relación de aspecto 1:1; los collares se ven bien en 3:4.
¿Cuánto cuesta un try-on de joyería?+
Igual que la ropa: 5 créditos en 2K, 7 créditos en 4K. Los trabajos fallidos se reembolsan automáticamente. Sin recargo por la librería de maniquíes de primer plano.
¿En qué se diferencia el endpoint de joyería del de ropa?+
Misma autenticación, mismo patrón de polling, misma estructura de respuesta — las diferencias están en el cuerpo de la solicitud. Envías `jewelry_type` y `jewelry_images` en lugar de `product_type` y `product_images`, y eliges maniquíes filtrados por categoría de joyería. Todo lo demás (2K/4K, relaciones de aspecto, créditos) es compartido.
¿Puedo subir mi propio modelo de joyería?+
Sí — `/api/v1/jewelry-mannequins/upload` acepta una referencia personalizada de primer plano, `/api/v1/jewelry-mannequins/generate` produce una nueva mediante prompts. Ambos devuelven un ID que incluyes en la solicitud de try-on.
¿Cómo maneja los metales reflectantes y las piedras preciosas?+
El pipeline de primer plano incluye metadatos sobre reflejos especulares y microgeometría. El oro, la plata y el platino pulido se renderizan correctamente sin el efecto fantasma o el rastro cromático que producen los pipelines de try-on de propósito general. Se recomiendan fondos de estudio ultra limpios para mejores resultados.
¿Cómo realizo el polling para obtener el resultado?+
GET `/api/v1/tryon/jewelry/:id` cada 3 a 5 segundos. Mismo ciclo de vida de status que en ropa: `processing` → `completed` o `failed`. Una ventana de 1.5 a 4 minutos cubre la gran mayoría de los trabajos.
Relacionado
Capacidades relacionadas
Joyería · Capacidad
Crea una cuenta y obtén una API key
La API de try-on de joyería de Photta acepta una foto de joyería más un `jewelry_type` (collar, anillo, pulsera o pendientes) y devuelve una foto en primer plano con modelo. POST a `/api/v1/tryon/jewelry` con `Authorization: Bearer photta_live_xxx`, sondea el ID devuelto cada 3 segundos y descarga el resultado cuando el status cambie a `completed`.