API Photta
Fotografia de moda com IA, a uma chamada REST de distância.
Gere fotos de roupas e joias em modelos, remova manequins de fotos em plano aberto (flat-lay) e construa seu próprio estúdio de moda com IA sobre o pipeline de produção da Photta — endpoints REST assíncronos, preços baseados em créditos, docs focadas em cURL.
Funcionalidades
3
Autenticação
Bearer
Padrão
Assíncrono + poll
Típico
1–4 min
Funcionalidades
Três endpoints, uma conta, um único saldo de créditos.
Cada funcionalidade compartilha a mesma autenticação, padrão de polling e formato de erro — aprenda uma, implemente as três.
Provador Virtual (Vestuário)
Coloque uma peça de roupa em plano aberto em um manequim de IA na pose, expressão e biotipo que você escolher. Seis tipos de produtos, cinco proporções.
Provador de Joias
Close-ups de colares, anéis, pulseiras e brincos em manequins de joias dedicados — reflexos e superfícies pequenas processados com precisão.
Manequim Invisível
Remova o manequim de uma foto de vestuário e mantenha a construção interna intacta. Acabamento oco (hollow-man) ou plano (flat-lay), pronto para processamento em lote.
Linguagens
Sem SDK por enquanto — e você não precisa de um.
Três guias prontos para copiar que seguem exatamente o que a documentação da Photta recomenda hoje.
javascript
→Node.js
fetch nativo no Node 18+, helper de 20 linhas, pronto para server actions do Next.js.
python
→Python
biblioteca requests + um wrapper de 30 linhas. Funciona em Django, FastAPI, Celery, Lambda.
bash
→cURL
Teste de fumaça de dois minutos para qualquer endpoint. Funciona com jq para pipelines em shell.
Início Rápido
Do cadastro à primeira imagem em cinco minutos.
Cada funcionalidade segue o mesmo padrão: autenticar, enviar, poll. Aprenda uma vez.
- 1Cadastre-se em ai.photta.app e gere uma chave de API live no dashboard de Desenvolvedores.
- 2Envie um POST com sua chave no header Authorization — a API retorna um ID de geração imediatamente.
- 3Faça poll no mesmo endpoint a cada 3 segundos até que o status mude para completed, então baixe a URL de resultado.
curl -X POST \
https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["..."],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K"
}'Perguntas
O que os desenvolvedores perguntam antes de se cadastrar
O que é a API Photta?+
A API da Photta é um serviço REST baseado em créditos que gera fotografia de moda profissional a partir das fotos de seus produtos. É o mesmo pipeline que alimenta os apps de consumo da Photta — provador virtual de vestuário, provador de joias e extração de manequim invisível, expostos como três endpoints para desenvolvedores construírem suas próprias ferramentas por cima.
Como obtenho uma chave de API?+
Cadastre-se em ai.photta.app, abra a seção de Desenvolvedores no dashboard, clique em Gerar chave de API. Sua chave live 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 envie para o navegador.
Existe um plano gratuito?+
Novas contas recebem créditos de teste que podem ser usados em qualquer funcionalidade. Quando estiver pronto para o lançamento, assine um plano com maior saldo mensal de créditos e rate limits mais rápidos (30/min Starter, 60/min Pro). Sem mínimos por chamada; créditos não utilizados não expiram dentro do período de faturamento.
Quão rápida é a geração?+
Jobs de provador virtual geralmente levam de 1.5 a 4 minutos. Manequim invisível é mais rápido — geralmente de 1 a 3 minutos. Cada endpoint é assíncrono: o POST retorna um ID de geração em menos de um segundo, e você faz o poll a cada 3 a 5 segundos até o job terminar. Não há necessidade de gerenciar conexões HTTP de longa duração.
Existe um SDK oficial da Photta?+
Ainda não. O roadmap da documentação prevê um SDK Python quando houver dez clientes ativos da API e um SDK Node.js com vinte. Até lá, o caminho de integração suportado é REST puro via cURL, fetch nativo do Node ou a biblioteca requests do Python — os três estão documentados de ponta a ponta neste site.
API Photta
Teste a API em cinco minutos
Gere uma chave de API Photta, cole o snippet cURL acima e você terá sua primeira imagem com modelo antes mesmo do café terminar de passar.