智能识图
更新时间:2026-04-14
概述
通过输入图片进行内容识别,并返回相似图片结果及其来源等相关信息。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/image_general |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | Bearer {ApiKey} |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | 非必填项(建议填写,方便后续链路问题排查,UUID格式) |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_b64 | string | 是 | 输入的图片,上传图片时需将其转换为 Base64 编码格式。 支持格式: jpeg/jpg, png, webp, tiff/tif, heic/heif, avif,推荐jpg其他格式有转换逻辑对耗时略有影响;图片最好小于800x800, 大小不超过100kb, 否则会引起下游异常 |
请求示例
Python
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/image_general \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'HOST: qianfan.baidubce.com' \
5 --header 'content-type: application/json' \
6 --data '{
7 "image_b64": ""
8}'
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| requestId | string | 请求ID |
| code | string | 成功码 0 |
| logid | string | 百度图搜侧请求ID |
| message | string | 异常消息 |
| data | SmartImageRecognitionData | 结果字段 |
SmartImageRecognitionData对象
| 字段 | 类型 | 说明 |
|---|---|---|
| query_context | QueryContext | 图片特征数据:意图、猜词、风控命中等 |
| rag_data | []RagData | rag数据:相似图 |
QueryContext对象
| 字段 | 类型 | 说明 |
|---|---|---|
| intervened | bool | 是否命中干预 |
| post_intention | []PostIntention | 图片意图/分类 |
| guesswords | []GuessWords | 图片识别/描述 |
| emoji_simi | EmojiSimilar | 表情相似结果 |
| cartoon | Cartoon | 卡通结果 |
| headpotrait | Headportrait | 情头结果 |
| plant | Plant | 植物结果 |
| imgface | Imgface | 名人信息 |
PostIntention对象
| 字段 | 类型 | 说明 |
|---|---|---|
| intention | string | 意图/分类,枚举值;表示图片的意图/,取值如下: question:题目识别 chars:文字识别 products:商品识别 imgface:图片中人脸 face:人脸识别 plant:植物识别 common:通用识别 animal:动物识别 products_chars:商品+文字联合识别 material_emoji:表情素材识别 material_sucai:素材内容识别 symbol: 水洗标识别 translate:翻译 health_report:健康报告解析 toy:玩具识别 red_wine:红酒识别 travel:旅游 / 景点识别 |
| rank | int32 | 排序 |
GuessWords对象
| 字段 | 类型 | 说明 | |
|---|---|---|---|
| word | string | 猜词 | |
| img_url | string | 猜词配图链接,与猜词一一对应 | |
| type | string | 猜词类别,枚举值; TYPE_SPOT = 1;//景点猜词 TYPE_VERT_ANIMAL = 2;//动物猜词 TYPE_VERT_PLANT = 3;//植物猜词 TYPE_BRANDLOGO = 4;//品牌猜词 TYPE_CUFENLEI_270 = 5;//粗分类词 TYPE_IDL_CAR = 6;//汽车猜词 TYPE_IDL_DISHES = 7;//美食猜词 TYPE_IMGFACE = 8;//名人 TYPE_PANO = 9;//通用精准猜词 TYPE_PRODUCTS = 10;//商品猜词 TYPE_SKINDISEASE = 11;//皮肤病猜词 TYPE_VIS_GUESSWORD = 12;//vis猜词 TYPE_MLLM_GUESSWORD = 13;//MLLM大模型猜词 |
|
| confidence | int32 | 猜词的置信度,1:髙置信 2:中置信 3:低置信 | |
| extend_brief | object | 摘要 | |
| +mllm_abstract | object |
生成摘要 | |
| +animal_abstract | object |
动物摘要 | |
| +plant_abstract | object |
植物摘要 | |
| +product_abstract | object |
商品摘要 | |
| +imgface_abstract | object |
人物摘要 | |
| +car_abstract | object |
汽车摘要 | |
| +health_skindisease_abstract | object |
皮肤病摘要 |
EmojiSimilar对象
| 字段 | 类型 | 说明 |
|---|---|---|
| result | array | 表情包列表 |
| +img_form | string | 图片来源 |
| +tag | string | 入库时携带的标记信息 |
| +contsign | string | 图片唯一标识id |
| +score | float32 | 相关性得分 |
Cartoon
| 字段名 | 字段类型 | 说明 |
|---|---|---|
| cartoon_data | array | 卡通结果 |
| +thumb_url | string | 缩略图 |
| +contsign | string | 图片唯一标识id |
HeadPortrait
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| portrait_data | array<object> | 情头结果 |
| +score | float32 | |
| +couple | object | 情侣头像信息 |
| +dist | float32 | |
| +score_local | float32 | |
| +score_couple | float32 | |
| +score_global | float32 | |
| +simi | object | 相似头像信息 |
Plant
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| refine_data | array | 植物精致化信息 |
| +name | string | 植物名称 |
| +identify_info | object | 植物叶片、根茎等器官信息 |
| +baike_info | object | baike信息,含有摘要和baike链接 |
| +maintain_info | object | 花百科植物信息 |
| +meitushare_info | object | 植物美图分享数据 |
Imgface
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| raw_data | string | 人物百科库返回的数据 |
| score | float32 | 人物库匹配的相似度得分 |
| query_info | object | query是人物猜词结果,rn默认值都是2 |
| item_extend_infos | object | 人物库匹配的相似度得分和置信度 |
RagData对象
| 字段 | 类型 | 说明 |
|---|---|---|
| search_results | list[SearchResultIte] | 相似图片列表 |
SearchResultItem
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| title | string | 标题 |
| thumburl | string | 缩略图链接 |
| fromurl | string | 来源网址链接 |
| content | string | fromurl网址对应的正文摘要 |
| objurl | string | 用户原图链接 |
| thumb_height | uint64 | 缩略图高度 |
| thumb_width | uint64 | 缩略图宽度 |
| item_cate | string | 类型(枚举值) |
| contsign | string | 图片key |
| site_name | string | 来源站点名 |
| update_time | uint64 | 网页收录时间,重复收录,该时间会更新 |
| item_brief | object | 相似缩略图集合 |
响应示例
YAML
1{
2 "code": "0",
3 "requestId": "",
4 "logid": "17290058",
5 "message": "success",
6 "data": {
7 "query_context": {
8 "intervened": false,
9 "post_intention": [
10 {
11 "intention": "imgface",
12 "rank": 1
13 }
14 ],
15 "cartoon": {
16 "cartoon_data": [
17 {
18 "contsign": "2781608142,61409165",
19 "thumburl": "http://mms1.baidu.com/it/u=776971250,3095373764&fm=253&app=120&f=JPEG?w=639&h=500"
20 },
21 {
22 "contsign": "744601141,1489704164",
23 "thumburl": "http://mms1.baidu.com/it/u=3427486439,502845629&fm=253&app=120&f=JPEG?w=500&h=625"
24 },
25 {
26 "contsign": "2213669395,260762703",
27 "thumburl": "http://mms1.baidu.com/it/u=4258896913,183508107&fm=253&app=138&f=JPEG?w=500&h=750"
28 }
29 ]
30 },
31 "imgface": {
32 "item_extend_infos": {
33 "confidence_type": 1,
34 "score": 0.9897292
35 },
36 "queryinfo": {
37 "query": "赵丽颖",
38 "rn": 2
39 },
40 "raw_data": "{\"data\":{\"name\":\"赵丽颖\"...}
41 "score": 0.9897292
42 }
43 },
44 "rag_data": {
45 "search_results": [
46 {
47 "content": "赵丽颖这次真听劝!短发再剪短齐下巴,网友:七八年前这发型她就玩剩下了,
48 "contsign": "2781608142,61409165",
49 "fromurl": "http://baijiahao.baidu.com/s?id=1861022486737332399&wfr=spider&for=pc",
50 "item_brief": {
51 "samesimi_brief": {
52 "is_deadlink": 0,
53 "text_host": "赵丽颖这次真听劝!短发再剪短齐下巴,网友:七八年前这发型她就玩剩下了"
54 }
55 },
56 "item_cate": "CATE_SAME",
57 "objurl": "http://t10.baidu.com/it/u=4005302212,292790382&fm=30&app=106&f=JPEG?w=640&h=501&s=839E81652E3207940C22518D03005088",
58 "site_name": "百家号",
59 "thumb_height": 500,
60 "thumb_width": 639,
61 "thumburl": "http://mms1.baidu.com/it/u=776971250,3095373764&fm=253&app=120&f=JPEG?w=639&h=500",
62 "title": "赵丽颖这次真听劝!短发再剪短齐下巴,网友:七八年前这发型她就玩剩下了",
63 "update_time": 1774809412000
64 }
65 ]
66 }
67 }
68}
异常响应
| 字段 | 类型 | 说明 |
|---|---|---|
| requestId | str | 请求ID |
| code | str | 0 表示成功,其他都是异常 |
| message | str | 错误消息 |
| detail | 异常详情信息 |
错误码定义
| code | message | 说明 |
|---|---|---|
| 0 | success | 成功 |
| 1001 | params illegal | 参数非法 |
| 1002 | app invalid | 无效的业务来源 |
| 1003 | token invalid | 权限校验错误 |
| 1004 | over limit | qps超限 |
| 1005 | default error | 无结果(默认错误) |
评价此篇文章
