API de teste virtual

O que é uma API de teste virtual?

Uma API de teste virtual tira uma foto de uma pessoa e uma foto de uma roupa e, em seguida, gera uma imagem dessa pessoa vestindo a roupa – sem um provador físico, uma sessão de fotos ou uma nova sessão de estúdio. Ele responde a uma questão de ajuste e aparência, não a uma questão de catálogo de produtos.

Muapi expõe isso por meio do AI Dress Change, um endpoint único que pega model_image_url e vestuário_image_url e retorna o resultado composto – uma chave de API, um fluxo de solicitação/pesquisa, preço pré-pago.

Teste virtual vs. fotografia de produto

Estas são intenções adjacentes, mas distintas. A prova virtual pega a imagem de uma pessoa existente e a troca por uma roupa diferente – o resultado é uma visualização do ajuste/aparência daquela pessoa ou modelo específico. A fotografia de produto gera novas imagens de um produto prontas para catálogo a partir do zero, com fundos e iluminação prontamente controlados, sem necessariamente colocá-lo em uma pessoa fixa. Use a prova virtual para mostrar ao comprador a aparência de uma peça de roupa; use a fotografia do produto para produzir uma lista limpa ou uma foto do estilo de vida do produto. Compare com a fotografia do produto →

Principais capacidades

Obtendo boa qualidade de entrada e resultados de pose

• Use uma foto de modelo nítida e frontal. Uma única pessoa, boa iluminação e uma pose neutra ou em pé dão ao modelo a referência mais clara de onde a roupa deve ficar.
• Isole a roupa. Uma foto plana ou de manequim com o mínimo de desordem no fundo produz uma transferência de textura e forma mais precisa do que uma peça de roupa fotografada em uma pessoa diferente.
• Combine a categoria da roupa com a cobertura do corpo. Tops, vestidos e agasalhos geralmente são transferidos de maneira mais confiável do que roupas complexas em camadas; teste com seu catálogo específico antes do processamento em lote.
• Espere alguma iteração. Como todo modelo de imagem generativo, os resultados variam de execução para execução — trate a primeira saída como um rascunho e execute novamente com uma imagem de origem mais limpa se o ajuste ou a textura parecerem inadequados.

Privacidade e consentimento

A prova virtual gera uma imagem baseada na semelhança de quem aparece na foto do modelo. Envie apenas fotos de pessoas que concordaram em ser usadas dessa forma – você, um modelo contratado sob autorização ou um cliente que optou explicitamente por um recurso de teste. Não use a foto de outra pessoa sem permissão e não use este endpoint para gerar a imagem de uma pessoa real em uma peça de roupa ou contexto com o qual ela não tenha consentido. Muapi não verifica o consentimento em seu nome; essa responsabilidade cabe ao chamador da API.

Como chamar a API de teste virtual

1. Hospede ambas as imagens. Faça upload da foto do modelo e da roupa via POST /api/v1/upload_file ou use qualquer URL acessível publicamente.
2. Envie a solicitação. Chame POST /api/v1/ai-dress-change com model_image_url e vestuário_image_url.
3. Enquete para conclusão. Verifique GET /api/v1/predictions/{request_id}/result até que o status seja concluído e, em seguida, baixe a imagem composta.

curl -X POST https://api.muapi.ai/api/v1/ai-dress-change \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model_image_url": "https://example.com/model-photo.jpg",
    "garment_image_url": "https://example.com/garment-photo.jpg"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-dress-change",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "model_image_url": "https://example.com/model-photo.jpg",
        "garment_image_url": "https://example.com/garment-photo.jpg",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Perguntas frequentes