x-oss-process使用指南

阿里云对象存储OSS与智能媒体管理(IMM)深度结合,支持媒体处理、文档处理等丰富的数据分析处理操作。本文介绍如何通过x-oss-process使用IMM的相关功能。

前提条件

  • 仅支持使用IMM的地域可以使用IMM相关功能。更多信息,请参见服务接入点

    说明

    新版数据处理功能API、SDK支持在IMM服务接入点中的地域进行使用。但目前控制台该功能在灰度中,仅德国(法兰克福)、华北1(青岛)两个地域的部分用户可以使用。

  • 已开通IMM服务并完成授权。关于开通服务及授权的具体操作,请参见开通产品

费用说明

使用IMM功能会产生一定的费用。详细费用,请参见计费概述

步骤一:创建IMM项目

  1. 登录IMM管理控制台

  2. 在左侧导航栏底部,单击体验新版。(若底部为回到旧版,则跳过该步骤)

  3. 在左侧导航栏,单击项目列表

  4. 单击创建项目,详情请见创建项目

步骤二:绑定Bucket

相关API请参见AttachOSSBucket - 绑定对象存储桶,此处介绍使用OpenAPI Explorer绑定Bucket的操作步骤。

  1. 登录OpenAPI Explorer,在页面左上角,选择IMM API版本以及地区。

image..png

重要

为了减少跨网络的时延和成本,项目只能绑定相同地域的OSS Bucket,地域请选择为与您需要处理的OSS数据相同的地域。

  1. 在参数配置中,输入项目名称和需要绑定的OSS Bucket,点击发起调用。

    image..png

  2. 查看右侧调用结果。

image..png

步骤三:配置权限

配置方法请参见权限

说明

此权限配置针对RAM用户或者RAM角色。若当前账号为阿里云账号(主账号),可以跳过。

步骤四:配额申请

  1. 登录OSS管理控制台

  2. 在左侧导航栏,单击自助工具

  3. 在左侧导航栏,继续单击更多工具

  4. 在右侧菜单栏,选择您的OSS Bucket。

    image

  5. 在右侧菜单栏,单击开启新版本 IMM Get 数据处理能力开启新版本 IMM Post数据处理能力配额申请

    image

  6. 等待审批。

使用介绍

说明

目前该能力仅支持中国站,并且不支持匿名访问,签名方式访问请参见sign(生成签名URL)

媒体处理

具体参数使用方式请参见媒体处理概述

处理操作

参数

说明

视频转码

video/convert

将OSS中的视频文件转换为需要的格式。

视频转动图

video/animation

将OSS中的视频文件转换为GIF、Webp等动图格式。

视频截雪碧图

video/sprite

将OSS中的视频文件截帧并拼成雪碧图转为需要的图片格式。

视频截帧

video/snapshots

将OSS中的视频文件截帧并转换为需要的图片格式。

视频拼接

video/concat

将OSS中的多个视频拼接为一个视频并转换为需要的格式。

视频信息提取

video/info

提取OSS中的视频文件的媒体格式信息和媒体流信息。

音频转码

audio/convert

将OSS中的音频文件转换为需要的格式。

音频拼接

audio/concat

将OSS中的多个音频文件拼接为一个音频并转换为需要的格式。

音频信息提取

audio/info

提取OSS中的音频文件的媒体格式信息和媒体流信息。

文档处理

具体参数使用方式请参见文档处理概述

处理操作

参数

说明

文档转换

doc/convert

将OSS中的文档转换为需要的格式。

文档在线预览

doc/preview

对OSS中的文档进行预览。

文档在线编辑

doc/edit

对OSS中的文档进行协同编辑。