Guia · Virtual try-on

O que é uma API de virtual try-on? e o que ela retorna

Em uma frase

Uma API de virtual try-on recebe a foto de uma roupa e retorna a imagem dessa peça vestida por um modelo. Você faz um POST da foto com um manequim e uma pose, faz o polling do job e baixa o resultado.

Obter uma chave de APILer a documentação
  • Tempo típico: 1.5–4 min
  • Credits: 5 credits em 2K · 6 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

A resposta direta

Uma API de virtual try-on é um endpoint HTTP que renderiza uma peça de roupa em um modelo. Você envia uma foto do produto — geralmente a foto flat ou no manequim que você já tem — e o serviço retorna uma imagem dessa peça sendo vestida. Sem estúdio, sem contratação de modelos, sem refazer fotos quando a grade de cores mudar.

A chamada é assíncrona porque a renderização demora mais do que uma requisição deveria esperar. Você envia um POST da peça com o modelo e a pose desejados, a API aceita o job e retorna um id, e você faz polling em um endpoint de status até que o job informe que foi concluído. A imagem final chega como uma URL que você baixa e armazena por conta própria.

Quem costuma chamar a API são equipes de catálogo que precisam de imagens com modelos para produtos que nunca chegam a um estúdio, marketplaces que recebem fotos flat de vendedores e aplicativos que permitem ao cliente ver uma peça em um corpo diferente do modelo de prova exclusivo da marca.

O endpoint que faz isso

Extraído diretamente da documentação da API do Photta, sem escrita manual.

Visão geral

Endpoint
POST /api/v1/tryon/apparel
Autenticação
API key Bearer
Processamento
Assíncrono — faça polling no endpoint de status
Tempo típico
1.5–4 min
Credits
5 credits em 2K · 6 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 avaliar em qualquer API de try-on

  • O que você envia

    Uma foto da peça de roupa como uma URL https ou uma data URI em base64, além do modelo e da pose desejados. A Photta aceita JPEG, PNG e WebP de até 10 MB por imagem.

  • Quanto tempo leva

    Tempo suficiente para não ser executado dentro de uma requisição web síncrona. A Photta publica um tempo típico de conclusão por endpoint e prevê polling a cada 3 segundos — não há webhooks.

  • Quanto custa

    A Photta cobra credits por chamada: 5 em 2K e 6 em 4K para try-on de vestuário, descontados quando o job começa e estornados automaticamente se ele falhar.

  • Quais limites se aplicam

    Um rate limit publicado de 600 requisições por minuto por chave e um teto por plano para o volume de renderização simultânea. Vale a pena consultar ambos antes de uma execução em escala de catálogo.

A primeira requisição

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

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Perguntas sobre APIs de virtual try-on

O que uma API de try-on retorna?

Uma imagem da peça de roupa vestida pelo modelo escolhido, entregue como uma URL no job concluído. Baixe e armazene a imagem — uma URL de entrega não é hospedagem permanente.

Preciso de uma foto de um modelo?

Não. A Photta inclui um catálogo de manequins para você escolher, e você pode gerar seu próprio modelo a partir de atributos ou fazer o upload de um. A foto da peça é a única imagem obrigatória.

Qual é a diferença entre isso e um provador virtual?

Um provador virtual é uma funcionalidade voltada para o consumidor final. Uma API de try-on é a etapa de renderização por baixo: entra uma chamada, sai uma imagem. Você pode construir um provador virtual sobre ela ou usá-la puramente para produzir fotos de catálogo.

Quanto custa uma chamada de try-on?

Na Photta, 5 credits em 2K e 6 em 4K. Jobs que falham são estornados, portanto o custo de uma nova tentativa é apenas a própria tentativa.

Quanto tempo leva uma imagem?

O endpoint publica seu tempo típico de conclusão, e o job informa seu próprio status. Faça polling a cada 3 segundos em vez de presumir uma duração.

Leia a seguir

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

Experimente na foto do seu próprio produto

Uma requisição, um poll, uma imagem.

Criar uma conta e obter uma chave de APIVer o endpoint
  • 1.5–4 min
  • 5 credits em 2K · 6 credits em 4K
  • assíncrono, polling