图片分析 API

说明：

本文档是旧版图像标签文档，图像标签已经升级为使用更先进的深度学习技术、覆盖范围更广的图像分析- 图像标签 服务，支持8个大类、六十多个二级分类、数千个标签，涵盖各种场景、事件、日常物品、动物、证件文档等。
建议使用新版，开通方法详见 图像分析入门 。旧版图像标签在2019年内会继续提供稳定的服务，但不会进行算法升级。

接口描述

接口请求域名：https://recognition.image.myqcloud.com/v1/detection/imagetag_detect
本接口（imagetag_detect）用于识别图片内容信息，并以标签的形式显示。

注意：

本接口支持 HTTPS 协议，如果您现在使用的是 HTTP 协议，为了保障您的数据安全，请切换至 HTTPS。

请求头 header

注意：

如果选择 multipart/form-data，请使用 HTTP 框架/库推荐的方式，设置请求的 contenttype，不推荐直接调用 setheader 等方法进行设置，否则可能导致由于 boundary 缺失引起的请求失败。

所有请求都要求含有以下头部信息：

参数名	必选	值	描述
host	是	recognition.image.myqcloud.com	腾讯云图片分析服务器域名。
content-length	否	包体总长度	整个请求包体内容的总长度，单位：字节（Byte）。
content-type	是	application/json 或 multipart/form-data	根据不同接口选择： 1. 使用图片 url，选择 application/json。 2. 使用图片文件，选择 multipart/form-data。
authorization	是	鉴权签名	多次有效签名，用于鉴权，生成方式见 鉴权签名方法。

输入参数

参数名	必选	类型	说明
appid	是	String	接入项目的唯一标识，可在 账号信息 或 云 API 密钥 中查看。
image	否	String	图像 Base64 编码，图像格式为 JPG/PNG/BMP 其中之一。
url	否	String	可下载的图片 url。如果 url 和 image 都提供，仅使用 url。

输出参数

字段	类型	说明
code	Int	错误码，0为成功。
message	String	服务器返回的信息。
tags	ImageTag	图像的分类标签列表，具体内容如下表。

其中 ImageTag 具体内容为：

字段	类型	说明
tag_name	String	返回的图像分析名字。
tag_confidence	Int	图像分析的置信度，取值范围[0， 100]，数值越大置信度越高。

示例

输入示例

POST /v1/detection/imagetag_detect HTTP/1.1
Host: recognition.image.myqcloud.com
Content-Type: application/json
authorization: WrE/BkJAorkCm0gg3/GKdVttlqVhPTEyNTcyMzc1MTEmaz1BS0lEZVE0WnN5b2I3MHl3b0Y4aWpaRGo1SUo4YnpCSGZ1UWsmZT0xNTUwOTEzMTkwJnQ9MTU0ODMyMTE5MCZyPTE4MDQyODkzODM=
cache-control: no-cache

{
    "appid": "1234567890",
    "image": "图片的base64"
}

输出示例

{
    "code": 0,
    "message": "success",
    "tags": [
        {
            "tag_name": "大头照",
            "tag_confidence": 18
        },
        {
            "tag_name": "女孩",
            "tag_confidence": 65
        },
        {
            "tag_name": "海报",
            "tag_confidence": 12
        }
    ]
}

错误码

错误码	含义
3	错误的请求；其中 message:account abnormal,errorno is:2 为账号欠费停服
4	签名为空
5	签名串错误
6	APPID/存储桶/url 不匹配
7	签名编码失败（内部错误）
8	签名解码失败（内部错误）
9	签名过期
10	APPID 不存在
11	SecretId 不存在
12	APPID 不匹配
13	重放攻击
14	签名失败
15	操作太频繁，触发频控
16	内部错误
17	未知错误
200	内部打包失败
201	内部解包失败
202	内部链接失败
203	内部处理超时
-1300	图片为空
-1308	url 图片下载失败
-1400	非法的图片格式
-1403	图片下载失败
-1404	图片无法识别
-1505	url 格式不对
-1506	图片下载超时
-1507	无法访问 url 对应的图片服务器
-5062	url 对应的图片已被标注为不良图片，无法访问（专指存储于腾讯云的图片）

更多其他 API 错误码请查看 错误码说明 。