使用 AIGC 获取商品卖点图--veImageX-火山引擎

文档中心

导航

使用 AIGC 获取商品卖点图

最近更新时间：2024.12.25 15:42:43首次发布时间：2024.05.24 16:12:10

通过文本描述或场景图引导的方式，使用 AIGC 智能算法对输入的商品主体图进行智能场景扩展，输出符合商品特点和大众美学，且场景自然的商品卖点图。

示例：

原图	商品图

使用说明

AIGC 商品图功能当前处于邀测阶段，如您有使用需求，请提交工单联系技术支持申请试用。

注意事项

请求频率限制：单用户请求频率限制为 5 次/秒。
超时时间：约为 20 秒。
格式限制：仅支持处理 png、jpeg、webp、heic 格式。
结果图字体格式：固定为思源黑体。
服务地址：veImageX 在全球多个区域部署，每个区域有自己对应的 OpenAPI 域名，不支持跨区域调用。具体详情请查看服务地址。

请求说明

请求方式：POST
请求地址：https://imagex.volcengineapi.com/?Action=GetProductAIGCResult&Version=2023-05-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数类型是否必选示例值描述

Action String 是 GetProductAIGCResult 接口名称。当前 API 的名称为 GetProductAIGCResult。

Version String 是 2023-05-01 接口版本。当前 API 的版本为 2023-05-01。

参数	类型	是否必选	示例值	描述
Action	String	是	`GetProductAIGCResult`	接口名称。当前 API 的名称为 `GetProductAIGCResult`。
Version	String	是	`2023-05-01`	接口版本。当前 API 的版本为 `2023-05-01`。
ServiceId	String	是	`8h**7j`	用于存储结果图和计量计费的服务 ID。您可以在veImageX 控制台服务管理页面，在创建好的图片服务中获取服务 ID。您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。

ServiceId

String

是

8h**7j

用于存储结果图和计量计费的服务 ID。

您可以在veImageX 控制台服务管理页面，在创建好的图片服务中获取服务 ID。
您也可以通过 OpenAPI 的方式获取服务 ID，具体请参考获取所有服务信息。

Body

