Referencia · Recursos

Endpoints de recursos de la API de Photta los ids que necesita cada generación

En una frase

Los endpoints de recursos devuelven los ids que recibe una llamada de generación: maniquíes, poses, fondos, calzado, atributos de prenda y etiquetas de marca, además del saldo y uso de tu cuenta. Listar no cuesta nada.

Obtener una API key Leer la documentación

Endpoints de recursos: 13 endpoints de recursos
Autenticación: Bearer key
Límites: 600 requests/min

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

Cada endpoint de recurso, con la llamada para consultarlo

Cada sección enlaza la funcionalidad que consume esos ids.

GET/api/v1/mannequins

Maniquíes

Lista los modelos disponibles para el try-on de ropa: maniquíes del sistema de Photta, tus propias subidas y los que creaste con la API de generación de maniquíes. Haz un POST a la misma ruta para subir un maniquí personalizado, que permanece privado para tu cuenta. El id se pasa en `mannequin_id` en una llamada de try-on.

curl https://api.photta.app/api/v1/mannequins \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/mannequins", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/mannequins",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de virtual try-on

POST/api/v1/mannequins/jewelry

Maniquíes para joyería

Sube una foto de primer plano de un modelo para el try-on de joyería. El trabajo de joyería se encuadra en un escote, una oreja, una muñeca o una mano, por lo que requiere su propio conjunto de maniquíes en lugar del de cuerpo entero para ropa.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
  "jewelry_type": "necklace",
  "gender": "female",
  "name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
    "jewelry_type": "necklace",
    "gender": "female",
    "name": "Emma"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/jewelry",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
      "jewelry_type": "necklace",
      "gender": "female",
      "name": "Emma"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

API de try-on de joyas

GET/api/v1/poses

Poses

Lista las poses que puede solicitar un try-on, filtrables por categoría y por el tipo de producto al que se adaptan. Pasa el id como `pose_id`; si lo omites, la API elige una pose adecuada para la prenda.

curl https://api.photta.app/api/v1/poses \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/poses", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/poses",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de virtual try-on

GET/api/v1/garment-attributes

Largo y ajuste de la prenda

Devuelve las claves de largo y ajuste que acepta el try-on de ropa. Envía la clave, no una descripción en texto libre, para que la misma camisa se renderice de forma idéntica en todo un catálogo.

curl https://api.photta.app/api/v1/garment-attributes \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/garment-attributes",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de virtual try-on

GET/api/v1/backgrounds

Fondos

Lista los fondos del sistema y tus propias subidas para el try-on de ropa, con paginación por cursor. Haz un POST a la misma ruta para subir un fondo personalizado; permanece privado para tu cuenta.

curl https://api.photta.app/api/v1/backgrounds \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/backgrounds",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de virtual try-on de gafas

POST/api/v1/brand-labels

Etiquetas de marca

Sube una imagen de etiqueta reutilizable para trabajos de maniquí invisible y devuelve un id que pasas como `brand_label_id`, tanto en trabajos individuales como en lotes. GET lista lo que tienes guardado; DELETE elimina una cuando alcances el límite de la cuenta.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "@/path/to/pribrand-label.png",
  "name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "file": "@/path/to/pribrand-label.png",
    "name": "Pribrand Collar Label"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/brand-labels",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "file": "@/path/to/pribrand-label.png",
      "name": "Pribrand Collar Label"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

API de maniquí invisible

GET/api/v1/footwear

Calzado

Lista las opciones de calzado para el try-on de ropa, filtrables por tipo y género, con paginación por cursor. Úsalo para ponerle zapatos al mismo modelo que viste la prenda.

curl https://api.photta.app/api/v1/footwear \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/footwear", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/footwear",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de virtual try-on

GET/api/v1/account

Cuenta

Devuelve tu saldo de credits desglosado por origen, tu plan actual y la próxima renovación de credits. Consúltalo antes de un lote grande en lugar de descubrir la falta de saldo con un 402.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Workflows API

GET/api/v1/account/usage

Uso

Recuentos de generación y gasto de credits para la ventana de facturación del mes natural en curso, divididos en trabajos completados y fallidos. Este es el endpoint para graficar, no tu propio recuento de peticiones.

curl https://api.photta.app/api/v1/account/usage \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account/usage", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account/usage",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

API de ghost mannequin por lotes

Preguntas sobre los endpoints de recursos

¿Para qué sirven los endpoints de recursos?

Devuelven los ids que reciben las llamadas de generación —un maniquí, una pose, un fondo, una etiqueta de marca— más el estado de tu cuenta. Ninguno en este grupo crea una imagen.

¿Las llamadas de recursos cuestan credits?

No. Listar es gratis, y las subidas en este grupo —un maniquí personalizado, un fondo, una etiqueta de marca— también son gratuitas. Solo pagas por las generaciones.

¿Cómo pagino a través de una lista larga?

Los endpoints de listado aceptan un límite y un cursor: pasa el último id que viste como `starting_after` y lee la página siguiente. Guarda en caché lo que obtengas en lugar de volver a listar en cada petición.

¿Puedo subir mis propios maniquíes y fondos?

Sí. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` y POST `/api/v1/brand-labels` aceptan tus propias imágenes, y todo lo que subes permanece privado para tu cuenta.

Dónde se usan estos ids

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

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é.

Crear una cuenta y obtener una API key API

13 endpoints de recursos
Bearer key
600 requests/min