Guia · Manequim invisível

O que é uma API de manequim invisível? a foto com manequim invisível

Em uma frase

Uma API de manequim invisível recebe a foto de uma peça no manequim e retorna a mesma peça sem o manequim e com o interior reconstruído, fazendo parecer que a roupa mantém a própria forma.

Obter uma chave de API Ler a documentação

Tempo típico: 1.5–4 min
Credits: 4 credits em 2K · 5 credits em 4K
Processamento: assíncrono, polling

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

A resposta direta

A fotografia ghost mannequin — também chamada de hollow man ou manequim invisível — mostra uma peça de roupa mantendo seu caimento sem nenhum corpo dentro dela. Tradicionalmente, ela é montada na pós-produção a partir de vários frames de estúdio: a peça no manequim, depois a remoção do manequim e, por fim, a composição da parte interna da gola e dos punhos.

Uma API de ghost mannequin faz isso em uma única chamada. Você envia a foto no manequim, o serviço remove a estrutura e reconstrói o que deveria estar visível dentro da peça — o interior da gola, o forro do punho, o cós — e retorna a imagem finalizada. Assim como no try-on, a chamada é assíncrona: enviar, fazer polling, baixar.

É o tratamento padrão para páginas de detalhes de produto (PDP) de vestuário, portanto os clientes são equipes de catálogo e marketplaces que precisam de um visual consistente em milhares de itens sem agendar sessões de estúdio por peça.

O endpoint que faz isso

Obtido da documentação da API da Photta, não escrito à mão.

Visão geral

Endpoint: POST /api/v1/ghost-mannequin
Autenticação: API key Bearer
Processamento: Assíncrono — faça polling no endpoint de status
Tempo típico: 1.5–4 min
Credits: 4 credits em 2K · 5 credits em 4K
Proporções de tela: 3:4 · 1:1 · 4:3 · 9:16 · 16:9
Limites de entrada: Até 10 MB por imagem; JPEG, PNG, WebP
Idempotente: Não

O que buscar em uma API de manequim invisível

O que você envia
A peça fotografada em um manequim, além de uma visão traseira opcional. A Photta aceita JPEG, PNG e WebP de até 10 MB por imagem.
Qual acabamento você recebe
O endpoint da Photta recebe um style: 3d mantém o volume tridimensional da peça, flat_lay achata para um layout frontal limpo.
Quanto custa
4 credits em 2K e 5 em 4K na Photta — um crédito a menos do que o try-on em cada nível, reembolsado automaticamente quando uma tarefa falha.
Suporte a processamento em lote
O trabalho de catálogo chega em araras, não em peças avulsas. A Photta tem um endpoint de batch que recebe um array, reserva os credits antecipadamente e reporta o status por item.

A primeira requisição

A mesma chamada em cURL, Node.js e Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
    "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
    "image_side": "front",
    "angle": "side",
    "style": "3d",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "user_instruction": "closed front, cream interior lining",
    "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front",
      "angle": "side",
      "style": "3d",
      "background_color": "white",
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "user_instruction": "closed front, cream interior lining",
      "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Perguntas sobre APIs de manequim invisível

O que é uma foto ghost mannequin?

Uma foto de produto onde a peça parece flutuar, mantendo seu caimento sem corpo ou cabide visíveis. Ela mostra o caimento e a construção interna de uma só vez, e é por isso que é o padrão em páginas de produto de vestuário.

O que eu envio para o endpoint?

Uma foto da peça em um manequim. Uma visão traseira é opcional e melhora a reconstrução quando a peça é aberta ou reversível.

Devo escolher 3d ou flat lay?

3d quando você quiser que a peça pareça vestida — volume, ombros, mangas. flat_lay quando o anúncio exigir um formato frontal consistente, o que marketplaces costumam fazer.

Quanto custa uma imagem?

Na Photta, 4 credits em 2K e 5 em 4K. Em um batch, o mesmo preço por imagem é reservado antecipadamente para toda a execução.

Posso rodar um catálogo inteiro?

Sim, pelo endpoint de batch. O tamanho do batch e quantos batches podem rodar simultaneamente seguem o seu plano, portanto um catálogo grande roda como uma sequência de batches.

Leia a seguir

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

Processe uma peça de roupa por ela

Entra uma foto, sai uma imagem com manequim invisível.

Criar uma conta e obter uma chave de API Ver o endpoint

1.5–4 min
4 credits em 2K · 5 credits em 4K
assíncrono, polling