参数	类型	是否必选	示例值	描述
Url	String	是	`http://test.com/demo.jpeg`	商品主体图的访问 URL（公网可访问）。建议为包含完整商品主体的白底图或透底图，尽量避免复杂背景的影响，以确保最终生成效果的质量。
NeedSeg	Boolean	否	`false`	是否使用分割处理图片，取值如下所示： `true`：分隔处理。 `false`：（默认）不分割处理，将从输入图像读取 alpha 通道作为商品图数据。注意指定为 `false` 时，确保通过 `Url` 传入的商品主体图是已经过分割的白底图或透底图。
BatchSize	Integer	否	`4`	每次生成的图片数量，取值范围为 [1,4]，默认值为 4。
OutputSize	Integer	是	`1`	同时指定结果图长和宽的值，单位为 px。取值范围为 [512,1024]。说明结果图是指定`BatchSize`张长宽比为 1:1 的方图。
Scene	String	否	`flower and leaves`	根据所选场景生成结果图，场景支持以下选项： `indoor wooden table`：室内木桌场景 `flower and leaves`：鲜花绿植场景 `white marble table`：白色大理石场景 `outdoor snow scene`：室外雪景场景 `supermarket show scene`：超市小件商品 `food in kitchen`：食品厨房场景 `sports style`：运动场景 `modern room`：现代室内提示词和 `Scene` 二选一必填，两者均存在时，以 `Scene` 为准。
NegativePrompt	String	否	`top view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face`	输入到 AIGC 模型的负向提示词，提示词和 `Scene` 二选一必填。两者均存在时，以 `Scene` 为准。当前仅支持英文，最多不超过 300 个字母。 `indoor wooden table` 场景下可采用的负向提示词为： `top view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `flower and leaves`场景下可采用的负向提示词为： `top view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `white marble table`场景下可采用的负向提示词为： `top view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `outdoor snow scene`场景下可采用的负向提示词为： `op view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `supermarket show scene`场景下可采用的负向提示词为： `top view, float things, extra connection, adjunct, appendages, stand, bracket, bad anatomy, text, word, grid, brown, grey, bubble, high saturation, sunlight, sun, stripe, spot, empty background, wheel, lowres, ugly, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `food in kitchen`场景下可采用的负向提示词为 `top view, float things, extra connection, adjunct, appendages, stand, bracket, bad anatomy, text, word, grid, brown, grey, bubble, high saturation, sunlight, sun, stripe, spot, empty background, wheel, lowres, ugly, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `sports style`场景下可采用的负向提示词为： `top view, float things, extra connection, adjunct, appendages, stand, bracket, bad anatomy, text, word, grid, brown, grey, bubble, high saturation, sunlight, sun, stripe, spot, empty background, wheel, lowres, ugly, bad hands, cropped, worst quality, baby, body, human, brand, bad face` `modern room`场景下可采用的负向提示词为： `top view, float things, extra connection, adjunct, appendages, stand, bracket, bad anatomy, text, word, grid, brown, grey, bubble, high saturation, sunlight, sun, stripe, spot, empty background, wheel, lowres, ugly, bad hands, cropped, worst quality, baby, body, human, brand, bad face`
PositivePrompt	String	否	`best quality, front view, standing on a circular platform, surrounded by flowers and leaves, sunlight from the right, product photography`	输入到 AIGC 模型的正向提示词，提示词和 `Scene` 二选一必填。两者均存在时，以 `Scene` 为准。当前仅支持英文，最多不超过 300 个字母。 `indoor wooden table` 场景下可采用的正向提示词为： `best quality, front view, standing on a wooden table close to window, some plants in the background, bright sunlight, product photography` `flower and leaves`场景下可采用的正向提示词为： `best quality, front view, standing on a circular platform, surrounded by flowers and leaves, sunlight from the right, product photography` `white marble table`场景下可采用的正向提示词为： `best quality, front view, standing on a white marble table in a living room, shallow depth of field, sunlight, shadows, product photography` `outdoor snow scene`场景下可采用的正向提示词为： `best quality, front view, standing on a pile of snow outdoors, with sky and mountains in the background, shallow depth of field, product photography` `supermarket show scene`场景下可采用的正向提示词为： `on a empty white table, kitchen, close to window, bright background, background blur, bright light, soft lighting, high quality` `food in kitchen`场景下可采用的正向提示词为 `on a empty table,in the kitchen,product picture, bright background, background blur, bright light, soft lighting, high quality` `sports style`场景下可采用的正向提示词为： `in a stadium, stadium in the background, sports style, product picture , bright light, soft lighting, high quality` `modern room`场景下可采用的正向提示词为： `in a modern room, fashion style, soft light, high resolution`
ProductRatio	Float	否	`0.6`	商品比例，即商品图的长宽与 `OutputSize` 指定的结果图长宽的比值上限。默认值为 0.6，取值范围为 (0,1)。取值越小，则商品图在生成的结果图中所占的大小越小。
UseCaption	Boolean	否	`false`	是否使用从商品图中提取的描述，取值如下所示： `true`：（默认）提取原图中商品的描述，和`PositivePrompt`共同作为输入到 AIGC 模型的正向提示词。 `false`：不使用。
ReturnTop1	Boolean	否	`false`	是否返回最高分生成图及其得分，取值如下所示： `true`：是，只返回最高分生成图及其得分。 `false`：（默认）否，返回所有生成图及其得分。
CX	Integer	否	`0`	设置商品放置的安全区中心坐标和宽高。取值需大于等于 `-1`，设为默认值 `-1` 时，商品自动居中，安全区为全图；否则需同时指定区安全区四个参数的值。
CY	Integer	否	`0`	设置商品放置的安全区中心坐标和宽高。取值需大于等于 `-1`，设为默认值 `-1` 时，商品自动居中，安全区为全图；否则需同时指定区安全区四个参数的值。
SafeH	Integer	否	`0`	设置商品放置的安全区中心坐标和宽高。取值需大于等于 `-1`，设为默认值 `-1` 时，商品自动居中，安全区为全图；否则需同时指定区安全区四个参数的值。
SafeW	Integer	否	`0`	设置商品放置的安全区中心坐标和宽高。取值需大于等于 `-1`，设为默认值 `-1` 时，商品自动居中，安全区为全图；否则需同时指定区安全区四个参数的值。
Extra	String	否	`-`	保留字段，用于传递商品 ID，类目 ID 信息。
SellingPointConfig	Object of SellingPointConfig	否	`-`	卖点图配置信息。
BackgroundOnly	Boolean	否	`true`	智能生成的结果图是否仅生成场景图（不包含商品主体），取值如下所示： `true`：（默认）是 `false`：否
ReturnBackgroundImage	Boolean	否	`true`	是否返回场景图，取值如下所示： `true`：（默认）是 `false`：否

SellingPointConfig

