智能商品营销文案生成
更新时间：2025-10-27
概述
用户可利用商品图片识别卖点，结合商品基础信息来进行生动化的营销文案创作，支持多品类商品，可有效提升商品转换率。该组件为付费功能，具体计费说明请参见使用文档。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/e_commerce/generate_ad_content |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | 请求签名(Bearer <AppBuilder API Key>) |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数定义
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| stream | bool | 是 | 是否流式返回。可选值： true：流式。 false：非流式。 |
| parameters | dict | 是 | 调用传参，具体见下文Parameters对象定义 |
Parameters对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| category | string | 是 | 枚举类型，输入商品的品类，目前仅支持服装、食品、营养保健、家具百货、鞋、运动户外、美妆；请输入对应的唯一商品品类 |
| style | string | 是 | 文案创作风格和使用场景，目前支持包括：小红书笔记、朋友圈推广、商品使用测评 |
| product_info | string | 是 | 商品文本信息（包括全部的商品标题、价格等） |
| img | string[] | 是 | 图片url 数组，url 必须是可以下载的图片地址，最多可以输入10张图片 |
请求示例
curl --request POST \
--url https://qianfan.baidubce.com/v2/tools/e_commerce/generate_ad_content \
--header 'Authorization: Bearer xxxx' \
--header 'HOST: qianfan.baidubce.com' \
--header 'content-type: application/json' \
--data '{
"stream": false,
"parameters": {
"category": "食品",
"style": "小红书笔记",
"product_info": "100元以内的蛋糕",
"img": ["http://qianfan-modelbuilder-img-gen.bj.bcebos.com/irag-1.0/56db3ee88b9e4c4dad3294ba9ffe44a6/75a72be86f67459ba016e4e4e0f57c78/img-3beb4530-8d97-4449-79b8-27d51681d1fc.png?authorization=bce-auth-v1/50c8bb753dcb4e1d8646bb1ffefd3503/2025-08-04T06:45:41Z/86400/host/b0407f8d33a56ce7f165818d8420ba12cc4e62ad0a73819f51e92c8264b916ea"]
}
}'响应参数
正确响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求ID |
| code | string | 否 | 错误代码，当发生异常时返回 |
| message | string | 否 | 错误消息，当发生异常时返回 |
| status | string | 是 | 当前对话状态。 running:对话进行过程中。 done：对话结束。 error：执行过程发生错误。 interrupt：中断 |
| content | list[Content] | 否 | 当前组件返回内容的主要payload，List[Content]，每个 Content 包括了当前 event 的一个元素，具体见下文Content对象定义。 |
Content
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 代表event 类型。该字段的取值决定了下面text字段的内容结构。枚举值： text、json、code、files、urls、oral_text、references、image、chart、audio、function_call |
| text | dict object | 是 | 代表当前 event 元素的内容，每一种 event 对应的 text 结构固定。 |
| event | dict | 是 | 标识返回内容的结构、顺序、状态，具体见下文Event对象定义。 |
text
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | string | 是 | 对应商品文案的具体内容，数据格式根据type字段来决定，如果type是json ，这里就是json 字符串 |
Event
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 事件执行状态。枚举值： preparing：运行中。 running：运行中。 error：错误。 done：执行完成。 |
| error_code | string | 否 | 错误码。 |
| error_message | string | 否 | 错误细节。 |
异常情况
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| requestId | str | 是 | 请求ID |
| code | str | 否 | 0 表示成功，其他都是异常 |
| message | str | 否 | 错误消息 |
| detail | 否 | 异常详情信息 |
响应示例
{
"code": "",
"message": "",
"status": "done",
"content": [
{
"type": "json",
"text": {
"data": "{\"final\":\"生日派对必备！\\n超精美双层蛋糕，颜值爆表～\\n100元内搞定，性价比之王！\\n气球彩旗已备好，氛围感拉满～\\n赶紧下单，给生活加点甜！\"}"
},
"event": {
"status": "done",
"error_code": "",
"error_message": ""
}
}
],
"requestId": "3a590f9d-9ff9-47c7-acb9-c891d955b677"
}