Referência · Recursos

Endpoints de recursos da API Photta os ids que toda geração precisa

Em uma frase

Os endpoints de recursos retornam os ids que uma chamada de geração recebe: manequins, poses, fundos, calçados, atributos de vestuário e etiquetas de marca, além do saldo e uso da sua conta. Listar não custa nada.

Obter uma chave de API Ler a documentação

Endpoints de recursos: 13 endpoints de recursos
Autenticação: Chave Bearer
Limites: 600 requisições/min

Todos os números nesta página vêm de a documentação da API da Photta · verificado 2026-09-10

Cada endpoint de recurso, com a chamada que o lê

Cada seção traz o link para a funcionalidade que consome esses ids.

GET/api/v1/mannequins

Manequins

Lista os modelos disponíveis para try-on de vestuário: manequins de sistema da Photta, seus próprios uploads e aqueles gerados com a API de geração de manequins. Faça um POST para o mesmo caminho para enviar um manequim personalizado, que permanece privado na sua conta. O id vai em `mannequin_id` em uma chamada 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 try-on virtual

POST/api/v1/mannequins/jewelry

Manequins para joias

Envia uma foto de close-up do modelo para try-on de joias. O trabalho com joias é enquadrado no colo, orelha, pulso ou mão, exigindo assim seu próprio conjunto de manequins em vez do modelo de corpo inteiro para vestuário.

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 joias

GET/api/v1/poses

Poses

Lista as poses que um try-on pode solicitar, filtráveis por categoria e pelo tipo de produto compatível. Passe o id como `pose_id`; se omitido, a API escolhe uma pose adequada à peça de roupa.

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 try-on virtual

GET/api/v1/garment-attributes

Comprimento e caimento do vestuário

Retorna as chaves de comprimento e caimento aceitas pelo try-on de vestuário. Envie a chave, não uma descrição em texto livre, para que a mesma camisa seja renderizada de forma idêntica em todo o 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 try-on virtual

GET/api/v1/backgrounds

Fundos

Lista os fundos do sistema e seus próprios uploads para try-on de vestuário, com paginação por cursor. Faça um POST para o mesmo caminho para enviar um fundo personalizado; ele permanece privado na sua conta.

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 try-on virtual de óculos

POST/api/v1/brand-labels

Etiquetas de marca

Envia uma imagem de etiqueta reutilizável para produções com manequim invisível (ghost mannequin) e retorna um id que você passa como `brand_label_id`, tanto em jobs individuais quanto em lote. GET lista o que você salvou; DELETE remove uma etiqueta ao atingir o limite da conta.

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 manequim invisível

GET/api/v1/footwear

Calçados

Lista opções de calçados para try-on de vestuário, filtráveis por tipo e gênero, com paginação por cursor. Use-o para colocar sapatos no mesmo modelo que veste a roupa.

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 try-on virtual

GET/api/v1/account

Conta

Retorna seu saldo de credits discriminado por fonte, seu plano atual e a próxima renovação de credits. Consulte-o antes de um grande lote em vez de descobrir a falta de saldo em um erro 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"]

API de Workflows

GET/api/v1/account/usage

Uso

Contagem de gerações e consumo de credits para a janela de faturamento do mês civil atual, divididos em jobs concluídos com sucesso e com falha. Este é o endpoint para monitorar em gráficos, não a sua própria contagem de requisições.

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 em lote

Perguntas sobre os endpoints de recursos

Para que servem os endpoints de recursos?

Eles retornam os ids que as chamadas de geração recebem — um manequim, uma pose, um fundo, uma etiqueta de marca — além do status da sua conta. Nada neste grupo cria uma imagem.

As chamadas de recursos consomem credits?

Não. A listagem é gratuita, e os uploads neste grupo — um manequim personalizado, um fundo, uma etiqueta de marca — também são gratuitos. Você paga apenas pelas gerações.

Como paginar através de uma lista longa?

Os endpoints de listagem aceitam um limite e um cursor: passe o último id retornado como `starting_after` e leia a próxima página. Armazene o resultado em cache em vez de listar novamente a cada requisição.

Posso enviar meus próprios manequins e fundos?

Sim. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` e POST `/api/v1/brand-labels` aceitam suas próprias imagens, e tudo o que você envia é privado para a sua conta.

Onde esses ids são usados

Todos os números nesta página vêm de a documentação da API da Photta · verificado 2026-09-10

Experimente a API em cinco minutos

Gere uma chave de API do Photta, cole o snippet de cURL acima e você terá sua primeira imagem com modelo antes que o café termine de passar.

Criar uma conta e obter uma chave de API API

13 endpoints de recursos
Chave Bearer
600 requisições/min