Manequim Invisível · Funcionalidade

API de Manequim Invisível — Photta

Remova o manequim de uma foto de vestuário e mantenha a construção interna — costuras, forros, etiquetas — totalmente intactas. Acabamento oco (hollow-man) ou plano (flat-lay), pronto para processamento em lote, 4 créditos em 2K.

Em uma frase

A API de manequim invisível da Photta recebe uma foto de vestuário no manequim e retorna uma imagem de manequim invisível com o interior da peça reconstruído. Envie um POST para `/api/v1/ghost-mannequin` com uma `product_image_url`, um `style` (hollow_man ou flat_lay) e uma resolução. Faça o poll em `/api/v1/ghost-mannequin/:id` a cada 3 segundos até que o status mude para `completed`.

Obter chave de API→Ler a documentação

POST/api/v1/ghost-mannequin

cURL

curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://example.com/tshirt-on-model.jpg",
    "style": "hollow_man",
    "resolution": "2K"
  }'

O que esperar

Typical completion

1–3min

2K / 4K credits

4 / 6

Styles

Batch-ready

yes

Código, ponta a ponta

Escolha sua linguagem

Mesmo contrato REST; o endpoint de manequim invisível também suporta processamento em lote para execuções em larga escala no catálogo.

SDK

→

Node.js

fetch nativo · combina perfeitamente com BullMQ ou Inngest para jobs em lote

SDK

→

Python

requests + asyncio quando você precisar de envio paralelo

SDK

→

cURL

Ideal para testes de fumaça em payloads de lote antes de integrá-los

Como funciona

Uma foto entra, uma foto de manequim invisível sai

Suba a origem, escolha um estilo, envie, poll, baixe.

01
Passo 1
Gerar uma chave de API
Manequim invisível usa as mesmas credenciais que qualquer outra funcionalidade da Photta — uma chave, um único saldo de créditos.
02
Passo 2
Upload da foto de origem
Você pode passar uma URL pública em `product_image_url` ou fazer o upload dos bytes primeiro via `/api/v1/uploads`. O endpoint aceita JPG, PNG e WebP.
03
Passo 3
Envie o job de manequim invisível
Envie um POST para `/api/v1/ghost-mannequin` com `product_image_url`, `style` (hollow_man ou flat_lay) e `resolution`. Passe `webhook_url` se quiser um ping quando o job completar — o polling continua sendo o caminho principal.
04
Passo 4
Faça poll até o job completar
Use GET em `/api/v1/ghost-mannequin/:id` a cada 3 segundos. Manequim invisível é mais rápido que o provador virtual — geralmente de 1 a 3 minutos — porque nenhuma pessoa nova está sendo renderizada.
05
Passo 5
Baixar e persistir
O resultado é um PNG com o manequim removido e o interior da peça reconstruído. Ideal para fotos invisíveis de PDP, galerias de produtos com sensação 3D e inserções em plano aberto.

Perguntas que outros desenvolvedores fazem

Perguntas que desenvolvedores fazem antes de lançar o manequim invisível

O que é fotografia de manequim invisível?+

Um tratamento de PDP onde a peça parece flutuar em um corpo invisível, mostrando a forma e a construção interna ao mesmo tempo. Historicamente, isso é montado a partir de várias fotos de estúdio; a API da Photta produz isso em uma única chamada a partir de uma foto no manequim.

Quanto custa o manequim invisível?+

4 créditos em 2K, 6 créditos em 4K — um crédito mais barato em cada nível do que o provador virtual. Jobs que falham são reembolsados automaticamente.

Qual a diferença entre os estilos hollow-man e flat-lay?+

Hollow-man mantém a forma 3D do corpo do manequim — a peça retém o volume, ombros e mangas parecem naturais, e o interior é reconstruído. Flat-lay achata a peça em um layout 2D limpo, ideal para coleções cápsula ou listagens em marketplaces que esperam uma forma frontal consistente.

Posso processar várias fotos em lote?+

Sim. Envie um POST para `/api/v1/ghost-mannequin/batch` com um array de imagens de origem. A resposta fornece um ID de lote mais IDs de geração por item. Faça o poll em `/api/v1/ghost-mannequin/batch/:id` para um status agregado ou para cada item individualmente.

Ele preserva costuras internas e etiquetas?+

Sim — o modelo reconstrói o interior da peça (interior do decote, interior do punho, forro do cós) em vez de alucinar uma superfície genérica. Etiquetas e rótulos impressos visíveis na foto original são mantidos sempre que possível.

Como faço o poll para obter o resultado?+

Use GET em `/api/v1/ghost-mannequin/:id` a cada 3 segundos. Jobs em lote fazem poll em um endpoint pai que retorna um status agregado mais um detalhamento por item.

Relacionados