API 发布历史--视频点播-火山引擎

文档中心

导航

API 发布历史

最近更新时间：2024.07.22 19:54:06首次发布时间：2023.01.09 17:11:15

本文为您介绍视频点播服务端 API 的文档动态。

2024 年 05 月

API	发布时间	变更记录	关联功能
新增 UpdateFileStorageClass	2024-05-30	新增接口，获取 DirectUrl 模式下的文件信息	媒资管理 > DirectUrl 模式
新增 GetFileInfos		新增接口，修改 DirectUrl 模式下的文件存储类型	媒资管理 > DirectUrl 模式
修改 DescribeVodDomainBandwidthData		请求参数和返回参数新增 RegionList，支持查询海外区域亚太东南（柔佛）的数据	数据统计 > 用量查询
修改 DescribeVodDomainTrafficData
修改 DescribeVodSpaceStorageData
修改 DescribeVodSpaceTranscodeData
修改 DescribeVodSnapshotData
修改 SubmitDirectEditTaskAsync	2024-05-18	请求参数 CallbackArgs 添加说明，如您设置的自定义字段大小超过 100 B，请提交工单联系技术支持配置	视频剪辑
新增 DescribeVodRealtimeMediaData	2024-05-16	新增接口，支持查询实时处理用量	用量查询
新增 DescribeVodRealtimeMediaDetailData	2024-05-16	新增接口，支持查询实时处理详细数据	数据统计 > 用量查询

2024 年 04 月

发布时间	API	说明	相关文档
2024-04-30	GetMediaInfos	新增 `2023-07-01` 版本获取媒资信息 API	获取媒资信息
2024-04-25	DescribeVodPlayedStatisData DescribeVodMostPlayedStatisData	在注意事项中新增 HLS 协议视频的相关说明	查询视频播放信息查询播放 TopN 的视频
2024-04-16	-	Output 编码输出设置中参数 `Format` 取值新增 `mp3`	视频剪辑参数
2024-04-12	CancelDirectEditTask GetDirectEditResult	新增取消剪辑任务 API GetDirectEditResult API 返回参数中 Status 取值新增 user_canceled	取消剪辑任务查询任务详情
2024-04-11	GetDirectEditResult	新增查询任务详情 API 返回参数中 Message可能产生的错误任务信息的错误码	视频剪辑错误码

2024 年 03 月

发布时间	API	说明	相关文档
2024-03-29	用量查询相关 API	在请求参数中 `StartTime` 中添加开始时间最早不早于当前时间的 366 天的说明	用量查询
2024-03-28	UpdateMediaInfo	请求参数中 `Title` 支持的字符长度为 512	修改媒资信息
2024-03-28	CommitUploadInfo	请求参数中 `Functions` JSON 数组中 `Title` 支持的字符长度为 512	上传功能函数说明
2024-03-26	DeleteMediaTosFile QueryMoveObjectTaskInfo SubmitMoveObjectTask	新增媒资管理模块 3 个 API	批量删除 DirectUrl 模式文件查询跨空间文件迁移任务状态提交跨空间文件迁移任务
2024-03-26	GetMediaList	请求参数 `title` 标题，支持模糊搜索音视频文件	获取音视频列表
2024-03-19	--	视频剪辑的 `Track` 视频轨道列表中 `Audio` 、`Video` 和 `Image` 资源类型中 `Source` 资源下载地址支持挂载 TOS 方式	视频剪辑参数
2024-03-15	CreateSpace	请求参数中 `Description` 的是否必选由是改为否	创建空间
2024-03-08	--	视频剪辑参数输出分辨率规则，Canvas 渲染画布设置结构体新增 `Index` 和 `Ratio` 参数	视频剪辑参数

2024 年 01 月

发布时间	API	说明	相关文档
2024-01-17	--	Output 编码输出参数结构体新增 `CanvasWithMax`、`CanvasWithRatio`、`AudioPhaseDetect` 参数 Canvas 渲染画布设置结构体新增 `Long`、`Short`、`Index`、`Ratio` 参数	视频剪辑参数

2023 年 12 月

