图像标签（V2）
功能介绍
自然图像的语义内容非常丰富，一个图像包含多个标签内容，图像标签服务准确识别自然图片中数百种场景、上千种通用物体及其属性，让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加直观。使用时用户发送待处理图片，返回图像标签内容及相应置信度。
URI
URI格式
POST /v2/{project_id}/image/tagging
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
用户的项目ID。登录用户中心 -> 我的凭证 -> api凭证 即可查看对应区域的项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
image |
否 |
String |
与url二选一。 图像数据，base64编码，要求base64编码后大小不超过10M，最短边至少1px，最长边最大4096px，支持JPEG/PNG/BMP/WEBP格式。 |
|
url |
否 |
String |
与image二选一。 图片的URL路径，目前支持：
说明：
|
|
language |
否 |
String |
zh：返回标签的语言类型为中文。 en：返回标签的语言类型为英文。 默认值为zh。 |
|
threshold |
否 |
Float |
置信度的阈值（0~100），低于此置信数的标签，将不会返回。 默认值：60 最小值：0 最大值：100 |
|
limit |
否 |
Integer |
最多返回的tag数（取值范围：1-150）。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
调用成功时为图像标签内容。 调用失败时无此字段。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
confidence |
String |
置信度，将Float型置信度转为String类型返回，取值范围：0-100。 |
|
type |
String |
标签的类别。有以下三种类别： object：实体标签 scene：场景标签 concept：概念标签 |
|
tag |
String |
标签名称。 |
|
i18n_tag |
i18n_tag object |
标签的多种语言输出。 |
|
i18n_type |
i18n_type object |
标签类别的多种语言输出。 |
|
instances |
Array of ImageTaggingInstance objects |
目标检测框信息，为空则表示没有目标检测框。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
bounding_box |
BoundingBoxFloat Object |
目标检测框位置信息。 |
|
confidence |
String |
检测标签置信度，将Float型置信度转为String类型返回，Float取值范围（0~100）。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
width |
Double |
检测框区域宽度。 |
|
height |
Double |
检测框区域高度。 |
|
top_left_x |
Double |
检测框左上角到垂直轴距离。 |
|
top_left_y |
Double |
检测框左上角到水平轴距离。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
|
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- 方式一：使用图片的BASE64编码，对待处理图片返回图像标签内容及相应置信度，返回标签的语言类型为中文，置信度的阈值为70。
POST https://{endpoint}/v2/{project_id}/image/tagging { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "language" : "zh", "limit" : 5, "threshold" : 70.0 } - 方式二：使用图片URL，对待处理图片返回图像标签内容及相应置信度，返回标签的语言类型为中文，置信度的阈值为70。
POST https://{endpoint}/v2/{project_id}/image/tagging { "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "language" : "zh", "limit" : 5, "threshold" : 70.0 }
响应示例
状态码： 200
成功响应结果
{
"result" : {
"tags" : [ {
"confidence" : "37.51",
"instances" : [ {
"confidence" : "92.38",
"bounding_box" : {
"height" : 133.32496056189905,
"top_left_x" : 53.134917332575874,
"top_left_y" : 254.21347984900842,
"width" : 117.5866567171537
}
} ],
"tag" : "人",
"i18n_tag" : {
"en" : "person",
"zh" : "人"
},
"type" : "人类",
"i18n_type" : {
"en" : "Human",
"zh" : "人类"
}
} ]
}
}
状态码： 400
失败响应结果
{
"error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
成功响应结果。 |
|
400 |
失败响应结果。 |
错误码
请参见错误码。
