商品撮影 API

什么是商品撮影 API？

商品撮影 API 可以将普通产品图转换为经过设计的营销或目录图片：让模特手持或使用产品，并将其放置在由提示词描述的影棚、生活方式或创意背景中，无需预约摄影、影棚或模特。

Muapi 通过 AI 商品撮影提供这一能力。单一端点接收 person_image_url、product_image_url 和描述风格或场景的 prompt，返回合成结果。你只需一个 API 密钥，使用统一的提交与轮询流程，并按生成次数付费。

商品撮影与バーチャル試着的区别

两者相关但用途不同。商品撮影会把产品合成到人物身上，并根据提示词重新设计整个场景，目标是制作风格化的营销或生活方式图片。バーチャル試着则是在现有人物照片中替换服装，同时保留原有场景，目标是展示特定人物的穿着效果。如果你需要为产品生成带模特的生活方式图片，请使用商品撮影；如果你需要展示某件衣服穿在特定人物身上的样子，请使用バーチャル試着。 比较バーチャル試着 →

主要能力

如何获得更好的输入和提示词结果

• 使用清晰、光线良好的人物照片。 单一主体、中性姿势和充足光线能为模型提供更干净的参考，使产品更自然地合成到人物身上。
• 尽量分离产品。 背景干净、杂物较少的产品图，比在复杂场景中拍摄的产品更容易实现准确的形状和纹理迁移。
• 在提示词中说明细节。 明确描述背景、光线和氛围。同样的两张输入图，在白色影棚柔光和户外黄金时段生活方式场景下会产生完全不同的结果。
• 预留迭代空间。 与所有生成式图像模型一样，每次运行的结果会有所不同。可以把第一次输出当作草稿，使用更准确的提示词或更干净的源图再次生成。

如何调用商品撮影 API

1. 准备两张图片。 通过 POST /api/v1/upload_file 上传人物照片和产品照片，也可以使用任何公开可访问的 URL。
2. 提交请求。 调用 POST /api/v1/ai-product-photography，并提供 person_image_url、product_image_url 和 prompt。
3. 轮询任务完成。 持续检查 GET /api/v1/predictions/{request_id}/result，直到 status 为 completed，然后下载合成图。

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())

よくある質問