文档首页/ 媒体处理 MPC/ API参考/ 使用前必读
更新时间：2024-11-12 GMT+08:00
查看PDF
分享

使用前必读

媒体处理服务（Media Processing Center，简称MPC）是一种多媒体数据处理服务，通过经济、弹性和高可扩展的转换方法，将存储于OBS上的音视频转码为适应各种终端（PC、TV、Phone等）播放的格式，并实现抽帧截图、图片水印、视频加密等功能，满足多样化的业务场景需求。

您可以使用本文档提供的API对媒体处理服务进行相关操作，如创建转码模板、创建转码任务，创建截图任务等。支持的全部操作请参见API概览。

在调用媒体处理服务的API之前，请确保已经充分了解媒体处理的相关概念，详细信息请参见产品介绍。

媒体处理提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。

同时媒体处理还提供多种编程语言的SDK供您使用，SDK的使用方法请参见MPC SDK。

在调用媒体处理API前，请注意如下事项：
  • 由于媒体处理服务无媒资存储功能，只能处理存储在OBS桶中的音视频文件，因此，您在调用视频转码、转封装、转动图、抽帧截图、独立加密接口前，需要将待处理的音视频文件上传到OBS桶中，并将桶授权给媒体处理服务。具体操作指导请参见上传音视频文件。
  • 若您需要实时了解媒体处理在处理音视频文件的执行情况，您可以在调用API接口前，在媒体处理控制台配置消息通知功能。具体操作指导请参见配置消息通知功能。

终端节点

终端节点即调用API的请求地址，您可以从地区和终端节点中查询服务的终端节点。

约束与限制

  • 媒体处理服务设置了API流量控制，避免因短时间内重复调用API导致服务中断的情况出现。

    目前转码的流控限制规则如下：

    • 单租户接口流控：100次/分钟。
    • 接口总体流控：1000次/分钟。
  • 调用IAM接口的区域需与调用媒体处理接口的区域一致，如调用“cn-north-4”区域的IAM接口获取用户Token，则该Token仅能用于调用“cn-north-4”区域媒体处理接口的鉴权。
  • 不支持处理跨区域的媒资文件，如使用“华北-北京一”的媒体处理服务不能处理存储在“华北-北京四”OBS桶中的视频文件。
  • 在请求参数中填写Integer数据类型时，使用小数，只有小数点之前的数字有效。
  • 更详细的限制请参见具体API的说明。

基本概念

  • 账号

    用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。

  • 用户

    由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。

    在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。

  • 区域

    指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。

  • 可用区

    一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。

  • 项目

    区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。

    图1 项目隔离模型

相关文档