智能商品搜索
更新时间：2026-01-06
概述
用户需上传图片并且输入对应的关键词，即可自动搜索相关商品详情，帮助快速完成商品信息收集。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/e_commerce/product_info_search |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | Bearer {ApiKey} |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项（建议填写，方便后续链路问题排查，UUID格式） |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| parameters | dict | 是 | 调用传参，具体见下文Parameters对象定义 |
Parameters对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| _sys_origin_query | string | 是 | 用户输入的图片URL和关键词，以“；”分隔，结构如下 示例： https://image-c.weimobwmc.com/ol-6NpxG/99962b4c9bb44bce86b2e247d005dd17.png；佳能 |
请求示例
Plain Text
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/e_commerce/product_info_search \
3 --header 'authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "parameters": {
7 "_sys_origin_query": "https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.png；男士领带"
8 }
9}'响应参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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，message。 |
| text | dict object | 是 | 代表当前 event 元素的内容，每一种 event 对应的 text 结构固定。 |
| event | dict | 是 | 标识返回内容的结构、顺序、状态，具体见下文Event对象定义。 |
text 对象定义
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| info | string | 是 | 对应商品文案的具体内容，数据格式根据type字段来决定，如果type是json ，这里就是json 字符串 |
Event对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 事件执行状态。 枚举值： preparing：运行中。 running：运行中。 error：错误。 done：执行完成。 |
| error_code | string | 否 | 错误码。 |
| error_message | string | 否 | 错误细节。 |
响应示例
Plain Text
1{
2 "code": "",
3 "message": "",
4 "status": "done",
5 "content": [
6 {
7 "type": "message",
8 "text": {
9 "info": "{\n\"picSearchItems\":\n[{'title': '男士7CM宽暗斜纹手打领的藏青黑色灰色青年百搭工作团队兄弟领呔', 'detail_url': 'https://item.taobao.com/item.htm?id=973620872477'}, {'title': '外贸纯原出口质量好纯色系列男商务正装正式手打领带结婚绅士9CM', 'detail_url': 'https://item.taobao.com/item.htm?id=732286208260'}, {'title': '千鸟格西装领带男士条纹8cm休闲领带咖色灰色墨绿色复古上班格子', 'detail_url': 'https://item.taobao.com/item.htm?id=794846981001'}, {'title': '【潘特维拉】cleanfit纯色领带人字纹 斜纹 手打领带jk个性领带', 'detail_url': 'https://item.taobao.com/item.htm?id=799772799831'}, {'title': '紫色领带深紫暗紫色方格圆点条纹花纹职业正装韩版手打拉链免打款', 'detail_url': 'https://item.taobao.com/item.htm?id=677151888891'}, {'title': '紫色领带深紫暗紫色方格圆点条纹花纹职业正装韩版手打拉链免打款', 'detail_url': 'https://item.taobao.com/item.htm?id=854207541525'}, {'title': 'jk纯色领带女手打懒人免打学生制服衬衫学士服 糖果色百搭ins灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=749054020090'}, {'title': '黑色领带男韩版休闲蓝色灰色潮拉链式懒人免打结上班西装领带', 'detail_url': 'https://item.taobao.com/item.htm?id=838133016645'}, {'title': '韩版纯色领带男手系休闲正装商务年轻窄版dk学院风黑色潮jk领带女', 'detail_url': 'https://item.taobao.com/item.htm?id=653921051206'}, {'title': '韩版纯色领带男手系休闲正装商务年轻窄版dk学院风黑色潮jk领带女', 'detail_url': 'https://item.taobao.com/item.htm?id=950868557859'}, {'title': '韩版纯色领带男手系休闲正装商务年轻窄版dk学院风黑色潮jk领带女', 'detail_url': 'https://item.taobao.com/item.htm?id=931769938737'}, {'title': '制服8cm男士商务正装领带条纹新郎结婚 免打拉链蓝灰红黑色青年潮', 'detail_url': 'https://item.taobao.com/item.htm?id=41094241595'}, {'title': '男韩版学生潮流百搭休闲领带5cm窄版青少年学生潮流小个性黑正装', 'detail_url': 'https://item.taobao.com/item.htm?id=540245681655'}, {'title': '千鸟格西装领带男纯色黑色灰色6cm休闲女蓝复古条纹百搭高档男士', 'detail_url': 'https://item.taobao.com/item.htm?id=653505686192'}, {'title': '质感6cm驼色领带无性别纯色咖色灰色休闲领带复古格子时尚秋冬', 'detail_url': 'https://item.taobao.com/item.htm?id=683735183266'}, {'title': '啄木鸟红色结婚领带男拉链新郎婚礼高端正装西装商务男士免打懒人', 'detail_url': 'https://item.taobao.com/item.htm?id=850770935278'}, {'title': '千鸟格西装领带男士纯色咖色灰色6cm休闲领带复古百搭上班格子女', 'detail_url': 'https://item.taobao.com/item.htm?id=934044850365'}, {'title': '深蓝色纯色领带男士商务正装职业工作8cm 韩版窄6cm黑学生礼盒装', 'detail_url': 'https://item.taobao.com/item.htm?id=663499747212'}, {'title': '纯单紫色领带男士韩版窄结婚新郎职业蓝色 手打拉链式懒人免打结', 'detail_url': 'https://item.taobao.com/item.htm?id=41996694074'}, {'title': '灰色领带男士正装商务窄版黑色手打韩版百搭学生面试深蓝领带6cm', 'detail_url': 'https://item.taobao.com/item.htm?id=729267767280'}, {'title': '绅柏仑领带男纯色黑色蓝色银色免打结商务休闲西装衬衫高级感手打', 'detail_url': 'https://item.taobao.com/item.htm?id=932266115241'}, {'title': 'HICHIN领带男纯色免打结商务休闲结婚西装衬衫高级感手打礼盒领带', 'detail_url': 'https://item.taobao.com/item.htm?id=995514125381'}, {'title': 'Rouhildy纯色领带男高端商务休闲免打结时尚手打职业装领带礼盒装', 'detail_url': 'https://item.taobao.com/item.htm?id=997090368929'}, {'title': '蓝色领带男正装商务拉链式结婚新郎免打男士手打黑色懒人免打结潮', 'detail_url': 'https://item.taobao.com/item.htm?id=643370472812'}, {'title': '包邮男士正装休闲商务窄版领带 纳米防水韩版英伦结婚礼盒领带潮', 'detail_url': 'https://item.taobao.com/item.htm?id=41878885422'}, {'title': '黑色拉链式懒人窄领带男正装商务韩版学院风结婚免打一拉得银灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=637334969386'}, {'title': '适派领 黑色免打领带男拉链式商务正装红色结婚蓝灰色易拉得懒人', 'detail_url': 'https://item.taobao.com/item.htm?id=544247735299'}, {'title': '男士商务正装领带黑色光面6cm 8cm职业休闲 新郎结婚韩版礼盒装潮', 'detail_url': 'https://item.taobao.com/item.htm?id=10657929515'}, {'title': '黑色拉链式懒人窄领带男正装商务韩版学院风结婚免打一拉得银灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=934630761945'}, {'title': '黑色拉链式懒人窄领带男正装商务韩版学院风结婚免打一拉得银灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=988290176105'}, {'title': '黑色拉链式懒人窄领带男正装商务韩版学院风结婚免打一拉得银灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=814415378623'}, {'title': '高档羊毛7~8cm懒人款免打结方便领带 男正装商务韩版休闲百搭拉链', 'detail_url': 'https://item.taobao.com/item.htm?id=636689217080'}, {'title': '黑色拉链式懒人窄领带男正装商务韩版学院风结婚免打一拉得银灰色', 'detail_url': 'https://item.taobao.com/item.htm?id=814274571732'}, {'title': 'wemi围觅纯色领带时尚百搭高智感领带手打彩色男女通用8公分', 'detail_url': 'https://item.taobao.com/item.htm?id=886195334420'}, {'title': '纯色领带男正装商务8公分工作结婚新郎黑色灰色咖色藏青色百搭潮', 'detail_url': 'https://item.taobao.com/item.htm?id=841977594629'}, {'title': '罗蒙高级男士领带高档结婚新郎免打结正装商务职业拉链式懒人蓝色', 'detail_url': 'https://item.taobao.com/item.htm?id=834125756174'}, {'title': 'wemi围觅纯色领带高级感小众手打彩色孔雀蓝紫色复古老钱风高智感', 'detail_url': 'https://item.taobao.com/item.htm?id=990283072799'}, {'title': '职业商务正装懒人拉链领带10cm宽行政黑色领带男士易拉得结婚红色', 'detail_url': 'https://item.taobao.com/item.htm?id=740357934673'}, {'title': '职业商务正装懒人拉链领带10cm宽行政黑色领带男士易拉得结婚红色', 'detail_url': 'https://item.taobao.com/item.htm?id=569956642367'}, {'title': 'fiinhaao品牌领带男10cm宽版大号商务正装西装职业易拉得拉链新郎', 'detail_url': 'https://item.taobao.com/item.htm?id=639692908255'}, {'title': '10cm宽男士拉链领带易拉得条纹商务职业正装方便懒人衬衫配饰', 'detail_url': 'https://item.taobao.com/item.htm?id=931874921438'}, {'title': '职业商务正装懒人拉链领带10cm宽行政黑色领带男士易拉得结婚红色', 'detail_url': 'https://item.taobao.com/item.htm?id=679996665290'}, {'title': '黑色蓝色正装商务手打深灰浅灰枣红上班结婚领带男', 'detail_url': 'https://item.taobao.com/item.htm?id=982198825161'}, {'title': '厂家现货仿丝亮面纯色领带男女 正装商务红色黑色领带手打款5/8cm', 'detail_url': 'https://item.taobao.com/item.htm?id=932402569286'}, {'title': '现货仿丝亮面纯色领带男女 正装商务红色黑色领带手打款5/8cm', 'detail_url': 'https://item.taobao.com/item.htm?id=842972401373'}, {'title': '男士领带 商务正装拉链款免打结蓝色红色结婚纯色亚光高级感手打', 'detail_url': 'https://item.taobao.com/item.htm?id=915212973153'}, {'title': '蓝色纯暗格纹黑领带男正装商务职业7cm新郎结婚韩版 拉链式免打结', 'detail_url': 'https://item.taobao.com/item.htm?id=581299861516'}, {'title': '男士手系领带正装商务8cm黑色职业英伦新郎结婚领带上班学生韩版', 'detail_url': 'https://item.taobao.com/item.htm?id=570696286078'}, {'title': '男士手系领带正装商务8cm黑色职业英伦新郎结婚领带上班学生韩版', 'detail_url': 'https://item.taobao.com/item.htm?id=976119982483'}, {'title': '黑色领带男潮衬衫装饰男女学院风休闲年轻细斜纹纯色韩版时尚5CM', 'detail_url': 'https://item.taobao.com/item.htm?id=740210811502'}, {'title': '男女拉链领带5CM衬衫正装职业韩版学院风日系男生懒人免打易拉得', 'detail_url': 'https://item.taobao.com/item.htm?id=810757164538'}, {'title': '黑色领带男潮衬衫装饰男女学院风休闲年轻细斜纹纯色韩版时尚5CM', 'detail_url': 'https://item.taobao.com/item.htm?id=977494988809'}, {'title': '黑色领带男 正装商务窄版酒红5CM职业结婚学生蓝色韩版纯色领带女', 'detail_url': 'https://item.taobao.com/item.htm?id=986306927159'}, {'title': '纯色领带男正装商务8公分工作结婚新郎白色灰色粉色红色紫色百搭', 'detail_url': 'https://item.taobao.com/item.htm?id=842285378666'}],\n\"keySearchItems\":\n[]\n}"
10 },
11 "event": {
12 "status": "running",
13 "error_code": "",
14 "error_message": ""
15 }
16 },
17 {
18 "type": "text",
19 "text": {
20 "info": ",\n商品卖点提取：\n\n商品有价值图片：\n\n接口状态：\n,normal,"
21 },
22 "event": {
23 "status": "done",
24 "error_code": "",
25 "error_message": ""
26 }
27 }
28 ],
29 "requestId": ""
30}异常响应
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| requestID | str | 是 | 请求ID |
| code | str | 否 | 0 表示成功，其他都是异常 |
| message | str | 否 | 错误消息 |
| detail | 否 | 异常详情信息 |