功能介绍
自然图像的语义内容非常丰富，一个图像包含多个标签内容，图像标签服务准确识别 自然图片中数百种场景、上千种通用物体及其属性，让智能相册管理、照片检索和分 类、基于场景内容或者物体的广告推荐等功能更加直观。使用时用户发送待处理图 片，返回图片标签内容及相应置信度。
前提条件
● 在使用图像标签服务之前需要您完成服务申请和认证鉴权。
● 图像标签默认API调用最大并发为10，如需调整更高并发限制请联系华为专业工程 师为您服务。
调试
您可以在API Explorer中调试该接口。
URI
URI格式
POST /v2/{project_id}/image/tagging
表4-1 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 用户的project_id
登陆华为云 -> 用户中心 -> 我的凭证 ->
api凭证 即可查看对应区域的项目ID。
请求参数
表4-2 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户Token接口获取
（响应消息头中X-Subject-Token的值）。
表4-3 请求 Body 参数
参数 是否必选 参数类型 描述
image 否 String 与url二选一。
图像数据，base64编码，要求base64编码 后大小不超过10M，最短边至少15px，最 长边最大4096px，支持JPG/PNG/BMP格 式。
url 否 String 与image二选一。
图片的URL路径，目前支持：
● 公网HTTP/HTTPS URL
● OBS提供的URL，使用OBS数据需要进行 授权。包括对服务授权、临时授权、匿 名公开授权。详请参见配置OBS服务的
访问权限。
说明
● 接口响应时间依赖于图片的下载时间，如果 图片下载时间过长，会返回接口调用失败。
● 请保证被检测图片所在的存储服务稳定可 靠，推荐使用OBS服务存储图片数据。
● lmage不支持跨区域OBS，OBS的区域需要和 服务保持一致。
language 否 String zh：返回标签的语言类型为中文。
en：返回标签的语言类型为英文。
默认值为zh。
threshold 否 Float 置信度的阈值（0~100），低于此置信数的 标签，将不会返回。
默认值：60 最小值：0 最大值：100 缺省值：0.0
limit 否 Integer 最多返回的tag数，默认值： 50。
响应参数
状态码： 200
表4-4 响应 Body 参数
参数 参数类型 描述
result result object 调用成功时为图片标签内容。
调用失败时无此字段。
表4-5 result
参数 参数类型 描述
tags Array of ImageTaggin gItemBody objects
标签列表集合。
表4-6 ImageTaggingItemBody
参数 参数类型 描述
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 ImageTaggin gInstance objects
目标检测框信息，为空则表示没有目标检测框。
表4-7 i18n_tag
参数 参数类型 描述
zh String 中文标签 。
en String 英文标签。
表4-8 i18n_type
参数 参数类型 描述
zh String 中文标签类别。
en String 英文标签类别。
表4-9 ImageTaggingInstance
参数 参数类型 描述
bounding_box Object 目标检测框位置信息，包括4个值：
width：检测框区域宽度。
height：检测框区域高度。
top_left_x：检测框左上角到垂直轴距离。
top_left_y：检测框左上角到水平轴距离。
confidence String 检测标签置信度,将Float型置信度转为String类型 返回,Float取值范围（0~100）。
状态码： 400
表4-10 响应 Body 参数
参数 参数类型 描述
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 }
{ "error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 描述
200 成功响应结果
状态码 描述
400 失败响应结果
错误码
请参见错误码。