商品撮影 API

商 とは？品撮影 API とは？

商品写真APIを使用すれば、シンプルな商品画像からスタイリングされたマーケティング用・カタログ用カットを簡単に制作できます。モデル撮影の手配やスタジオの予約なしで、モデルが商品を使用しているシーンをプロンプトから生成可能です。

MuapiはAI Product Photographyとしてこの機能を提供します。person_image_url、product_image_url、およびスタイルや環境を記述したpromptを受け取り、合成された結果を返します。単一のAPIキー、統一されたリクエスト/ポーリングフロー、従量課金制で利用できます。

商品撮影およびバーチャル試着的区别

これらは関連していますが異なる目的を持ちます。商品写真は人物に商品を合成し、プロンプトで指定した全く新しいシーンに配置します。目的はスタイリングされたマーケティング写真やライフスタイル写真の制作であり、背景や設定はプロンプトによって主導されます。一方、バーチャル試着は既存の人物写真をそのまま保持し、衣服のみを着せ替えることで特定の人物へのフィット感や着用イメージを可視化します。モデルと商品のイメージカットには商品写真API、衣服の着用確認にはバーチャル試着をご利用ください。 比较バーチャル試着 →

主要能力

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

• 鮮明で十分な光量のある人物写真を使用してください。 単一の被写体、自然なポーズ、適切なライティングの写真を使用することで、AIが商品を最も自然に合成するための正確な参照が得られます。
• 尽量分离产品。 背景干净、杂物较少的产品図，比在复杂场景中拍摄的产品更容易実現准确的形状和纹理迁移。
• プロンプトで具体的なディテールを指定してください。 背景、ライティング、全体の雰囲気を明示的に記述します。同じ2枚の入力画像であっても、柔らかな光の白背景スタジオとゴールデンアワーの屋外では全く異なる仕上がりになります。
• 预留迭代空间。 および所有生成式図像模型一样，每次运行的结果会有所不同。可以把第一次输出当作草稿，使用更准确的提示词或更干净的源図再次生成。

如何调用商品撮影 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())

よくある質問