Vestuário · Funcionalidade

API de Provador Virtual — Photta

Uma única chamada REST transforma uma foto de vestuário em plano aberto em uma imagem com modelo pronta para campanha. Assíncrono, 1.5–4 minutos por geração, 5 créditos em 2K ou 7 créditos em 4K.

Em uma frase

A API de provador virtual da Photta aceita uma imagem de vestuário em plano aberto, um ID de manequim e um ID de pose, retornando uma foto com modelo em 2K ou 4K. Você autentica com `Authorization: Bearer photta_live_xxx`, envia um POST para `/api/v1/tryon/apparel`, faz o poll no mesmo endpoint com o ID de geração retornado a cada 3–5 segundos e baixa o resultado quando o status mudar para `completed`.

Obter chave de API→Ler a documentação

POST/api/v1/tryon/apparel

cURL

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": ["https://example.com/dress.jpg"],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

O que esperar

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Aspect ratios

Product types

Código, ponta a ponta

Escolha sua linguagem

Mesmo endpoint, três guias executáveis. Cada snippet segue a documentação oficial da Photta.

SDK

→

Node.js

fetch nativo no Node 18+ · Pronto para server actions do Next.js

SDK

→

Python

requests + wrapper de 30 linhas · Django / FastAPI / Celery

SDK

→

cURL

Teste em shell de dois minutos · pipelines jq · instalação zero

Como funciona

Quatro chamadas de API, uma foto de produto

Escolha um manequim e uma pose, envie o job, faça poll até terminar, baixe o resultado.

01
Passo 1
Gerar uma chave de API
Cadastre-se em ai.photta.app, abra a aba de Desenvolvedores, clique em Gerar chave de API. Chaves live começam com `photta_live_`. Coloque a chave em `PHOTTA_API_KEY` — nunca a envie para o repositório.
02
Passo 2
Escolha um manequim e uma pose
Use GET em `/api/v1/mannequins` e `/api/v1/poses` para listar as opções. Escolha IDs que combinem com sua marca — tamanho do corpo, expressão, etnia e categoria de pose são todos filtráveis.
03
Passo 3
Envie o job de provador virtual
Envie um POST para `/api/v1/tryon/apparel` com `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution` e `aspect_ratio`. A API retorna 202 Accepted com um ID de geração.
04
Passo 4
Faça poll até o job completar
Use GET em `/api/v1/tryon/apparel/:id` a cada 3 segundos. Quando `data.status` mudar para `completed`, o payload incluirá `output_url` e `thumbnail_url`. Defina um limite máximo para que um job travado não prenda sua requisição.
05
Passo 5
Baixar e persistir
Busque os bytes da `output_url` e armazene-os em seu próprio storage de objetos. A URL do CDN é estável, mas seu produto não deve depender dela para renderização.

Perguntas que outros desenvolvedores fazem

Perguntas que desenvolvedores fazem antes de lançar o provador virtual de vestuário

O que é a API de provador virtual da Photta?+

Um endpoint REST que recebe uma imagem de produto em plano aberto e um par de IDs (manequim + pose) e retorna uma imagem fotorrealista com modelo. Mesmo pipeline do app de consumo da Photta. Seis tipos de produtos são suportados: superior, inferior, superior+inferior, vestido, peça única, macacão.

Quanto custa por chamada?+

5 créditos para um resultado 2K, 7 créditos para 4K. Os créditos vêm com sua assinatura e podem ser recarregados. Gerações que falham não custam créditos — eles são reembolsados.

Quanto tempo leva uma geração?+

A conclusão típica leva de 1.5 a 4 minutos, medidos de ponta a ponta. O POST retorna um ID de geração em menos de um segundo; o trabalho de GPU acontece em segundo plano enquanto você faz o poll.

Quais tipos de produtos são suportados?+

Seis: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Cada um espera um formato diferente em `product_images` — por exemplo, `top_and_bottom` requer as URLs de `top_image` e `bottom_image`.

Posso usar meu próprio manequim?+

Sim. Faça o upload de uma foto de manequim para `/api/v1/mannequins/upload` ou gere um novo manequim de IA com `/api/v1/mannequins/generate-model`. O ID retornado é usado diretamente na requisição de provador virtual.

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

Use GET em `/api/v1/tryon/apparel/:id` a cada 3 a 5 segundos até que `data.status` seja `completed` ou `failed`. Defina um limite de tentativas — 120 × 3s cobre a janela documentada com folga.

Relacionados