场景识别

简介

HI,您好,欢迎使用腾讯AI开放平台图片识别API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述图片识别能力相关的技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

接口能力

接口名称 接口描述 API地址
场景识别 对图片进行场景识别,快速找出图片中包含的场景信息 https://api.ai.qq.com/fcgi-bin/vision/vision_scener

更多更强大的接口能力正在开发中,并逐步开放,敬请期待!

协议须知

调用方集成图片识别API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方法 POST
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式
接口鉴权 签名机制,详情请阅接口鉴权

场景识别接口

1. 接口描述

场景识别接口提供场景识别能力,可以帮您快速找出图片中包含的场景信息。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
format int 正整数 1 图片格式,定义见下文描述
topk int [1, 5] 1 返回结果个数(已按置信度倒排)
image string 原始图片的base64编码数据(解码后大小上限1MB) ... 待识别图片

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ topk int [1, 5]
+ scene_list array 场景列表
+ + label_id int 场景标识,定义见下文描述
+ + label_confd float 置信度

4. 请求限制

单用户单接口的QPS(每秒请求次数)上限如下,如需更多请联系QQ客服反馈。

未认证用户 个人认证用户 企业认证用户
1 2 10

5. 参考示例

假设示例请求数据如下。

参数名称 参数数据 描述
app_id 1000001 仅供参考
image 实时计算base64
topk 5 仅供参考
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf,示例图片文件存储路径为:/path/to/image

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 图片base64编码
$path   = '/path/to/image';
$data   = file_get_contents($path);
$base64 = base64_encode($data);

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'image'      => $base64,
    'topk'       => '5',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/vision/vision_scener';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "topk": 5,
        "scene_list": [
            {
                "label_id": 41,
                "label_confd": 0.356884
            },
            {
                "label_id": 202,
                "label_confd": 0.198071
            },
            {
                "label_id": 83,
                "label_confd": 0.19773
            },
            {
                "label_id": 249,
                "label_confd": 0.0745125
            },
            {
                "label_id": 28,
                "label_confd": 0.0324837
            }
        ]
    }
}

6. 图片格式定义

格式 描述
1 JPG格式(image/jpeg)

更多图片格式正在开发中,并逐步开放,敬请期待!

7. 场景标识定义

标识 描述 标识 描述 标识 描述 标识 描述 标识 描述
0 机场 60 肉店 120 栽培 180 垃圾填埋 240 索桥
1 机舱 61 巴特 121 野生的 181 降落甲板 241 废墟
2 机场航站楼 62 小屋内 122 场路 182 草坪 242 沙盒
3 胡同 63 自助餐厅 123 火灾逃生 183 图书馆室内 243 桑拿
4 游乐场 64 营地 124 消防站 184 灯塔 244 服务器机房
5 游乐园 65 校园 125 鱼塘 185 客厅 245 鞋店
6 公寓大楼外 66 自然的 126 室内跳蚤市场 186 大堂 246 大商场室内
7 水族馆 67 城市的 127 室内花店 187 更衣室 247 淋浴
8 渡槽 68 糖果店 128 美食广场 188 商店外面 248 滑雪度假村
9 游乐中心 69 峡谷 129 足球场 189 商店里面 249 天空
10 考古发掘 70 汽车内饰 130 阔叶 190 沼泽 250 摩天大楼
11 档案文件 71 旋转木马 131 森林的小路 191 武术馆 251 雪地
12 曲棍球 72 城堡 132 林道 192 252 足球场
13 性能 73 地下墓穴 133 正式的花园 193 清真寺外面 253 稳定的
14 牛仔竞技比赛 74 墓地 134 喷泉 194 254 棒球
15 陆军基地 75 化学实验室 135 厨房 195 山间小道 255 足球
16 艺术画廊 76 孩子的房间 136 车库内 196 山上的雪 256 室内舞台
17 艺术学校 77 礼堂内 137 车库外 197 电影院室内 257 户外舞台
18 艺术工作室 78 礼堂外 138 加油站 198 博物馆室内 258 楼梯
19 装配线 79 教室 139 外部 199 音乐工作室 259 街道
20 户外田径场地 80 悬崖 140 杂货店内 200 自然历史博物馆 260 地铁站台
21 阁楼 81 衣柜 141 礼品店 201 婴儿室 261 超市
22 大礼堂 82 服装店 142 冰川 202 海洋 262 寿司店
23 汽车厂 83 海岸 143 高尔夫球场 203 办公室 263 沼泽
24 汽车展厅 84 驾驶舱 144 温室内 204 办公隔间 264 游泳池
25 荒地 85 咖啡店 145 温室外 205 石油钻台 265 室内游泳池
26 商店 86 电脑室 146 石窟 206 操作室 266 户外游泳池
27 外部 87 会议室 147 体育馆内 207 果园 267 电视演播室
28 内部 88 施工现场 148 飞机棚内 208 乐池 268 亚洲
29 球坑 89 玉米田 149 飞机棚外 209 宝塔 269 王座室
30 舞厅 90 畜栏 150 210 宫殿 270 售票厅
31 竹林 91 走廊 151 五金店 211 食品贮藏室 271 修剪花园
32 银行金库 92 庭院 152 海菲尔德 212 公园 272
33 宴会厅 93 小溪 153 直升机场 213 室内停车场 273 玩具店
34 酒吧 94 决口 154 公路 214 停车场 274 列车内部
35 棒球场 95 人行横道 155 家庭办公室 215 牧场 275 火车站台
36 地下室 96 水坝 156 医院的房间 216 亭阁 276 林场
37 室内篮球场 97 熟食店 157 温泉 217 宠物店 277 树屋
38 浴室 98 百货商店 158 酒店外 218 药房 278 沟槽
39 室内市场 99 159 酒店房间 219 电话亭 279 苔原
40 户外市场 100 植被 160 房子 220 码头 280 海洋的深处
41 海滩 101 沙漠公路 161 冰淇淋店 221 比萨店 281 实用的房间
42 美容院 102 路边小饭店 162 浮冰 222 操场 282 山谷
43 卧室 103 餐厅 163 冰架 223 广场 283 植物园
44 泊位 104 餐厅 164 室内溜冰场 224 池塘 284 兽医办公室
45 生物学实验室 105 迪斯科舞厅 165 室外溜冰场 225 酒馆内 285 高架桥
46 木板路 106 宿舍 166 冰山 226 赛马场 286 村庄
47 船的甲板上 107 市中心 167 工业区 227 滚道 287 葡萄园
48 船屋 108 更衣室 168 胰岛 228 288 火山
49 书店 109 车道 169 浴缸里 229 铁路轨道 289 户外排球场
50 公用电话亭里面 110 药店 170 监狱 230 雨林 290 水上公园
51 植物园 111 171 日本花园 231 接待 291 水塔
52 室内的弓形窗 112 电梯大堂 172 珠宝店 232 娱乐室 292 瀑布
53 保龄球馆 113 电梯井 173 垃圾场 233 修理店 293 浇水洞
54 拳击台 114 发动机室 174 城堡 234 餐厅 294 波动
55 115 室内自动扶梯 175 狗屋外面 235 餐厅厨房 295 小麦田
56 建筑立面 116 开挖 176 幼儿园的教室 236 餐厅的露台 296 风电场
57 斗牛场 117 布艺店 177 厨房 237 稻田 297 院子
58 车内 118 农场 178 泻湖 238 298 禅园
59 公交车站内 119 快餐店 179 自然的 239 岩拱

更多场景识别能力正在开发中,并逐步开放,敬请期待!

AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点