全部产品
阿里云办公

DetectTag标签检测

更新时间:2018-08-22 14:07:54

描述

检测相片的事物标签。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String DetectTag
SrcUris String 相片源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。
以 JSON 字符串的方式表示,例如:
[ “oss://bucket1/1.jpg”]
目前,支持单次上传一张图片。

返回参数

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

成功识别详细信息SuccessDetail

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

标签信息Tag

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

失败识别详细信息FailDetail

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

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=DetectTag
  3. &Project=test
  4. &SrcUris=["oss://bucket1/1.jpg"]
  5. ...

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

成功返回示例

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

特殊错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidSrcUri The parameter SrcUri is not valid, it should be a valid URI format 400 相片的 URI 无效
PhotoBatchSizeTooLarge The request processing has failed due to PhotoBatchSize is too large 400 批量请求数量过大, 系统缺省设置为10
PhotoBatchSizeTooSmall The request processing has failed due to PhotoBatchSize is too small 400 批量请求数量过小, 系统缺省设置为1

若在使用中有疑问,请参考 FAQ,或者进入 钉钉用户群 实时交流。