Joias · Funcionalidade
API de Provador de Joias — Photta
Colares, anéis, pulseiras e brincos colocados em modelos de IA em close-up, com processamento ajustado para superfícies pequenas e altamente reflexivas. Mesmo preço 2K/4K que vestuário, mesmo padrão assíncrono.
Em uma frase
A API de provador de joias da Photta aceita uma foto da joia mais um `jewelry_type` (colar, anel, pulseira ou brincos) e retorna uma foto em close-up com modelo. Envie um POST para `/api/v1/tryon/jewelry` com `Authorization: Bearer photta_live_xxx`, faça o poll do ID retornado a cada 3 segundos e baixe o resultado quando o status mudar para `completed`.
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_type": "necklace",
"jewelry_images": ["https://example.com/necklace.jpg"],
"mannequin_id": "mnq_jewelry_close_01",
"resolution": "2K",
"aspect_ratio": "1:1"
}'O que esperar
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
Código, ponta a ponta
Escolha sua linguagem
Os mesmos três guias — basta trocar o endpoint e o corpo da requisição.
Como funciona
O fluxo de vestuário, reajustado para itens pequenos e altamente reflexivos
Escolha um manequim em close-up, envie, poll, baixe.
- 01
Passo 1
Gerar uma chave de API
Mesmo fluxo do vestuário — ai.photta.app → Desenvolvedores → Gerar chave de API. Uma única chave funciona em todos os endpoints; um único saldo de créditos cobre todas as funcionalidades.
- 02
Passo 2
Escolha um manequim em close-up
Filtre `/api/v1/mannequins?jewelry_type=necklace` (ou anel / pulseira / brincos) — a Photta mantém um conjunto de manequins em close-up criados especificamente com texturas de pele ajustadas para pequenos metais e pedras.
- 03
Passo 3
Envie o job de joias
Envie um POST para `/api/v1/tryon/jewelry` com `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. O serviço ajusta automaticamente o posicionamento para a categoria da joia.
- 04
Passo 4
Faça poll até o job completar
Use GET em `/api/v1/tryon/jewelry/:id` a cada 3 segundos. O formato da resposta é idêntico ao de vestuário — `data.status`, `data.output_url`, `data.thumbnail_url`.
- 05
Passo 5
Baixar e persistir
Close-up 1:1 funciona melhor para thumbnails de PDP; proporções mais largas para editorial. Armazene os bytes você mesmo em vez de fazer hot-link do CDN.
Perguntas que outros desenvolvedores fazem
Perguntas que desenvolvedores fazem antes de lançar o provador de joias
Quais tipos de joias são suportados?+
Quatro categorias explícitas: colar, anel, pulseira, brincos. Cada categoria tem seu próprio conjunto de manequins em close-up dedicados e uma heurística de posicionamento ajustada para esse formato. Anéis e brincos se beneficiam mais da proporção 1:1; colares ficam melhores em 3:4.
Quanto custa um provador de joias?+
O mesmo que vestuário: 5 créditos em 2K, 7 créditos em 4K. Jobs que falham são reembolsados automaticamente. Sem taxa adicional para a biblioteca de manequins em close-up.
Qual a diferença entre o endpoint de joias e o de vestuário?+
Mesma autenticação, mesmo padrão de polling, mesmo formato de resposta — as diferenças estão no corpo da requisição. Você envia `jewelry_type` e `jewelry_images` em vez de `product_type` e `product_images`, e escolhe manequins filtrados pela categoria da joia. Todo o resto (2K/4K, proporções, créditos) é compartilhado.
Posso enviar meu próprio modelo de joias?+
Sim — `/api/v1/jewelry-mannequins/upload` aceita uma referência personalizada em close-up, `/api/v1/jewelry-mannequins/generate` produz uma nova a partir de prompts. Ambos retornam um ID que você usa na requisição de provador virtual.
Como ele lida com metais reflexivos e pedras preciosas?+
O pipeline de close-up carrega metadados sobre reflexos especulares e microgeometria. Ouro, prata e platina polida são renderizados corretamente, sem o efeito fantasma ou manchas cromáticas que pipelines de provador virtual genéricos produzem. Fundos de estúdio ultra limpos são recomendados para melhores resultados.
Como faço o poll para obter o resultado?+
Use GET em `/api/v1/tryon/jewelry/:id` a cada 3 a 5 segundos. Ciclo de vida de status típico do vestuário: `processing` → `completed` ou `failed`. Uma janela de 1.5 a 4 minutos cobre a grande maioria dos jobs.
Relacionados
Funcionalidades relacionadas
Joias · Funcionalidade
Criar conta e obter chave de API
A API de provador de joias da Photta aceita uma foto da joia mais um `jewelry_type` (colar, anel, pulseira ou brincos) e retorna uma foto em close-up com modelo. Envie um POST para `/api/v1/tryon/jewelry` com `Authorization: Bearer photta_live_xxx`, faça o poll do ID retornado a cada 3 segundos e baixe o resultado quando o status mudar para `completed`.