参数	类型	是否必选	示例值	描述
BackgroundUrl	String	否	`http://test.com/demo1.png`	指定的商品场景图访问 URL（公网可访问）。若为空，将采用`Scene` 或提示词智能生成的场景图。指定场景图时，若指定了任一方式的卖点信息，则在指定场景图渲染卖点文本。指定为空时，若指定了任一方式的卖点信息，则在 `Scene` 或提示词生成的场景图渲染卖点文本。
SellingPointRenderTemplate	String	否	`default`	卖点渲染模板，固定取值为 `default`。
SellingPointText	String	否	`美味\健康`	与 `SellingPointRenderTemplate` 搭配使用，视为方式 1。若同时配置方式 1 与方式 2，则方式 1 优先生效。卖点文本。填写方式为 "maidian1\nmaidian2\nmaidian3"或者"0.mdian1\n1.maindian2\n3.maiian"，支持中英文，每个卖点字符限制 5 个字符。
ProductDetailImages	Array of String	否	`["tos-cn-serviceid/example.jpg"]`	商详图（带有商品描述） URI/URL 列表，最大支持三张。指定 URI 时：需满足该图片时指定该服务下存储。指定 URL 时：满足公网可访问。
ProductDescription	String	否	`精选优质原料，只为用户放心`	与 `ProductDetailImages` 搭配使用，视为方式 2。若同时配置方式 1 与方式 2，则方式 1 优先生效。商详图中的商品卖点描述，支持中英文，不得超过 430 个字符。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
SellpointImages	Array of String	`["tos-cn-i-8h7j/89123238290"]`	生成的商品卖点图 URI 列表。排序规则为，当存在`SDScores > 0`的返回结果时，首个返回结果为`SDScores > 0`且总分(SDScores+AestheticScores)最高的结果图 URI，否则首个返回结果为`SDScores < 0`且总分最高的结果；其余结果按总分降序排序。
BackgroundImages	Array of String	`["tos-cn-i-8h7j/89126231276102"]`	商品场景图 URI 列表，未采用文字卖点。
AestheticScores	Array of Float	`[0.91, 0.83, 0.52, 0.61]`	商品场景图对应的美学得分，值越高表示图片越符合美学测评。
SDScores	Array of Float	`[0.35, 0.11, 0.04, -0.61]`	商品场景图与正向提示词的匹配度得分，值越高表示匹配度越高。
SellingPointText	String	`美味\健康`	卖点文本信息
SellingPointRenderTemplate	String	`default`	指定的卖点渲染模板
Extra	String	`id:987289220`	指定的商品信息

请求示例 1

使用文本描述智能生成场景图和卖点图，同时指定卖点图中展示的卖点信息。

POST https://imagex.volcengineapi.com/?Action=GetProductAIGCResult&Version=2023-05-01&ServiceId=8h**7j
{
    "Url": "http://test.com/demo.jpeg",
    "NeedSeg": true,
    "BatchSize": 4,
    "NegativePrompt": "top view, empty background, extra connection, wheel, stand, lowres, ugly, bad anatomy, bad hands, cropped, worst quality, baby, body, human, brand, bad face",
    "PositivePrompt": "best quality, front view, standing on a circular platform, surrounded by flowers and leaves, sunlight from the right, product photography",
    "ProductRatio": 0.6,
    "OutputSize": 800,
    "ReturnTop1": false,
    "Scene": "flower and leaves",
    "SellingPointConfig": {
        "SellingPointText": "美味\健康",
        "SellingPointRenderTemplate": "default"
    },
    "BackgroundOnly": false,
    "ReturnBackgroundImage": true
}

返回示例 1

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetProductAIGCResult",
        "Version": "2023-05-01",
        "Service": "ImageX",
        "Region": "cn-north-1"
    },
    "Result": {
        "SellpointImages": [
            "tos-cn-i-8h**7j/89123**238290"
        ],
        "AestheticScores": [
            0.91,
            0.83,
            0.52,
            0.61
        ],
        "SDScores": [
            0.35,
            0.11,
            0.04,
            -0.61
        ],
        "SellingPointText": "美味\健康",
        "BackgroundImages": [],
        "SellingPointRenderTemplate": "default",
        "Extra": ""
    }
}

请求示例 2

使用指定场景图生成卖点图。

POST https://imagex.volcengineapi.com/?Action=GetProductAIGCResult&Version=2023-05-01&ServiceId=8h**7j
{
    "Url": "http://test.com/demo.jpeg",
    "BatchSize": 4,
    "SellingPointConfig": {
        "BackgroundUrl": "http://test.com/demo1.png",
    },
    "BackgroundOnly": false,
    "ReturnBackgroundImage": true
}

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetProductAIGCResult",
        "Version": "2023-05-01",
        "Service": "ImageX",
        "Region": "cn-north-1"
    },
    "Result": {
        "SellpointImages": [
            "tos-cn-i-8h**7j/89123**238290"
        ],
        "AestheticScores": [
            0.91,
            0.83,
            0.52,
            0.61
        ],
        "SDScores": [
            0.35,
            0.11,
            0.04,
            -0.61
        ],
        "SellingPointText": "",
        "BackgroundImages": [],
        "SellingPointRenderTemplate": "",
        "Extra": ""
    }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码和 veImageX 错误码。