Photta API
Photta API virtual try-on, ghost mannequin y fotografía de producto mediante REST
En una frase
La API de Photta es una API REST basada en créditos: envía por POST una foto de producto a un endpoint de capacidad, haz polling a su endpoint de estado cada pocos segundos y descarga la imagen finalizada. Ocho capacidades, una key, un saldo de créditos.
- Capacidades: 8 capacidades
- Rate limit: 600 requests/min
- Autenticación: Bearer key
- Patrón: asíncrono, polling
Cada cifra de esta página proviene de la documentación de la API de Photta · verificado
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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]Capacidades
Cada endpoint, por capacidad
Método, ruta, créditos y tiempo típico, directamente desde la documentación de la API. Los datos de esta página se contrastan con la documentación en la fecha indicada al pie.
- POST/api/v1/tryon/apparel
Virtual Try-On (Prendas)
Coloca una prenda sobre superficie plana (flat-lay) en un maniquí de IA con la expresión y tamaño corporal que elijas. Cuatro tipos de producto, cinco relaciones de aspecto.
5 credits a 2K · 6 credits a 4K1.5–4 min
Ver el endpoint - POST/api/v1/tryon/jewelry
Try-On de Joyería
Primeros planos detallados de collares, anillos, pulseras y pendientes en maniquíes diseñados para joyería — reflejos y superficies pequeñas resueltos con precisión.
5 credits a 2K · 6 credits a 4K1.5–4 min
Ver el endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Elimina el maniquí de una foto de prenda conservando intacta la estructura interior. Acabado en 3D o flat-lay, compatible con procesamiento por lotes.
4 credits a 2K · 5 credits a 4K1.5–4 min
Ver el endpoint - POST/api/v1/ghost-mannequin/batch
Ghost Mannequin por lotes
Envía un lote completo de fotos de prendas en una sola llamada y haz polling de un único batch ID; cada imagen se factura y rastrea de forma independiente.
4 credits a 2K · 5 credits a 4K1.5–4 min per image
Ver el endpoint - POST/api/v1/eyewear-studio
Estudio de Gafas
Gafas y gafas de sol renderizadas en primeros planos sobre modelos, manteniendo la montura fiel a tu foto de producto.
5 credits a 2K · 6 credits a 4K20–60 sec
Ver el endpoint - POST/api/v1/detail-photos
Fotos de Detalles
Primeros planos de costuras, tejido, herrajes y etiquetas a partir de una sola foto de producto; un analizador sugiere qué zonas fotografiar.
3 credits20–60 sec
Ver el endpoint - POST/api/v1/mannequins/generate
Generación de Maniquíes
Genera tus propios maniquíes de ropa o joyería a partir de opciones predefinidas y reutiliza sus IDs en cada llamada de try-on.
4 credits30-60s
Ver el endpoint - POST/api/v1/workflows/{workflow_id}
Flujos de Trabajo
Ejecuta un flujo de trabajo predefinido —una foto principal de joyería, por ejemplo— con una sola llamada y obtén un conjunto final de imágenes.
4 credits a 2K · 5 credits a 4K20–60 sec / image
Ver el endpoint
Lenguajes
Aún no hay SDK — y no lo necesitas.
Tres guías listas para copiar y pegar que coinciden exactamente con lo que recomienda hoy la documentación de Photta.
Node.js
Node.js
fetch nativo en Node 18+, helper de 20 líneas, listo para Server Actions de Next.js.
LeerPython
Python
Librería requests + un wrapper de 30 líneas. Funciona en Django, FastAPI, Celery, Lambda.
LeercURL
cURL
Smoke test de dos minutos para cualquier endpoint. Se integra con jq para pipelines de shell.
Leer
Quickstart
Desde el registro hasta la primera imagen en cinco minutos.
Cada capacidad sigue el mismo patrón: autenticar, enviar, polling. Apréndelo una sola vez.
Paso 1: Regístrate en ai.photta.app y genera una API key activa desde el dashboard de Developers.
Paso 2: Envía el job mediante POST con tu key en el header Authorization — la API devuelve un ID de generación de inmediato.
Paso 3: Haz polling al mismo endpoint cada 3 segundos hasta que el estado cambie a completed, luego descarga la URL del resultado.
Preguntas
Lo que los desarrolladores preguntan antes de registrarse
¿Qué es la API de Photta?
La API de Photta es un servicio REST basado en créditos que genera fotografía de moda profesional a partir de tus fotos de producto. Es el mismo pipeline que impulsa las aplicaciones de consumo de Photta: virtual try-on de ropa, try-on de joyería y extracción de ghost mannequin, expuesto como ocho capacidades para que los desarrolladores construyan sus propias herramientas sobre él.
¿Cómo obtengo una API key?
Regístrate en ai.photta.app, abre la sección Developers del dashboard y haz clic en Generate API key. Tu key activa comienza con `photta_live_` seguido de 32 caracteres hexadecimales. Guárdala en una variable de entorno — nunca la subas al control de versiones, nunca la envíes al navegador.
¿Hay un tier gratuito?
Las cuentas nuevas reciben créditos de prueba que puedes usar en cualquier capacidad. Cuando estés listo para pasar a producción, suscríbete a un plan con un saldo mensual de créditos mayor. El rate limit es el mismo en todos los planes: 600 solicitudes por minuto por API key. Sin mínimos por llamada.
¿Qué tan rápida es la generación?
Los jobs de try-on y ghost mannequin suelen completarse en 1.5 a 4 minutos; fotos de gafas, fotos de detalle e imágenes de flujo de trabajo en 20 a 60 segundos; la generación de maniquíes en 30 a 60 segundos. Cada endpoint de generación es asíncrono: POST devuelve un ID de generación de inmediato y haces polling cada 3 a 5 segundos hasta que el job finalice. No hay conexiones HTTP de larga duración que gestionar.
¿Hay un SDK oficial de Photta?
Aún no. La vía de integración soportada es REST directo mediante cURL, el fetch nativo de Node o la librería requests de Python — las tres están documentadas de extremo a extremo en este sitio, para cada capacidad.
Referencia
Las partes de la documentación que consultarás más de una vez.
Referencia
Tu primera imagen de Photta en menos de cinco minutos.
Regístrate, genera una API key, ejecuta tu primera llamada cURL, haz polling hasta que se complete y guarda el resultado. Cinco pasos, documentados de principio a fin.
LeerReferencia
Autenticación de la API de Photta
Cómo autenticarse frente a la API de Photta: la cabecera Authorization, el prefijo de clave, dónde se generan las claves y cómo rotarlas de forma segura.
LeerReferencia
Precios de la API de Photta
Cuánto cuesta en credits cada endpoint de Photta API a 2K y 4K, cómo funcionan los cobros y reembolsos, y qué endpoints son gratuitos. Sin precio monetario por imagen.
LeerReferencia
Rate limits de la API de Photta
El rate limit de la API de Photta, su ventana, la cabecera Retry-After, el intervalo de polling y los límites de concurrencia por plan, todo extraído directamente de la documentación de la API.
LeerReferencia
Errores de Photta API
La lista completa de tipos de error de Photta API con sus status codes, la estructura del cuerpo de error y qué fallos merece la pena reintentar.
LeerReferencia
Endpoints de recursos de la API de Photta
Lista maniquíes, poses, fondos, calzado y etiquetas de marca, sube los tuyos propios y consulta tu saldo de credits. Las búsquedas detrás de cada generación.
LeerGuías
¿Qué es una API de virtual try-on?
Una API de virtual try-on renderiza una prenda sobre un modelo a partir de una sola foto de producto. Qué recibe, qué devuelve, cuánto cuesta y cuánto tarda en ejecutarse.
LeerGuías
¿Qué es una API de ghost mannequin?
Una API de ghost mannequin elimina el maniquí de la foto de una prenda y reconstruye el interior. Qué requiere, qué devuelve y cuánto cuesta.
LeerGuías
Migración de FASHN a Photta
Qué cambia cuando trasladas una integración de virtual try-on de FASHN a Photta: autenticación, cuerpo de la petición, polling y cómo se cobran los credits.
LeerConstruir
Desarrolla con la API de Photta
Ocho recetas de extremo a extremo para la API de Photta: una app de try-on, una app de Shopify, un plugin de WooCommerce, un worker de Django, catálogos por lotes y automatización no-code.
LeerComparar
Las mejores API de virtual try-on
Cómo funcionan cinco API de virtual try-on — Photta, FASHN, FitRoom, Pixazo y Ayna. Qué publica cada una, qué no, y dónde consultar los detalles.
Leer
Cada cifra de esta página proviene de la documentación de la API de Photta · verificado
Prueba la API en cinco minutos
Genera una API key de Photta, pega el snippet de cURL de arriba y tendrás tu primera imagen con modelo antes de que termine de prepararse el café.
- 8 capacidades
- 600 requests/min
- Bearer key
- asíncrono, polling