文档

IndexImage - 将图片加入媒体集

更新时间:

将图片加入媒体集,并进行AI检测。

接口说明

  • 此接口已不再维护,建议使用新版(2020-09-30 版本)接口 IndexFileMeta 。关于新版与旧版 API 的对比,请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。
  • IndexImage 对图片的处理为异步方式,您可以通过 GetImage 接口获取通过各个引擎处理该图片的结果,该结果通常能在数秒内完成。
  • ImageUri 作为图片的唯一标识,不能重复。如果 ImageUri 指向的 OSS 路径中的图片未变化,可以重复调用 IndexImage 接口重试处理图片失败的引擎。
  • 引擎包括标签识别人脸检测识别

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Projectstring

项目名称。

immimagetest
SetIdstring

媒体集的唯一标识。

set001
ImageUristring

图片的 OSS URI。

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

oss://imm-test/testcases/face1.jpg
RemarksAstring

标记信息,为使用者预留的筛选参数,用于记录所需要的信息。

在搜索等场景下,您可以以前缀匹配的方式将设置的值作为搜索条件,样例场景如下:

  • 作为客户端权限字段存入,例如 AdminGroup/AdminUserA/,即可使用前缀过滤用户权限。
  • 作为客户端的相对路径存入,例如 nas://path/to/file。
AdminGroup/AdminUserA/
RemarksBstring

标记信息,为使用者预留的筛选参数,用于记录所需要的信息。

在搜索等场景下,您可以以前缀匹配的方式将设置的值作为搜索条件,样例场景如下:

  • 作为客户端权限字段存入,例如 AdminGroup/AdminUserA/,即可使用前缀过滤用户权限。
  • 作为客户端的相对路径存入,例如 nas://path/to/file。
nas://path/to/file
SourceTypestring

源数据的类型,包括如下选项:

  • image:源数据类型为图片。
  • video:源数据类型为视频。
image
SourceUristring

图片的 OSS URI。

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

oss://imm-test/testcases/face1.jpg
SourcePositionstring

只有当 SourceType 为 video 时,此参数才生效。

视频中该图片帧处于源视频的时间轴位置。格式为"00000000.010",即%8.3f。

00000000.010
RemarksCstring

标记信息,为使用者预留的筛选参数,用于记录所需要的信息。

在搜索等场景下,您可以以前缀匹配的方式将设置的值作为搜索条件,样例场景如下:

  • 作为客户端权限字段存入,例如 AdminGroup/AdminUserA/,即可使用前缀过滤用户权限。
  • 作为客户端的相对路径存入,例如 nas://path/to/file。
remarkc
RemarksDstring

标记信息,为使用者预留的筛选参数,用于记录所需要的信息。

在搜索等场景下,您可以以前缀匹配的方式将设置的值作为搜索条件,样例场景如下:

  • 作为客户端权限字段存入,例如 AdminGroup/AdminUserA/,即可使用前缀过滤用户权限。
  • 作为客户端的相对路径存入,例如 nas://path/to/file。
remarkd
ExternalIdstring

外部 ID,用于和您的应用层的 ID(如果有)进行绑定。

externalId001
NotifyEndpointstring

异步反向通知的 Endpoint,图片处理结果可以通过该 Endpoint 异步通知给调用者。使用此功能需要先开通 MNS 服务,新建 topic 和 queue,并配置订阅关系。具体操作,请参见消息服务 MNS 快速入门概述

说明 MNS 服务和智能媒体管理必须处于同一地域。
http://1111111111.mns.cn-hangzhou.aliyuncs.com
NotifyTopicNamestring

异步反向通知的 TopicName。

topic2
RemarksArrayAstring

标记信息列表,格式为数组。

["remarka1","remarka2"]
RemarksArrayBstring

标记信息列表,格式为数组。

["remarkb1","remarkb2"]

MNS 通知

请求参数中如果设置了 NotifyTopicName 和 NotifyEndpoint 支持 MNS 事件通知,则智能媒体管理会为您返回异步通知。通知的消息格式为:

{
   "eventName": "IndexImageTask",
   "eventSource": "acs:imm",
   "eventTime": "2019-09-03T02:20:50.529Z",
   "eventVersion": "1.0",
   "imm": {
      "ImageUri": "oss://imm-test/testcases/test.jpg",
      "Project": "PhotoTest",
      "RequestId": "4D3950B2-AB3D-4F06-BDF0-271022DA552C",
      "SetId": "test-set",
      "Success": "true"
   }
}

MNS 通知返回参数说明请参见下表。

名称类型描述
eventNameString任务类型,返回为固定值 IndexImageTask。
imm.ImageUriString源数据的 OSS URI。
imm.SetIdString媒体集的唯一标识。
imm.ProjectString项目名称。
imm.RequestIdString当次请求的 Request ID。
imm.SuccessString执行是否成功。取值为 true 或 false。

返回参数

名称类型描述示例值
object
RemarksArrayBstring

标记信息列表。

如果请求时未设置此参数,则返回值为空。

["remarkb1","remarkb2"]
ModifyTimestring

图片的修改时间。

添加图片后,如果未修改过图片,则图片的修改时间和图片的创建时间相同。

2020-11-24T10:56:52.461Z
RemarksCstring

标记信息。

如果请求时未设置此参数,则返回值为空。

remarkc
RemarksDstring

标记信息。

如果请求时未设置此参数,则返回值为空。

remarkd
RequestIdstring

当次请求的 Request ID。

144A2D4C-12D5-46D6-BEC9-9AAEE1F10C25
CreateTimestring

图片加入媒体集的时间。

2020-11-24T10:56:52.461Z
ExternalIdstring

外部 ID,用于和您的应用层的 ID(如果有)进行绑定。

如果请求时未设置此参数,则返回值为空。

externalId001
RemarksArrayAstring

标记信息列表。

如果请求时未设置此参数,则返回值为空。

["remarka1","remarka2"]
RemarksAstring

标记信息。

如果请求时未设置此参数,则返回值为空。

AdminGroup/AdminUserA/
ImageUristring

图片的 OSS URI。

oss://imm-test/testcases/face1.jpg
SetIdstring

媒体集的唯一标识。

set001
RemarksBstring

标记信息。

如果请求时未设置此参数,则返回值为空。

nas://path/to/file

示例

正常返回示例

JSON格式

{
  "RemarksArrayB": "[\"remarkb1\",\"remarkb2\"]",
  "ModifyTime": "2020-11-24T10:56:52.461Z",
  "RemarksC": "remarkc",
  "RemarksD": "remarkd",
  "RequestId": "144A2D4C-12D5-46D6-BEC9-9AAEE1F10C25",
  "CreateTime": "2020-11-24T10:56:52.461Z",
  "ExternalId": "externalId001",
  "RemarksArrayA": "[\"remarka1\",\"remarka2\"]",
  "RemarksA": "AdminGroup/AdminUserA/",
  "ImageUri": "oss://imm-test/testcases/face1.jpg",
  "SetId": "set001",
  "RemarksB": "nas://path/to/file"
}

错误码

访问错误中心查看更多错误码。

  • 本页导读 (1)
文档反馈