检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
身份认证与访问控制 身份认证 您可以通过VOD控制台、API、SDK访问VOD，无论访问方式封装成何种形式，其本质都是通过VOD提供的REST风格的API接口进行请求。 VOD的接口请求需要经过认证后才可以访问成功。其中，调用接口有以下两种认证方式，您可以选择其中一种进行认证鉴权。
示例1：媒资上传（20M以下） 场景描述 若您需要将存储在本地的音视频文件上传到点播服务，并在上传后，自动处理音视频，如发布、转码等，您可以调用VOD API进行媒资创建，并通过OBS API将音视频文件上传到VOD的存储桶中。 本章节指导用户如何使用API调用的方式上传一个大小20M以下的视频文件。
创建自定义转码模板 功能介绍 创建自定义转码模板。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2/{project_id}/asset/template/transcodings
获取项目ID 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 图1 管理控制台
创建媒资：URL拉取注入（公测中） 功能介绍 通过音视频源文件的URL，离线拉取音视频文件至点播服务。如果音视频文件大小在5TB以下，可以使用这种方式。如果文件大小超出5TB，需要通过搬迁工具上传至点播服务，请提交工单获取工具和相应的操作指导。 接口约束 用户调用该API一次最多支持拉取16条音视频。
媒资处理 功能介绍 实现视频转码、截图、加密等处理。既可以同时启动多种操作，也可以只启动一种操作。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1.
修改转码模板组集合 功能介绍 修改转码模板组集合。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI PUT /v1.0/{project_id}/asset/temp
状态码 调用视频点播API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。
创建转码模板组集合 功能介绍 创建转码模板组集合。 接口约束 不同模板的转码产物类型完全一样时，不支持添加至同一个转码模板组中。 相同编码格式的模板，在转码模板组的产物类型，不允许同时出现HLS/DASH（二选一）和HLS_DASH。不同编码格式的模板无影响。 其中codec为视频编码格式，取值为H
创建媒资：OBS转存方式 功能介绍 若您在使用点播服务前，已经在OBS桶中存储了音视频文件，可以使用该接口将OBS桶中的音视频文件转存至点播服务，再使用点播服务音视频管理功能。 使用该接口前，需要提前完成下述操作： 参考VOD用户指南“创建用户并授权使用VOD”章节，授权用户使用VOD。
视频更新 功能介绍 媒资创建后，单独上传封面、更新视频文件或更新已有封面。如果是更新视频文件，更新完后要通过确认媒资上传接口通知点播服务。如果是更新封面或单独上传封面，则不需通知。更新视频可以使用分段上传，具体方式可以参考示例2：媒资分段上传（20M以上）。 接口约束 视频更新接
查询密钥 功能介绍 终端播放HLS加密视频时，向租户管理系统请求密钥，租户管理系统先查询其本地有没有已缓存的密钥，没有时则调用此接口向VOD查询。该接口的具体使用场景请参见《点播服务最佳实践》中通过HLS加密防止视频泄露的示例代码。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
修改转码模板 功能介绍 修改转码模板。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI PUT /v2/{project_id}/asset/template/transcodings
示例4：视频处理 场景描述 音视频上传时，可以设置媒资处理参数，上传完成后，自动根据设置的参数进行音视频处理。若您需要对已上传的视频进行处理，您也可以调用VOD API实现。 本章节指导用户如何使用API调用的方式处理已上传的视频文件，包括视频转码、截图、加密等，支持同时启动多种处理操作，也可以只启动一种处理操作。
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
示例2：媒资分段上传（20M以上） 场景描述 示例1：媒资上传（20M以下）已介绍了如何将小于20M大小的音视频文件上传到点播服务。若您需要上传的音视频文件的大小大于20M，您可以调用VOD API进行分段上传。 本章节指导用户如何使用API调用的方式上传一个文件大小大于20M的视频文件。
修订记录 表1 修改记录 修改时间 修改说明 2024-11-15 第四十五次正式发布 本次变更如下： 新增“转码产物管理”接口组。 2024-10-15 第四十四次正式发布 本次变更如下： 新增“修改媒资降冷粒度”接口。 新增“查询媒资降冷”接口。 新增Python和Go语言的分段上传代码示例。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
