物体识别

简介

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

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

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

官方交流一群：581197347

官方交流二群：705874401

官方交流三群：415349651

联系邮箱：aicamp@tencent.com

接口能力

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

协议须知

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

物体识别接口

1. 接口描述

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

2. 请求参数

3. 响应参数

4. 请求限制

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

5. 参考示例

假设示例请求数据如下。

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

下面使用PHP实现该HTTP API调用，其中getReqSign、doHttpPost可以从接口鉴权获取。

// 图片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_objectr';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果（注意使用UTF-8编码）：

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "topk": 5,
        "object_list": [
            {
                "label_id": 504,
                "label_confd": 0.65498
            },
            {
                "label_id": 968,
                "label_confd": 0.311948
            },
            {
                "label_id": 967,
                "label_confd": 0.0115941
            },
            {
                "label_id": 725,
                "label_confd": 0.00508999
            },
            {
                "label_id": 899,
                "label_confd": 0.00367005
            }
        ]
    }
}

6. 图片格式定义

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

7. 物体标识定义

更多物体识别能力正在开发中，并逐步开放，敬请期待！