AI MediaKit 电商万创（商品场景图生成）工具，能够基于您提供的商品图，通过 AI 技术智能生成高质量的背景与营销场景。该工具支持多种模式，满足不同业务需求： * **标准版**：使用预设模板快速出图。 * **专业版**：通过创意描述（Prompt）、参考图等方式进行自定义创作。 * **行业版**：专为汽车行业设计，支持棚拍风格的汽车场景图生成。本篇开发指南将引导您： * 通过一次 API 调用，快速体验为商品图生成一个全新的背景。 * 理解标准版、专业版与行业版的效果差异与适用场景。 ## 效果示例 |输入图 |生成示例结果 | |---|---| |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/de9be6d3926b411a87a4f41378de8dad~tplv-goo7wpa0wc-image.image) |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d094257229341579af09f3904e6c82e~tplv-goo7wpa0wc-image.image) | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7cfc3ccdc5844e178abca08d36d76d03~tplv-goo7wpa0wc-image.image) |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fb92937589ad467b83cae5426d6da961~tplv-goo7wpa0wc-image.image) | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/742dc81331444dd5ab733e9fa448f6b4~tplv-goo7wpa0wc-image.image) |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d0b48b8537cc4cafbae3066a06da91c1~tplv-goo7wpa0wc-image.image) | ## 快速体验：一键生成商品场景图电商万创是一个**同步任务**，您发起的请求会直接在响应中返回处理结果。 ### 准备工作 1. **获取访问凭证：** 在开始之前，请访问 AI MediaKit 控制台的 API Key 管理页面，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备图像文件：** 准备一张背景清晰、主体明确的商品图，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程您只需调用[提交电商万创（商品场景图生成）任务 API](https://www.volcengine.com/docs/6448/2522492)，即可在 API 的响应体中直接获取生成后的图片地址。 #### 步骤 1：提交任务并获取结果最简单的方式是使用**标准版**的预设场景。可直接复制以下 cURL 命令，替换其中的参数后在终端执行。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/generate-product-scene-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/product.png", "tool_version": "standard", "standard_scene": "exhibit_home", "batch_count": 4, "output_width": 600, "output_height": 600 }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

image_url：示例中已提供可直接用于测试的演示图片 URL。您也可以将其替换为您真实的商品图片地址。

示例中的 "standard_scene": "exhibit_home" 表示使用“居家展示”预设场景。详细列表请参见附录：标准版预设场景。

"batch_count": 4 表示最多生成 4 张商品场景图。

#### 步骤 2：查看响应由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 `result.images[0].image_url` 字段获取生成后图片的下载地址（有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-generate-product-scene-image-11796531458", "task_type": "generate-product-scene-image", "result": { "images": [ { "image_format": "png", "image_height": 600, "image_width": 600, "image_size": 411259, "image_url": "https://mediakit-image.cn-beijing.volces.com/tos-cn-i-mcagdqv95q/.../generated_image.png?sign=..." } // 根据请求的 batch_count，数组中可能包含多张图片 ] }, "expires_at": 1781697340, "request_id": "20260616195534BD8669B6807C72600EE2" } ``` ## 进阶使用 ### 模型版本说明电商万创提供标准版、专业版和行业版三个版本，在灵活度、效果和成本上均有不同。您可以通过 `tool_version` 参数进行选择。 |特性 |标准版 (`standard`) |专业版 (`professional`) |行业版 (`industry`) | |---|---|---|---| |**核心用法** |使用预设的场景模板 (`standard_scene`)，一键生成。 |使用自然语言描述 (`prompt`) 和参考图 (`professional_reference_image_url`)，进行高度自定义生成。 |专为汽车行业设计，可结合参考棚拍场景图 (`industry_scene_image_url`) 进行生成。 | |**适用场景** |适合需要快速、批量生成统一风格背景的场景，如商品白底图加背景。 |适合追求极致创意、需要生成特定风格或复杂场景的营销素材制作。 |适用于汽车的棚拍风格图片生成。 | |**创意描述** |仅在 `standard_scene` 为 `general` 时支持英文。 |必填，支持中文或英文。 |选填，支持中文或英文。 | |**自定义能力** |仅能选择预设场景。 |支持参考图、自定义商品位置等高级功能。 |支持参考棚拍场景图、参考细节图。 | |**成本** |较低 |较高 |较高 | ### **使用专业版自定义生成** 当 `tool_version` 设置为 `professional` 时，您需要同时使用以下参数来控制生成效果： * `prompt`：（必填）详细描述您想要的场景，支持中文或英文。例如：“香水瓶放在潮湿的青苔岩石上，背景是森林和瀑布，阳光穿过树叶，电影感”。 * `professional_reference_image_url`：（必填）提供一张背景风格参考图的 URL，模型将模仿其风格进行创作。 * `professional_reference_image_adapt_scale`：参考图的适配强度，数值越高，生成结果越接近参考图。取值范围 [0, 1]，默认为 0.9。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/generate-product-scene-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/product.png", "tool_version": "professional", "prompt": "将商品放置在浅色木质桌面上，背景为简洁明亮的室内家居场景，整体暖色调，突出商品主体，画面适合电商营销展示", "professional_reference_image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/reference-image.jpeg", "professional_reference_image_adapt_scale": 0.8 }' ``` ### 使用行业版生成汽车棚拍图当 `tool_version` 设置为 `industry` 时，您可以选择性传入 `prompt`、`industry_scene_image_url`（参考棚拍场景）和 `industry_detail_image_url`（车标/车牌等细节参考）来优化生成效果。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/generate-product-scene-image' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "image_url": "https://example.com/car.png", "tool_version": "industry", "prompt": "白色背景，演播室灯光，高分辨率", "output_width": 1920, "output_height": 1080, "product_ratio": 0.85 }' ``` ## 参考信息 ### 性能与限制 |限制项 |说明 | |---|---| |输入图像限制 |* 图像来源：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

