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

接口说明

该接口不依赖媒体集。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DetectImageTags

操作接口名称，固定取值为DetectImageTags。
ImageUri String 是 oss://imm-test/testcases/facetest.jpg

图片的OSS URI。

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

Project String 是 immimagetest

项目名称。
RegionId String 否 cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com，例如当RegionId为cn-hangzhou时，地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

返回数据

名称 类型 示例值 描述
ImageUri String oss://imm-test/testcases/facetest.jpg

图片的OSS URI。
RequestId String 91AC8C98-0F36-49D2-8290-742E24DF1F69

当次请求的Request ID。
Tags Array of Tags

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

当前版本不支持此参数。

父级标签英文名称。
ParentTagName String 人物

父级标签名称。
TagConfidence Float 0.9897482395172119

标签置信度。
TagEnName String face

当前版本不支持此参数。

标签英文名称。
TagLevel Integer 2

标签级别，取值范围为1~4。
TagName String 脸

标签名称。

示例

请求示例

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

正常返回示例

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 格式 

{
    "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
		}
    ]
}