云点播 Python SDK

对于在服务端上传视频的场景，云点播提供 Python SDK 来实现。上传流程请参见 服务端上传指引。

一、使用 pip 安装

pip install vod-python-sdk

二、通过源码包安装

如果项目中没有使用 pip 工具，可以直接下载源码导入项目中使用：

·从 GitHub 访问

·单击下载 Python SDK

下载最新代码，解压后：

$ cd vod-python-sdk$ python setup.py install

三、初始化上传对象

使用云 API 密钥初始化 VodUploadClient 实例。

from qcloud_vod.vod_upload_client import VodUploadClientclient = VodUploadClient("your secretId", "your secretKey")

四、构造上传请求对象

from qcloud_vod.model import VodUploadRequestrequest = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"

五、调用上传

调用上传方法，传入接入点地域及上传请求。

try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

注意：说明：

注意：上传方法根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。

六、携带封面

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"request.CoverFilePath = "/data/file/Wildlife-Cover.png"try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl) print(response.CoverUrl)except Exception as err: # 处理业务异常 print(err)

七、指定任务流

首先 创建任务流模板 并为模板命名，发起任务流时，可以用任务流模板名设置 Procedure 参数，上传成功后会自动执行任务流。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"request.Procedure = "Your Procedure Name"try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

八、应用上传

传入 应用 ID，上传成功后资源只属于具体的应用。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"request.SubAppId = 101try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

九、指定存储地域

在 控制台 确认已经开通目标存储地域，若没有开通可以参考 上传存储设置，最后通过 StorageRegion 属性设置存储地域的 英文简称。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"request.StorageRegion = "ap-chongqing"try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

十、指定分片并发数

分片并发数是针对大文件，拆分成多个分片同时进行上传。分片并发上传的优势在于可以快速完成单个文件的上传，SDK 会根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。而文件的分片并发数通过 ConcurrentUploadNumber 参数进行指定。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"request.ConcurrentUploadNumber = 5try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

十一、使用临时证书上传

传入 临时证书 的相关密钥信息，使用临时证书验证身份并进行上传。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("Credentials TmpSecretId", "Credentials TmpSecretKey", "Credentials Token")request = VodUploadRequest()request.MediaFilePath = "/data/file/Wildlife.mp4"try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

十二、自适应码流文件上传

本 SDK 支持上传的自适应码流格式包括 HLS 和 DASH，同时要求 manifest（M3U8 或 MPD）所引用的媒体文件必须为相对路径（即不可以是 URL 和绝对路径），且位于 manifest 的同级目录或者下级目录（即不可以使用../）。在调用 SDK 上传接口时，MediaFilePath 参数填写 manifest 路径，SDK 会解析出相关的媒体文件列表一并上传。

from qcloud_vod.vod_upload_client import VodUploadClientfrom qcloud_vod.model import VodUploadRequestclient = VodUploadClient("your secretId", "your secretKey")request = VodUploadRequest()request.MediaFilePath = "/data/file/prog_index.mp4"try: response = client.upload("ap-guangzhou", request) print(response.FileId) print(response.MediaUrl)except Exception as err: # 处理业务异常 print(err)

十三、接口描述

上传客户端类 VodUploadClient：

上传请求类 VodUploadRequest：

上传响应类 VodUploadResponse：

上传方法 VodUploadClient.upload(String region, VodUploadRequest request)：

十四、错误码表