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_MediaKit_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_MediaKit_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`) | |---|---|---| |核心用法 |使用预设的场景模板 (`standard_scene`)，一键生成。 |使用自然语言描述 (`prompt`) 和参考图 (`professional_reference_image_url`)，进行高度自定义生成。 | |适用场景 |适合需要快速、批量生成统一风格背景的场景，如商品白底图加背景。 |适合追求极致创意、需要生成特定风格或复杂场景的营销素材制作。 | |创意描述 |不支持或仅支持英文（当 `standard_scene` 为 `general` 时）。 |支持中文或英文。 | |自定义能力 |仅能选择预设场景。 |支持参考图、自定义商品位置等高级功能。 | |成本 |较低 |较高 | ### **使用专业版自定义生成** 当 `tool_version` 设置为 `professional` 时，您可以使用以下参数组合来控制生成效果： * `prompt`：（必填）详细描述您想要的场景，支持中文或英文。例如：“香水瓶放在潮湿的青苔岩石上，背景是森林和瀑布，阳光穿过树叶，电影感”。 * `professional_reference_image_url`：（必填）提供一张背景风格参考图的 URL，模型将模仿其风格进行创作。 * `professional_reference_image_adapt_scale`：参考图的适配强度，数值越高，生成结果越接近参考图。取值范围 [0, 1]，默认为 0.9。 #### 请求示例：使用 Prompt 和参考图 ```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_MediaKit_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 }' ``` ## 参考信息 ### 性能与限制 |限制项 |说明 | |---|---| |**输入图像限制** |* 图像来源：必须为公网可访问的 HTTP 或 HTTPS URL。

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

* 分辨率限制：

* 短边 ≥ 512 px

* 长边 ≤ 1024 px

* 支持格式：支持 `.png`、`.jpg`、`.jpeg`、`.webp` 等主流图像格式，不支持动图。 | |**输出图像限制** |分辨率：宽度和高度均在 [512, 1024] 范围内。 | ## 附录：标准版预设场景当 `tool_version` 为 `standard` 时，您可以通过 `standard_scene` 参数指定以下预设场景： |场景 ID |描述 |场景 ID |描述 | |---|---|---|---| |`general` |通用场景 |`exhibit_wine` |红酒场景 | |`natural_pasture` |自然牧场 |`exhibit_beer` |啤酒场景 | |`exhibit_home` |居家展示 |`glisten_dew` |露珠闪耀 | |`exhibit_simple` |简约展示 |`spring_rock` |春日岩石 | |`exhibit_kitchen` |厨房环境 |`dawn_silk` |晨曦丝绸 | |`exhibit_bathroom` |浴室环境 |`flower_rock` |花与岩石 | |`water_reflect` |水面倒影 |`origem_drop` |起源水滴 | |`water_plants` |水生植物 |`sunrise_bake` |日出烘焙 | |`exhibit_light` |光影展示 |`sea_crunch` |海盐脆片 | |`water_ripples` |水面涟漪 |`onyx_flow` |玛瑙流光 | |`exhibit_luxury` |奢华展示 |`joy_pack` |趣味包装 | |`exhibit_modern` |现代展示 |`drug_moss` |药妆苔藓 | |`exhibit_stone` |岩石基座 |`toy_mat` |玩具地垫 | |`exhibit_forest` |森林环境 |`coast_nut` |海岸坚果 | |`exhibit_floor` |地板/台面 | | | |`exhibit_toy` |玩具场景 | | | |`exhibit_liquor` |白酒/烈酒场景 | | | ## 相关 API 文档 * [提交电商万创任务 API](https://www.volcengine.com/docs/6448/2522492)

智能处理