全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多

DetectTag标签检测

更新时间:2018-05-15 23:10:57

描述

检测相片的事物标签。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String DetectTag
SrcUris String 相片源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。
支持批量文件传入,一次最多支持10张相片,以 JSON 字符串的方式表示,例如:
[
“oss://bucket1/1.jpg”,
“oss://bucket1/2.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","oss://bucket1/2.jpg"]

成功返回示例

  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. "FailDetail": [{
  25. "SrcUri": "oss://bucket1/2.jpg",
  26. "Reason": "PhotoSizeTooLarge"
  27. }]
  28. }

特殊错误码

错误代码 错误信息 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
本文导读目录