智能商品营销文案生成
更新时间：2025-09-05
概述
用户可利用商品图片识别卖点，结合商品基础信息来进行生动化的营销文案创作，支持多品类商品，可有效提升商品转换率
接口定义
| 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张图片 |
请求示例
Plain Text
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/e_commerce/generate_ad_content \
3 --header 'Authorization: Bearer xxxx' \
4 --header 'HOST: qianfan.baidubce.com' \
5 --header 'content-type: application/json' \
6 --data '{
7 "stream": false,
8 "parameters": {
9 "category": "食品",
10 "style": "小红书笔记",
11 "product_info": "100元以内的蛋糕",
12 "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"]
13 }
14}'响应参数
正确响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 | 否 | 异常详情信息 |
响应示例
Plain Text
1{
2 "code": "",
3 "message": "",
4 "status": "done",
5 "content": [
6 {
7 "type": "json",
8 "text": {
9 "data": "{\"final\":\"生日派对必备！\\n超精美双层蛋糕，颜值爆表～\\n100元内搞定，性价比之王！\\n气球彩旗已备好，氛围感拉满～\\n赶紧下单，给生活加点甜！\"}"
10 },
11 "event": {
12 "status": "done",
13 "error_code": "",
14 "error_message": ""
15 }
16 }
17 ],
18 "requestId": "3a590f9d-9ff9-47c7-acb9-c891d955b677"
19}