商品生动化标题生成
更新时间：2025-09-04
概述
通过商品图片和基本信息，利用多模态模型识别图片卖点结合ai搜索的多元信息来生成生动化的标题，支持全品类商品，可有效提高商品点击率
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/e_commerce/generate_titles |
|---|---|
| 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对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| full_product_name | string | 是 | 完整的的商品标题 |
| num | string | 否 | 推荐输入：商品的实际货号，增加搜索信源准确性 |
| img | string[] | 否 | 可一次性输入所有商品图片的url。（建议10张以内） 注意：务必按照格式输入！ ---输入示例--- ["https://aaa.jpg", "https://bbb.jpg"] |
请求示例
curl --request POST \
--url https://qianfan.baidubce.com/v2/tools/e_commerce/generate_titles \
--header 'Authorization: Bearer xxxx' \
--header 'HOST: qianfan.baidubce.com' \
--header 'content-type: application/json' \
--data '{
"stream": false,
"parameters": {
"full_product_name": "金皇冠蛋糕",
"img": ["https://qianfan-modelbuilder-img-gen.bj.bcebos.com/cake.png"]
}
}'响应参数
正确响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 |
| name | string | 是 | 介绍当前yield内容的step name。 |
| 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": "{\"result\": "商品生动化标题",\"search\":[],\"result_1\":null}"
},
"event": {
"status": "done",
"error_code": "",
"error_message": ""
}
}
],
"requestId": ""
}