基础概念

项目

开发者使用智能媒体管理服务的基本单元。

比如，开发者希望开发 网盘 APP，可以在存储数据的 OSS 桶相同区域创建项目，并对项目授予访问 OSS 桶的合理权限，就可以便捷的使用智能媒体管理的功能，比如文档预览、图片 AI、视频 AI 等能力。

数据源

为智能媒体管理提供数据来源，当前支持 OSS 存储作为数据源。

它可以是整个 Bucket 、或者 Bucket 的前缀，可以在 RAM 配置角色 Policy 时实现控制，再通过智能媒体管理服务 创建项目 时指定角色，完成对数据源的访问控制。

数据处理实例

针对场景进行功能封装，并包装为实例，从而实现更便捷的使用，目前提供如下的处理实例：

• 文档标准型。包含文档格式转换、文档预览功能。
• 图片标准型。包含标签检测、人脸检测的 AI 功能。

请求类型

• 同步请求，客户端发出请求后，阻塞等待结果返回。例如，图片实例中的人脸检测，标签检测，它通常在几百毫秒内返回。
• 异步请求，为了解决同步任务执行时间太长，导致客户端阻塞太久的问题（超过 10 秒可能会链接断开），引入了异步请求机制。此时，客户端发出请求后，会快速返回 ID。基于此 ID，可以查询异步请求的状态。例如，文档实例中的格式转换请求，在大文件时可能几十秒、甚至分钟级才能完成。

任务（Task）

单个数据处理异步请求的执行实体，调用异步请求 API 返回的 ID，就是任务的 ID。例如，执行单个文档的异步转换，它的执行实体就是一个任务。

任务创建后，支持 Get 查询任务状态，Delete 删除任务，List 遍历任务请求。