发布时间	API	说明	相关文档
2023-12-29	优化视频点播所有 API 文档	依据文档规范，调整文档结构添加 API Explorer 的调试入口请求参数和返回参数表格中，新增示例值一列	API 列表
2023-12-22	GetPlayInfo	请求参数新增 `ForceExpire` 强行指定本次请求的时间戳防盗链	获取播放地址
2023-12-20	视频剪辑参数	修正视频动画中出场动画 ID 中向下滑出的效果展示	视频剪辑参数
2023-12-20	UpdateDomainUrlAuthConfig	新增修改 URL 域名鉴权配置 API	修改 URL 域名鉴权配置
2023-12-04	GetMediaList	返回参数 `AudioStreamMeta` 结构体新增 `Channels` 声道数	获取音视频列表

2023 年 11 月

发布时间	API	说明	相关文档
2023-11-17	ListFileMetaInfosByFileNames	新增 ListFileMetaInfosByFileNames API	根据文件路径获取媒资信息列表
2023-11-09	--	视频剪辑支持 `canvas` 参数自动匹配	视频剪辑参数
2023-11-07	StartDomain StopDomain DeleteDomain AddDomainToScheduler RemoveDomainFromScheduler UpdateDomainPlayRule	新增域名相关 API	启用域名停用域名删除域名将域名添加至点播调度将域名移除点播调度设置域名分发规则

2023 年 10 月

发布时间	API	说明	相关文档
2023-10-12	ListDomain	返回参数 `Domains` 域名列表的数组中增加 `LockStatus` 和 `CDNStatus` 的参数	获取空间域名列表
2023-10-10	--	优化部分参数描述字体 ID 整体更新字体展示效果、在方正兰亭大黑字体中增加（繁体）文案、站酷意大利体不支持中文。	视频剪辑参数
2023-10-10	GetMediaInfos GetMediaList	返回参数 MediaInfoList 数组中 `BasicInfo` 结构体中新增 `HlsMediaSize` 参数	查询媒资信息获取音视频列表
2023-10-08	UploadMediaByUrl	请求参数中 `URLSets` 的结构体新增 `CustomURLHeaders`	URL 批量拉取上传

2023 年 9 月

发布时间	API	说明	相关文档
2023-09-21	GetPlayInfo	GetPlayInfo 的请求参数新增 `NeedOriginal` 是否返回原视频信息的参数。	获取播放地址
2023-09-27	--	修正转场 ID 的泛开的 ID 由 1182361 更改为 1182358	视频剪辑参数
2023-09-08	--	下线转场 ID 的水滴和下线花字 ID 中的蓝红泛光 1179440	视频剪辑参数
2023-09-06	CommitUploadInfo	请求参数的 `Functions` 参数的 Functions 列表的 `AddOptionInfo` 结构体新增 `IsHlsIndexOnly` 是否仅为 HLS 索引文件参数。	确认上传
2023-09-01	StartWorkflow GetWorkflowExecutionResult ListSnapshots	StartWorkflow 的请求参数的 Input 中的 Snapshot 数组新增 `SampleOffsets` 采样截图自定义时间参数。返回参数 `Snapshots` 数组中的采样截图 `SnapshotParamsSample` 结构体，新增 `Offsets` 采样截图自定义时间参数。返回参数 `VSamplePosterSnapshots` 采样截图的数组，新增 `Offsets` 采样截图自定义时间参数。	触发工作流获取工作流执行结果获取截图结果

2023 年 8 月

发布时间	API	说明	相关文档
2023/8/1	DescribeVideoStreamOutData	新增 DescribeVideoStreamOutData API	查询媒资存储流量用量
2023/8/1	StartWorkflow	请求参数 TranscodeVideo 、TranscodeAudio 和 Snapshot 中的 FileName 参数取值增加 {{outFormat}}：文件格式	触发工作流

2023 年 7 月

发布时间	API	说明	相关文档
2023-07-28	ListCdnTopAccess	新增获取热点统计数据 API	获取热点统计数据
2023-07-25	ListDomain	ListDomain 的返回参数的 `Domains` 域名列表的 `Certificate` 结构体中`HttpsStatus` 参数的取值 `configuring`：配置中。	获取空间域名列表
2023-07-21	ListCdnHitrateData	新增获取命中率 API	获取命中率
2023-07-06	StartWorkflow RetrieveTranscodeResult GetWorkflowExecution GetWorkflowExecutionResult	请求说明中新增请求频率： StartWorkflow、GetWorkflowExecution 和 GetWorkflowExecutionResult 的 API 单用户请求频率限制为 50 次/秒 RetrieveTranscodeResult 的 API 单用户请求频率限制为 10 次/秒	触发工作流获取转码结果获取工作流运行状态获取工作流执行结果
2023-07-05	StartWorkflow	请求参数中视频转码和音频转码的 `FileName` 参数新增取值，截图新增 `FileIndex` 参数。 `TranscodeVideo` 和 `TranscodeAudio` 结构体中 `FileName` 参数取值新增： {{vid}}：片源 Vid。 {{templateId}}：截图模板 ID。 {{random}}：32 位随机字符串。 `Snapshot` 数组新增 `FileIndex` 参数。	触发工作流

2023 年 6 月

发布时间	API	说明	相关文档
2023-06-28	ListCdnUsageData	ListCdnUsageData 的请求参数新增 `Area`、`Region`、`Isp`、`Protocol`、`IpVersion`、`BillingRegion` 等参数。返回参数的 `Datas` 数组新增 `Region`、`Isp`、`BillingRegion` 等参数。	获取带宽流量
2023-06-20	UpdateMediaStorageClass ApplyUploadInfo UploadMediaByUrl GetMediaList GetMediaInfos DescribeVodSpaceTranscodeData	UpdateMediaStorageClass 请求参数 `StorageClass` 取值新增 `IA`：低频存储 ApplyUploadInfo 请求参数 `StorageClass` 取值新增 `3`：低频存储。 UploadMediaByUrl 请求参数中 `URLSet`中 `StorageClass` 取值新增 `3`：低频存储。 GetMediaList 请求参数 `TosStorageClasses` 取值新增 `IA`：低频存储。 GetMediaInfos 返回参数 `SourceInfo` 结构体和 `TranscodeInfos` 数组中 `TosStorageClass` 参数取值新增 `IA`：低频存储。优化 `Type` 参数的取值描述。 `hot`：标准存储。 `lowfreq`：低频存储。 `archive`：归档存储。 `punish`：低频存储提前删除量。 `archive_punish`：归档存储提前删除量。	修改媒资存储类型获取上传地址和凭证 URL 批量拉取上传获取音视频列表查询媒资信息查询存储用量

2023 年 5 月

发布时间 API 说明相关文档

2023-05-15

ListDomain
CreateCdnRefreshTask
CreateCdnPreloadTask

优化错误码

ListDomain API 的错误码新增 InvalidParameter.InvalidAccountId 和InvalidParameter.InvalidDomainTypeOrSourceStationType
CreateCdnRefreshTask API 的错误码新增 InvalidParameter.InvalidAccountId、 InvalidParameter.InvalidTaskType 和 InvalidParameter.NoActionQuota
CreateCdnPreloadTask API 的错误码新增 InvalidParameter.InvalidAccountId 和InvalidParameter.NoActionQuota

2023 年 4 月

发布时间	API	说明	相关文档
2023-04-28	ListSnapshots GetWorkflowExecutionResult	ListSnapshots 的返回参数 `VSamplePosterSnapshots` 采样截图数组，新增 `LargeSnapshotUri` 和 `LargeSnapshotDownloadUrl` 两个参数 GetWorkflowExecutionResult 的返回参数 `Sample` 采样截图数组，新增 `StoreUris` 和 `IndexUri` 两个参数	获取截图结果获取工作流执行结果
2023-04-28	QueryUploadTaskInfo	QueryUploadTaskInfo 的返回参数新增 `Callbackargs` 参数	查询 URL 批量上传任务状态
2023-04-26	视频剪辑参数	视频剪辑新增文字模式， `Text` 文字资源，新增 `BackgroundColor` 和 `BackgroundBorderSize` 两个参数	视频剪辑参数
2023-04-14	DescribeVodSnapshotData DescribeVodEnhanceImageData DescribeVodSpaceDetectStatisData DescribeVodSpaceAIStatisData DescribeVodSpaceSubtitleStatisData DescribeVodSpaceEditStatisData	新增用量查询的 API	查询截图用量查询画质增强用量查询检测修复用量查询多媒体 AI 用量查询智能字幕用量查询视频剪辑用量
2023-04-10	视频剪辑参数	视频剪辑新增字幕自动换行功能，`Text` 文字资源，新增 `LineMaxWidth` 参数	视频剪辑参数
2023-04-07	DescribeVodSpaceEditDetailData	新增查询视频剪辑详细数据的 API	查询视频剪辑详细数据

2023 年 3 月

发布时间	API	说明	相关文档
2023-03-27	UpdateMediaStorageClass	UpdateMediaStorageClass 的请求参数新增 `FileIds` 参数	修改媒资存储类型
2023-03-17	GetPlayInfo	GetPlayInfo 的请求参数 HDRDefinition 新增 `oe`（画质增强）的取值	获取播放地址
2023-03-22	DescribeVodSpaceWorkflowDetailData	新增查询转码详细数据的 API	查询转码详细数据
2023-03-09	UploadMediaByUrl 视频剪辑参数	UploadMediaByUrl 请求参数中新增 UrlEncryptionAlgorithm 和 EnableLowPriority 参数视频剪辑参数的视频编码格式支持 vp9 格式	URL 批量拉取上传

2023 年 2 月

发布时间	API	说明	相关文档
2023-02-27	CreateDomain UpdateDomainExpire UpdateDomainAuthConfig GetPlayInfo	新增创建域名的 API 新增修改域名时间戳防盗链的 API 新增修改域名鉴权配置的 API GetPlayInfo 的请求参数 Definition 新增 oe（画质增强）的取值	创建域名修改域名时间戳防盗链获取播放地址
2023-02-16	CommitUploadInfo	CommitUploadInfo 请求参数中新增 GetMetaMode 参数	确认上传
2023-02-13	StartWorkflow GetWorkflowExecution GetWorkflowExecutionResult	StartWorkflow 请求参数中新增 DirectUrl 参数 GetWorkflowExecution 返回参数中新增 DirectUrl 参数新增获取工作流执行结果的 API	触发工作流获取工作流运行状态获取工作流执行结果
2023-02-10	视频剪辑参数	视频剪辑参数的输出视频的封装格式支持 HLS 格式	视频剪辑参数
2023-02-08 2023-02-07	CommitUploadInfo UploadMediaByUrl CommitUploadInfo	CommitUploadInfo 和 UploadMediaByUrl请求参数中更新`FileName` 支持的特殊字符确认上传的 API 新增 `InvaildParam.ImageDataProcessError` 错误码	确认上传 URL 批量拉取上传确认上传

2022 年 12 月

发布时间	API	说明	相关文档
2022-12-28	UpdateMediaStorageClass GetMediaInfos GetMediaList	新增修改媒资存储类型的 API GetMediaInfos 的返回新增 TosStorageClass 参数 GetMediaList 的请求和返回新增 TosStorageClasses 参数	修改媒资存储类型查询媒资信息获取音视频列表
2022-12-21	ApplyUploadInfo CommitUploadInfo	版本号由 2020-08-01 升级为 2022-01-01 ApplyUploadInfo 的请求新增 FileExtension 参数支持自定义文件路径功能	获取上传地址和凭证确认上传

2022 年 11 月

发布时间	API	说明	相关文档
2022-11-24	GetSubtitleInfoList UpdateSubtitleInfo	GetSubtitleInfoList 的请求 Languages 和 LanguageIds 参数，支持多种语言的取值 UpdateSubtitleInfo 的请求 Language 参数，支持多种语言的取值	获取字幕文件修改字幕信息

2022 年 9 月

发布时间	API	说明	相关文档
2022-09-27	DescribeVodPlayedStatisData DescribeVodMostPlayedStatisData	新增查询视频播放信息和查询播放 TopN 的视频的 API	查询视频播放信息查询播放 TopN 的视频
2022-09-23	* GetWorkflowExecution	新增获取工作流运行状态的 API	获取工作流运行状态

2022 年 8 月

发布时间	API	说明	相关文档
2022-08-03	SetCallbackEvent AddCallbackSubscription	新增获取回调时间和添加回调订阅地址的 API	获取回调事件添加回调订阅地址
2022-08-02	DescribeVodSpaceStorageData	新增查询存储用量的 API	查询存储用量

2022 年 6 月

发布时间	API	说明	相关文档
2022-06-29	ListCdnTasks	更新获取刷新预热任务列表 API 的参数	获取刷新预热任务列表
2022-06-27	ListCdnUsageData ListCdnPvData ListCdnStatusData	新增获取带宽流量、获取请求数、获取状态码的 API	获取带宽流量获取请求数获取状态码
2022-06-24	RetrieveTranscodeResult GetPlayInfo	新增获取转码结果的 API 获取播放地址 API 中支持音频多码率	获取转码结果获取播放地址
2022-06-21	GetPlayInfo DescribeIpInfo	获取播放地址 API 中新增 od（原画转封装）清晰度新增获取 IP 归属信息的 API	获取播放地址获取 IP 归属信息
2022-06-20	CreateSpace GetSpaceDetail UpdateSpace GetSpaceDetail UpdateSpaceUploadConfig	新增空间管理模板的 API	创建空间获取空间列表获取空间详细信息更新空间信息更新空间上传配置

2022 年 4 月

发布时间	API	说明	相关文档
2022-04-28	ListCdnTopAccessUrl DescribeVodDomainBandwidthData	新增获取热点 URL 、查询流量带宽用量的 API	获取热点 URL 统计查询流量带宽用量
2022-04-19	ApplyUploadInfo	获取上传地址和凭证，增加 FileName 参数	获取上传地址和凭证
2022-04-15	ListCdnAccessLog	新增获取日志文件下载地址的 API	获取日志文件下载地址
2022-04-13	ListDomain CreateCdnRefreshTask CreateCdnPreloadTask ListCdnTasks	新增点播 CDN 的 API	获取空间域名列表刷新缓存预热缓存获取刷新预热任务列表
2022-04-06	GetPlayInfo	请求参数增加过期时间戳DrmExpireTimestamp	获取播放地址

2022 年 3 月

发布时间	API	说明	相关文档
2022-03-29	CreateCdnRefreshTask CreateCdnPreloadTask	新增刷新缓存、预热缓存 API	刷新缓存预热缓存
2022-03-28	GetPlayInfo	在请求中新增 PlayScene 参数，支持下发试看流	获取播放地址
2022-03-25	SubmitDirectEditTaskAsync GetDirectEditProgress GetDirectEditResult	新增视频剪辑的 API	提交编辑任务查询任务进度查询任务详情
2022-03-24	ListCdnTasks ListCdnAccessLog	新增获取刷新预热任务列表、获取日志文件下载地址的 API	获取刷新预热任务列表获取日志文件下载地址
2022-03-18	ListSnapshots CreateVideoClassification ListVideoClassifications UpdateVideoClassification DeleteVideoClassification	新增获取截图结果和媒资分类模块的 API	获取截图结果创建视频分类查询视频分类更新视频分类删除视频分类

2021 年 7 月

发布时间	API	说明	相关文档
2021-07-21	GetSubtitleInfoList UpdateSubtitleStatus UpdateSubtitleInfo	新增获取字幕文件、修改字幕发布状态和修改字幕信息的 API	获取字幕文件修改字幕发布状态修改字幕信息

2021 年 6 月

发布时间	API	说明	相关文档
2021-06-16	GetMediaList	新增获取音视频信息列表的 API	获取音视频信息列表

2021 年 4 月

发布时间	API	说明	相关文档
2021-04-11	DeleteMedia DeleteTranscodes	新增批量删除完整媒资、删除媒体文件的 API	批量删除完整媒资删除媒体文件

2021 年 2 月

发布时间	API	说明	相关文档
2021-02-23	ApplyUploadInfo CommitUploadInfo UploadMediaByUrl QueryUploadTaskInfo GetMediaInfos UpdateMediaInfo UpdateMediaPublishStatus GetRecommendedPoster StartWorkflow GetPlayInfo	新增媒资上传、媒资管理、媒资处理、媒资播放模块的 API	获取上传地址和凭证确认上传 URL批量拉取上传查询URL批量拉取上传任务状态查询媒资信息修改媒资信息修改媒资发布状态获取封面候选结果触发工作流获取播放地址