图像标签(V2.0)
功能介绍
自然图像的语义内容非常丰富,一个图像包含多个标签内容,图像标签服务准确识别自然图片中数百种场景、上千种通用物体及其属性,让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加直观。使用时用户发送待处理图片,返回图片标签内容及相应置信度。
URI
URI格式
POST /v2/{project_id}/image/tagging
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
用户的project_id 登陆华为云 -> 用户中心 -> 我的凭证 -> api凭证 即可查看对应区域的项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
image |
否 |
String |
与url二选一。 图像数据,base64编码,要求base64编码后大小不超过10M,最短边至少15px,最长边最大4096px,支持JPG/PNG/BMP格式。 |
url |
否 |
String |
与image二选一。 图片的URL路径,目前支持:
说明:
|
language |
否 |
String |
zh:返回标签的语言类型为中文。 en:返回标签的语言类型为英文。 默认值为zh。 |
threshold |
否 |
Float |
置信度的阈值(0~100),低于此置信数的标签,将不会返回。 默认值:60 最小值:0 最大值:100 缺省值:0.0 |
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 |
Object |
目标检测框位置信息,包括4个值: width:检测框区域宽度。 height:检测框区域高度。 top_left_x:检测框左上角到垂直轴距离。 top_left_y:检测框左上角到水平轴距离。 |
confidence |
String |
检测标签置信度,将Float型置信度转为String类型返回,Float取值范围(0~100)。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- 方式一:使用图片的BASE64编码
POST https://{endpoint}/v2.0/image/tagging { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "language" : "zh", "limit" : 5, "threshold" : 70.0 }
- 方式二:使用图片URL
POST https://{endpoint}/v2.0/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 |
失败响应结果 |
错误码
请参见错误码。