API de fotografia de produto

O que é uma API de fotografia de produto?

Uma API de fotografia de produto transforma uma imagem simples de produto em uma foto estilizada de marketing ou catálogo – um modelo segurando ou usando o item, em um cenário de estúdio, cena de estilo de vida ou fundo criativo descrito por um prompt – sem reservar uma sessão de fotos, um estúdio ou um modelo.

Muapi expõe isso por meio de AI Product Photography, um endpoint único que pega person_image_url, product_image_url e prompt descrevendo o estilo ou configuração e retorna o resultado composto - uma chave de API, um fluxo de solicitação/pesquisa, preço pré-pago.

Fotografia do produto vs. teste virtual

Estas são intenções adjacentes, mas distintas. A fotografia de produto compõe um produto em uma pessoa e coloca ambos em uma nova cena descrita no prompt - o objetivo é uma foto estilizada de marketing ou estilo de vida, e o plano de fundo e o cenário são orientados pelo prompt. A prova virtual tira uma foto de uma pessoa existente e a troca por uma roupa diferente, mantendo a cena original - o objetivo é uma visualização do ajuste/aparência dessa pessoa específica. Use fotografia de produto para uma foto de estilo de vida de um produto com um modelo; use a prova virtual quando precisar mostrar como uma roupa fica em uma pessoa exata. Compare com o teste virtual →

Principais capacidades

Obtendo boas informações e resultados imediatos

• Use uma foto de pessoa nítida e bem iluminada. Um único assunto, pose neutra e boa iluminação dão ao modelo a referência mais limpa para compor o produto naturalmente.
• Isole o produto. Uma foto de produto limpa com o mínimo de desordem no fundo produz uma transferência de forma e textura mais precisa do que um produto fotografado em uma cena movimentada.
• Seja específico no prompt. Descreva explicitamente o plano de fundo, a iluminação e o clima. Um fundo branco de estúdio com iluminação suave e um estilo de vida ao ar livre filmado na hora dourada produzem resultados muito diferentes das mesmas duas imagens de entrada.
• 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 um prompt refinado ou uma imagem de origem mais limpa se a composição parecer errada.

Como chamar a API de fotografia de produto

1. Hospede ambas as imagens. Faça upload da foto da pessoa e da foto do produto via POST /api/v1/upload_file ou use qualquer URL acessível publicamente.
2. Envie a solicitação. Chame POST /api/v1/ai-product-photography com person_image_url, product_image_url e prompt.
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-product-photography \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "person_image_url": "https://example.com/model-photo.jpg",
    "product_image_url": "https://example.com/product-photo.jpg",
    "prompt": "Promoting brand in professional studio look"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/ai-product-photography",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "person_image_url": "https://example.com/model-photo.jpg",
        "product_image_url": "https://example.com/product-photo.jpg",
        "prompt": "Promoting brand in professional studio look",
    },
)
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