图片标签 API

最近更新时间:2018-08-21 15:48:17

接口概述

服务简介

本接口用于识别图片内容信息,并以标签的形式显示。

计费说明

本接口按实际使用量计费,具体定价请查看 产品价格

url 说明

支持 HTTP 和 HTTPS 两种协议:

http://recognition.image.myqcloud.com/v1/detection/imagetag_detect

https://recognition.image.myqcloud.com/v1/detection/imagetag_detect

请求方式

请求头 header

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

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

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

请求参数

参数名 必选 类型 说明
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],数值越大置信度越高

实际示例

返回示例

{
    "code": 0,
    "message": "success",
    "tags": [
        {
            "tag_name": "天空",
            "tag_confidence": 27
        },
        {
            "tag_name": "女孩",

            "tag_confidence": 47
        }
    ]
}

错误码

错误码 含义
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 错误码请看 错误码说明

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >