视频

class baijiayun.client.api.Video(client=None)

视频

add_category(name, parent_id=0)

添加分类 该接口用于添加分类

参数:

• name – 分类名称
• parent_id – 父分类ID，如果添加的是一级分类，则可以填0或不传

delete(video_id)

删除视频

参数:video_id – 视频id

delete_category(category_id)

删除分类 该接口用于删除分类，若该分类下有视频，则不可删除

参数:category_id – 分类ID

get_category_info(category_id=0)

获取指定ID分类信息 该接口用于获取分类信息

参数:category_id – 分类ID

get_category_list()

获取所有分类 该接口用于获取所有的分类信息

get_category_video(category_id, page_size=20, page=1)

获取指定分类下的视频 获取指定分类下的视频，如果是一级分类ID，则返回挂在该分类下的视频及挂在该分类下的二级分类里的视频

参数:

• category_id – 分类ID
• page_size – 每页条数，不得超过100，默认值20
• page – 页码，默认1

get_image(video_id)

获取指定ID视频截图 获取指定ID的视频截图（不包括已删除的视频）

参数:video_id – 视频id

get_info(video_id)

获取指定ID视频信息 获取指定ID的视频信息（不包括已删除的视频）

参数:video_id – 视频id

get_player_token(video_id, expires_in)

获取播放器token 获取视频播放token，服务端获取token后传给客户端，客户端就可以使用该token播放视频

参数:

• video_id – 视频ID
• expires_in – 过期时间，以秒为单位。如果传0则表示不过期

get_player_token_batch(video_ids, expires_in)

批量获取播放器token 获取视频播放token，服务端获取token后传给客户端，客户端就可以使用该token播放视频

参数:

• video_ids – 多个视频ID以英文逗号分隔
• expires_in – 过期时间，以秒为单位。如果传0则表示不过期

get_resume_upload_url(video_id, use_https=0)

获取断点续传地址 视频分片上传时，如果只上传了一部分中止了，可以通过此接口获取续传的地址，已上传的那部分不用再上传。

参数:

• video_id – 视频id
• use_https – 是否使用https上传地址，默认不使用

get_share_url(video_id)

获取视频分享地址 该接口用于获取视频的分享地址，包含iframe方式、js方式、flash方式

参数:video_id – 视频ID

get_status(video_id)

查询视频转码状态

参数:video_id – 视频id

get_upload_url(file_name, definition, audio_with_view=0, format=None, encrypt=None, use_https=0)

获取视频/音频上传地址 通过此接口，可以初始化一个视频/音频，并获取上传地址。

参数:

• file_name – 文件名
• definition – 目标清晰度(16:标清 1:高清 2:超清 4:720p 8:1080p 多种清晰度用英文逗号分隔)
• audio_with_view – 是否作为音频处理 0：否 1：是
• format – 转码格式（1:mp4 2:flv 4:m3u8 多种格式用英文逗号分隔）默认是3种格式都转
• encrypt – 是否生成加密格式视频/音频1:是 2:否（该功能需要申请加密视频/音频的权限，开通加密视频/音频权限后，默认都会加密）
• use_https – 是否使用https上传地址，默认不使用

get_url(video_id, format=None, expires_in=None)

获取转码后视频/音频地址 该接口用于获取转码后视频的不同清晰度播放地址，以及视频宽高等信息。

参数:

• video_id – 视频ID
• format – 视频格式，可选值有：mp4/m3u8/flv/encrypt，默认是mp4，encrypt表示加密格式，账号开启了点播加密功能才会有该格式的视频
• expires_in – 视频失效时间，单位为秒，默认是12小时

get_video_list(page_size=20, page=1, create_time=None)

获取点播视频列表 获取点播的视频列表

参数:

• page_size – 每页条数，不得超过1000，默认值20
• page – 页码，默认1
• create_time – 默认不加上时间筛选

remove_definition(video_id, definition, type='1')

清除指定清晰度的转码文件 该接口可以清除指定清晰度的视频文件，以减少占用的存储空间

参数:

• video_id – 视频id
• definition – 目标清晰度(16:标清 1:高清 2:超清 4:720p 8:1080p 多种清晰度用英文逗号分隔)
• type – 目标类型(1:mp4 2:flv 4:m3u8 8:encrypt 多种类型用英文逗号分隔)

set_publish_status(video_id, status)

设置视频发布状态 该接口用于设置视频的发布状态。默认情况下，视频转码成功后会自动发布。

参数:

• video_id – 视频ID
• status – 发布状态 1:发布 2:屏蔽

set_video_category(video_id, category_id)

设置视频分类 设置一个视频的分类

参数:

• video_id – 视频ID
• category_id – 分类ID

transcode_again(video_id, definition, format=None)

视频二次转码 如果视频初始化时只指了某几种清晰度，后面需要转其它清晰度，则可以调用此接口

参数:

• video_id – 视频id
• definition – 目标清晰度(16:标清 1:高清 2:超清 4:720p 8:1080p 多种清晰度用英文逗号分隔)
• format – 转码格式（1:mp4 2:flv 4:m3u8 多种格式用英文逗号分隔）默认是3种格式都转

update(video_id, name)

更新视频信息 该接口可以更新视频信息，目前只有名称可以更新

参数:

• video_id – 视频id
• name – 视频名称