Photta API
Photta API try-on virtual, manequim invisível e fotografia de produtos via REST
Em uma frase
A API do Photta é uma API REST baseada em credits: envie uma foto de produto via POST para o endpoint de uma funcionalidade, faça polling no seu endpoint de status a cada poucos segundos, baixe a imagem finalizada. Oito funcionalidades, uma chave, um saldo de credits.
- Recursos: 8 recursos
- Rate limit: 600 requisições/min
- Autenticação: Chave Bearer
- Padrão: assíncrono, polling
Todos os números nesta página vêm de a documentação da API da 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"]Recursos
Todos os endpoints, por funcionalidade
Método, caminho, credits e tempo típico, direto da documentação da API. As informações nesta página foram verificadas com a documentação na data indicada no rodapé.
- POST/api/v1/tryon/apparel
Provador Virtual (Roupas)
Coloque uma peça em flat-lay em um manequim de IA com a expressão e o tamanho corporal que você escolher. Quatro tipos de produto, cinco proporções de tela.
5 credits em 2K · 6 credits em 4K1.5–4 min
Ver o endpoint - POST/api/v1/tryon/jewelry
Provador de Joias
Close-ups fechados de colares, anéis, pulseiras e brincos em manequins de joias dedicados — reflexos e superfícies minúsculas perfeitamente tratados.
5 credits em 2K · 6 credits em 4K1.5–4 min
Ver o endpoint - POST/api/v1/ghost-mannequin
Manequim Invisível
Remova o manequim da foto da peça mantendo a construção interna intacta. Acabamento 3D ou flat-lay, pronto para lotes.
4 credits em 2K · 5 credits em 4K1.5–4 min
Ver o endpoint - POST/api/v1/ghost-mannequin/batch
Manequim Invisível em Lote
Envie uma arara inteira de fotos de peças em uma única chamada e monitore via polling um único ID de lote; cada imagem é cobrada e rastreada individualmente.
4 credits em 2K · 5 credits em 4K1.5–4 min per image
Ver o endpoint - POST/api/v1/eyewear-studio
Estúdio de Óculos
Óculos de grau e de sol renderizados em modelos em close-up, mantendo a armação idêntica à foto do seu produto.
5 credits em 2K · 6 credits em 4K20–60 sec
Ver o endpoint - POST/api/v1/detail-photos
Fotos de Detalhes
Close-ups de costura, tecido, aviamentos e etiquetas a partir de uma única foto do produto; um analisador sugere quais áreas fotografar.
3 credits20–60 sec
Ver o endpoint - POST/api/v1/mannequins/generate
Geração de Manequins
Gere seus próprios manequins de roupas ou joias a partir de opções e reutilize os IDs deles em cada chamada de provador.
4 credits30-60s
Ver o endpoint - POST/api/v1/workflows/{workflow_id}
Fluxos de Trabalho
Execute um fluxo de trabalho pré-definido — uma foto principal de joia, por exemplo — com uma chamada e receba um conjunto finalizado de imagens.
4 credits em 2K · 5 credits em 4K20–60 sec / image
Ver o endpoint
Linguagens
Nenhum SDK ainda — e você não precisa de um.
Três tutoriais prontos para colar que correspondem exatamente ao que a documentação do Photta recomenda hoje.
Node.js
Node.js
fetch nativo no Node 18+, helper de 20 linhas, pronto para server actions do Next.js.
LerPython
Python
Biblioteca requests + um wrapper de 30 linhas. Funciona em Django, FastAPI, Celery, Lambda.
LercURL
cURL
Smoke test de dois minutos para qualquer endpoint. Combina com jq para pipelines no shell.
Ler
Início rápido
Do cadastro à primeira imagem em cinco minutos.
Cada funcionalidade segue o mesmo padrão: autenticar, enviar, fazer polling. Aprenda uma vez.
Passo 1: Cadastre-se em ai.photta.app e gere uma chave de API de produção no painel Developers.
Passo 2: Envie o job via POST com sua chave no cabeçalho Authorization — a API retorna um ID de geração imediatamente.
Passo 3: Faça polling no mesmo endpoint a cada 3 segundos até que o status mude para completed, depois baixe a URL de resultado.
Perguntas
O que os desenvolvedores perguntam antes de se cadastrar
O que é a API do Photta?
A API do Photta é um serviço REST baseado em credits que gera fotografia de moda profissional a partir das suas fotos de produtos. É o mesmo pipeline que alimenta os aplicativos para consumidores do Photta — try-on virtual de roupas, try-on de joias e extração de manequim invisível, expostos em oito funcionalidades para desenvolvedores criarem suas próprias ferramentas.
Como obtenho uma chave de API?
Cadastre-se em ai.photta.app, abra a seção Developers do painel e clique em Generate API key. Sua chave de produção começa com `photta_live_` seguido por 32 caracteres hexadecimais. Mantenha-a em uma variável de ambiente — nunca a envie para o controle de versão, nunca a exponha no navegador.
Existe um plano gratuito?
Novas contas recebem credits de teste que você pode usar em qualquer funcionalidade. Assim que estiver pronto para produção, assine um plano com um saldo mensal de credits maior. O rate limit é o mesmo em todos os planos: 600 requisições por minuto por chave de API. Sem valores mínimos por chamada.
Qual é a velocidade de geração?
Jobs de try-on e manequim invisível normalmente são concluídos entre 1.5 e 4 minutos; fotos de óculos, fotos de detalhes e imagens de workflow entre 20 e 60 segundos; geração de manequim entre 30 e 60 segundos. Todos os endpoints de geração são assíncronos: o POST retorna um ID de geração imediatamente, e você faz polling a cada 3 a 5 segundos até que o job termine. Não há conexão HTTP de longa duração para gerenciar.
Existe um SDK oficial do Photta?
Ainda não. A forma de integração suportada é REST puro via cURL, fetch nativo do Node ou a biblioteca requests do Python — todos os três estão documentados de ponta a ponta neste site, para cada funcionalidade.
Referência
As seções da documentação que você abrirá mais de uma vez.
Referência
Primeira imagem no Photta em menos de cinco minutos.
Cadastre-se, gere uma chave de API, execute sua primeira chamada cURL, faça polling até a conclusão, persista o resultado. Cinco etapas, documentadas de ponta a ponta.
LerReferência
Autenticação da Photta API
Como se autenticar na Photta API: o cabeçalho Authorization, o prefixo da chave, onde as chaves são criadas e como rotacioná-las com segurança.
LerReferência
Preços da API Photta
Quanto custa em credits cada endpoint da Photta API em 2K e 4K, como funcionam as cobranças e reembolsos, e quais endpoints são gratuitos. Sem preço monetário por imagem.
LerReferência
Rate limits da API Photta
O rate limit da API Photta, sua janela, o header Retry-After, o intervalo de polling e os limites de simultaneidade por plano, tudo extraído da documentação da API.
LerReferência
Erros da Photta API
A lista completa de tipos de erro da Photta API com seus status codes, o formato do corpo de erro e quais falhas valem a pena tentar novamente.
LerReferência
Endpoints de recursos da API Photta
Liste manequins, poses, fundos, calçados e etiquetas de marca, envie os seus próprios e consulte o saldo de credits. As consultas por trás de cada geração.
LerGuias
O que é uma API de virtual try-on?
Uma API de virtual try-on renderiza uma peça de roupa em uma modelo a partir de uma única foto de produto. O que ela recebe, o que retorna, quanto custa e qual o tempo de execução.
LerGuias
O que é uma API de manequim invisível?
Uma API de manequim invisível remove o manequim de uma foto de roupa e reconstrói o interior da peça. O que ela recebe, o que ela retorna e quanto custa.
LerGuias
Migrando da FASHN para a Photta
O que muda quando você move uma integração de virtual try-on da FASHN para a Photta: autenticação, corpo da requisição, polling e como os credits são cobrados.
LerConstruir
Construa com a API da Photta
Oito receitas ponta a ponta para a API da Photta: um app de try-on, um app para Shopify, um plugin para WooCommerce, um worker Django, catálogos em lote e automação no-code.
LerComparar
Melhores APIs de virtual try-on
Como cinco APIs de virtual try-on funcionam — Photta, FASHN, FitRoom, Pixazo e Ayna. O que cada uma publica, o que omitem e onde conferir os detalhes.
Ler
Todos os números nesta página vêm de a documentação da API da Photta · verificado
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.
- 8 recursos
- 600 requisições/min
- Chave Bearer
- assíncrono, polling