调用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
		}
    ]
}