* 文件大小：建议不超过 10MB，图片文件过大可能导致处理失败。

* 分辨率限制：

* 短边 ≥ 512 px

* 长边 ≤ 1024 px

* 支持格式：支持 `.png`、`.jpg`、`.jpeg`、`.webp` 等主流图像格式，不支持动图。 | |输出图像限制 |分辨率：宽度和高度均在 [512, 1024] 范围内。 | ### 费用说明电商万创（商品场景图生成）工具的费用根据成功生成的图片张数计算。系统会根据您任务中指定的模型版本（标准版、专业版、行业版），应用不同的计费系数。关于详细的计费规则、换算系数和计费示例，请参阅[图像工具计费](https://www.volcengine.com/docs/6448/2486470)。 ## 附录：标准版预设场景当 `tool_version` 为 `standard` 时，您可以通过 `standard_scene` 参数指定以下预设场景： |**场景名** |**描述** | |---|---| |general（默认值） |通用。取值为 general 时，必须配置 PositivePrompt 的取值，即用于生图的提示词。 | |natural_pasture |乡村牧场。 | |exhibit_home |家居桌面。 | |exhibit_simple |极简展台。 | |exhibit_kitchen |厨房餐桌。 | |exhibit_bathroom |洗漱桌面。 | |water_reflect |水面光影。 | |water_plants |水面植物。 | |exhibit_light |纯色光影。 | |water_ripples |水面波纹。 | |exhibit_luxury |奢华展台。 | |exhibit_modern |现代风景台。 | |exhibit_stone |植物岩石展台。 | |exhibit_forest |森林植物。 | |exhibit_floor |家居地面。 | |exhibit_toy |玩具展台。 | |exhibit_liquor |洋酒展台。 | |exhibit_wine |葡萄酒展台。 | |exhibit_beer |其他酒类展台。 | |glisten_dew |光台凝露。 | |spring_rock |晶屿谧芳。 | |dawn_silk |雾纱晨礼。 | |flower_rock |粉屿谧绽。 | |origem_drop |露屿青珀。 | |sunrise_bake |椰芝晨光。 | |sea_crunch |浪味鲜踪。 | |onyx_flow |墨带智音。 | |joy_pack |粉樱密语。 | |drug_moss |苔蕴健萃。 | |toy_mat |萌玩倚毯。 | |coast_nut |碧海果语。 | ## 相关 API 文档 * [提交电商万创（商品场景图生成）任务 API](https://www.volcengine.com/docs/6448/2522492)