调用DetectImageTags接口检测图片中的标签信息。

接口说明

该接口不依赖媒体集。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 否 cn-hangzhou

项目所在地域的ID。

RegionId是Endpoint的标识和组成部分，用于构造请求示例中的Endpoint。Endpoint的格式为imm.${RegionId}.aliyuncs.com，例如当RegionId为cn-hangzhou时，Endpoint为imm.cn-hangzhou.aliyuncs.com。
Action String 是 DetectImageTags

操作接口名称，固定取值为DetectImageTags。
Project String 是 immimagetest

项目名称。
ImageUri String 是 oss://imm-test/testcases/facetest.jpg

图片的OSS URI。

OSS地址规则为oss://bucket/object，其中bucket为和当前项目处于同一区域的OSS Bucket名称，object为文件路径。

返回数据

名称 类型 示例值 描述
RequestId String 91AC8C98-0F36-49D2-8290-742E24DF1F69

当次请求的Request ID。
ImageUri String oss://imm-test/testcases/facetest.jpg

图片的OSS URI。
Tags Array of Tags

标签识别结果列表。
ParentTagEnName String person

当前版本不支持此参数。

父级标签英文名称。
TagName String 脸

标签名称。
TagConfidence Float 0.9897482395172119

标签置信度。
CentricScore Float 0

标签主体分数。用于提示该标签内容在图片中的主要程度，越高则说明该标签越可能为图片主体。取值范围为0~1。
TagEnName String face

当前版本不支持此参数。

标签英文名称。
TagLevel Integer 2

标签级别，取值范围为1~4。
ParentTagName String 人物

父级标签名称。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectImageTags
&ImageUri=oss://imm-test/testcases/facetest.jpg
&Project=immimagetest
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>91AC8C98-0F36-49D2-8290-742E24DF1F69</RequestId>
<ImageUri>oss://imm-test/testcases/facetest.jpg</ImageUri>
<Tags>
    <TagName>脸</TagName>
    <TagConfidence>0.9897482395172119</TagConfidence>
    <TagLevel>2</TagLevel>
    <ParentTagName>人物</ParentTagName>
</Tags>
<Tags>
    <TagName>人物</TagName>
    <TagConfidence>0.9897482395172119</TagConfidence>
    <TagLevel>1</TagLevel>
</Tags>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "91AC8C98-0F36-49D2-8290-742E24DF1F69",
  "ImageUri" : "oss://imm-test/testcases/facetest.jpg",
  "Tags" : [ {
    "TagName" : "脸",
    "TagConfidence" : "0.9897482395172119",
    "TagLevel" : 2,
    "ParentTagName" : "人物"
  }, {
    "TagName" : "人物",
    "TagConfidence" : "0.9897482395172119",
    "TagLevel" : 1
  } ]
}