全部产品
阿里云办公

IndexTag

更新时间:2018-08-20 12:07:19

描述

检测相片的标签,并把获取的标签加入到指定数据集中。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String IndexTag
SetId String 数据集 ID
SrcUris String 数据源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。
以 JSON 字符串的方式表示,例如:
[“oss://bucket1/1.jpg”]
注意:当Force设置为1时,SrcUris只允许传入1张图片。
Force String SrcUri 已经在数据集中存在时,是否进行强制索引。
  • 1,表示强制索引
  • 0,表示存在时则不处理
默认值为0

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
SetId String 数据集 ID
SuccessDetails Array 成功详细信息SuccessDetail的数组
FailDetails Array 相片识别标签失败原因FailDetail的数组

成功识别详细信息SuccessDetail

名称 类型 描述
SrcUri String 相片源的存储位置
Tags Array 详细信息Tag的数组

失败识别详细信息FailDetail

名称 类型 描述
SrcUri String 相片源的存储位置
Reason String 失败原因

标签信息Tag

名称 类型 描述
TagId String 标签 ID
TagLevel String 标签级别,从1开始整数编码,1为顶级,2为次级,以此类推
TagName String 标签名称
ParentTagId String 上一级的 TagId,如果为顶级则 ParentTagId 为0
ParentTagName String 上一级的标签名称,如果为顶级由 ParentTagName 为空
TagScore String 标签置信度得分,小于等于1的浮点数

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com?Action=IndexTag
  2. &Project=test
  3. &SetId=3b461148-9457-483b-8acc-f487f118603a
  4. &SrcUris=["oss://bucket1/1.jpg"]
  5. ...

此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API。

成功返回示例

  1. {
  2. "SuccessDetail": [{
  3. "SrcUri": "oss://bucket1/1.jpg",
  4. "Tags": [
  5. {
  6. "TagId": "b4b147bc522828731f1a016bfa72c073",
  7. "TagLevel": "1",
  8. "ParentTagId": "0",
  9. "ParentTagName": "",
  10. "TagName": "人物",
  11. "TagScore": "1.000000"
  12. },
  13. {
  14. "TagId": "cfecdb276f634854f3ef915e2e980c31",
  15. "TagLevel": "1",
  16. "ParentTagId": "0",
  17. "ParentTagName": "",
  18. "TagName": "合影",
  19. "TagScore": "1.000000"
  20. }
  21. ]
  22. }],
  23. "FailDetail": []
  24. }