本文将为您介绍视频直播服务端 API 的更新动态。
2026 年 10 月
2026 年 08 月
2026 年 05 月
2026 年 04 月
2026 年 02 月
2026 年 01 月
2025 年 12 月
2025 年 09 月
2025 年 08 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
修改 UpdateIPAccessRule | 2025-08-27 | - 请求参数新增
EnableTS,支持配置校验是否包含 TS 文件。 - 请求参数新增
DenyHTTPStatusCode,支持自定义返回状态码。
| IP 黑白名单 |
修改 DescribeIPAccessRule | - 返回参数新增
EnableTS,支持获取校验是否包含 TS 文件。 - 返回参数新增
DenyHTTPStatusCode,支持获取系统返回的 HTTP 状态码。
|
2025 年 06 月
2025 年 05 月
2025 年 04 月
2025 年 02 月
2025 年 01 月
2024 年 12 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
新增 DescribeLiveEdgeStatData | 2024-12-18 | 新增查询边缘数据接口,支持查询指定协议、运营商、区域、时间范围下,直播流产生的上下行流量、上下行峰值带宽和请求数等数据。
同时将 DescribeLiveMetricTrafficData、DescribeLiveMetricBandwidthData 接口移入历史版本接口,并在 3 个月后停止维护,并在 6 个月后下线文档。 | 统计分析 |
| 修改 DescribeLiveStreamSessionData | 在线人数统计方式新增取值 ClientIP,支持以 1 分钟内的进行拉流请求的客户端 IP 总数作为 1 分钟粒度的在线人数数量。 |
修改 DescribeLiveBatchSourceStreamMetrics | 新增指标聚合算法选择参数 AggType,支持以最大值聚合算法或平均值聚合算法。
同时将 DescribeLiveBatchSourceStreamAvgMetrics 接口移入历史版本接口,并在 3 个月后停止维护,并在 6 个月后下线文档。 |
修改 DescribeLiveSourceTrafficData | 查询结果新增回源带宽监控数据,您可以使用此接口同时查询流量和带宽的监控数据。
同时将 DescribeLiveSourceBandwidthData 接口移入历史版本接口,并在 3 个月后停止维护,并在 6 个月后下线文档。 |
修改 DescribeLiveStreamCountData | 新增查询参数 ISPList 和 UserRegionList,您可以在查询推流流数时使用此参数对数据进行筛选。
同时将 DescribeLivePushStreamCountData 接口移入历史版本接口,并在 3 个月后停止维护,并在 6 个月后下线文档。 |
| 新增 DescribeLiveTopPlayData | 2024-12-09 | 新增查询 TOPN 直播流或域名流量和带宽信息的接口。 |
2024 年 10 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
修改 回调内容说明 | 2024-10-16 | 拉流转推回调消息新增字段 PlayProgress,用于返回点播文件的播放时长(单位:秒)。该字段仅在拉流源为点播文件时(Type=1)返回。 变更影响 - 适用场景:如果您拉取点播源进行转推,此字段可以更精准掌握播放进度,适用于广告插播和内容切换等需要同步进度的场景。
- 无影响场景:如果您使用直播源进行拉流转推,此变更对您无影响。
| 拉流转推回调 |
| 修改 回调内容说明 | 2024-10-11 | 为了支持更大文件的录制,避免因文件过大导致的数据溢出问题,录制回调消息中表示录制文件大小的 size 字段类型由 Integer 更新为 Long。提高处理大文件时的稳定性和准确性。 | 直播录制回调 |
2024 年 09 月
2024 年 08 月
2024 年 07 月
2024 年 06 月
2024 年 05 月
2024 年 04 月
2024 年 03 月
2024 年 02 月
2024 年 01 月
2023 年 12 月
2023 年 11 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 ListDomainDetail | 2023-11-21 | 新增返回参数项目(ProjectName)和标签(Tags)。 | 域名管理 |
| 新增 GetPullRecordTask | 2023-11-17 | 新增接口,支持查询单个直播录制任务。 | 录制配置 |
| 修改 CreateSnapshotPreset | 2023-11-07 | 新增参数覆盖截图存储规则 (OverwriteObject)。 | 截图配置 |
| 修改 UpdateSnapshotPreset |
2023 年 10 月
2023 年 9 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 全部 2023-01-01 全部接口 | 2023-09-25 | 服务端 API 接口升级为 2023-01-01 版本,新版本接口提供了全量业务错误码说明,提升接口使用时的排障效率。 | 关于服务端 API 接口升级至 2023-01-01 版本的公告 |
| 修改 CreatePullToPushTask | 2023-09-04 | 拉流转推增加点播启播时间配置等参数 | 拉流转推 |
| 修改 UpdatePullToPushTask |
2023 年 7 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreateRelaySourceV3 | 2023-07-07 | 触发回源配置结构体变更,新增回源组相关配置 | 回源配置 |
| 修改 DeleteRelaySourceV3 |
| 修改 ListRelaySourceV3 |
2023 年 6 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreateRecordPresetV2 | 2023-06-29 | 录制支持添加 Stream 级别的录制配置,录制到点播时,支持添加分类,选择存储类型为标准存储或归档存储。 | 录制配置 |
| 修改 UpdateRecordPresetV2 |
| 修改 ListVhostRecordPresetV2 |
| 修改 CreateTimeShiftPresetV3 | 新增 Stream 参数。 | 时移配置 |
| 修改 UpdateTimeShiftPresetV3 |
| 修改 ListTimeShiftPresetV2 |
| 修改 DescribeLiveBandwidthData | 新增浙江华数运营商。 | 用量统计 |
| 修改 DescribeLiveTrafficData |
| 修改 DescribeLiveStreamSessionData | 统计分析 |
| 修改 DescribeLiveMetricTrafficData |
| 修改 DescribeLiveMetricBandwidthData |
| 修改 DescribeLiveSourceTrafficData |
| 修改 DescribeLiveSourceBandwidthData |
| 修改 DescribeLivePlayStatusCodeData |
| 删除 UpdateCert | 2023-06-13 | 下线更新证书接口。 | 证书管理 |
| 修改 CreateCert | 添加、删除、绑定和解绑证书接口的参数变更. |
| 修改 DeleteCert |
| 修改 BindCert |
| 修改 UnbindCert |
| 新增 DescribeCertDetailSceretV2 | 新增接口,支持查看证书详情。 | 证书管理 |
| 新增 ListCertV2 | 新增接口,支持查看证书列表。 |
2023 年 5 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 DescribeLiveBatchStreamTranscodeData | 2023-05-26 | 高清低码正式更名为极智超清。 | 统计分析 |
| 修改 CreateTranscodePreset | 转码配置 |
| 修改 UpdateTranscodePreset |
| 修改 DescribeTranscodeData |
| 修改 ListCommonTransPresetDetail |
| 修改 CreatePullToPushTask | 支持点播文件自定义循环次数。 | 拉流转推 |
| 修改 UpdatePullToPushTask |
| 修改 ListPullToPushTask |
| 修改 CreateRecordPresetV2 | 2023-05-22 | 录制到 VoD 新增文件路径参数 | 录制配置 |
| 修改 UpdateRecordPresetV2 |
| 修改 ListVhostRecordPresetV2 |
| 新增 CreateRelaySourceV4 | 2023-05-06 | 新增接口,支持新增固定回源配置。 | 回源配置 |
| 新增 UpdateRelaySourceV4 | 新增接口,支持更新固定回源配置。 |
| 新增 DeleteRelaySourceV4 | 新增接口,支持删除固定回源配置。 |
| 新增 ListRelaySourceV4 | 新增接口,支持查询固定回源配置列表。 |
2023 年 4 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 DescribeLiveP95PeakBandwidthData | 2023-04-24 | 支持传入域名列表,查询每个域名的 95 带宽峰值。 | 用量统计 |
| 修改 GeneratePushURL | 2023-04-13 | 新增生成 WebTransport 网络传输协议推流地址。 | 直播地址 |
| 新增 UpdateStreamQuotaConfig | 2023-04-03 | 新增接口,支持新增推拉流域名限额配置。 | 限额管理 |
| 新增 DescribeStreamQuotaConfig | 新增接口,支持查询推拉流域名限额配置。 |
| 新增 DeleteStreamQuotaConfig | 新增接口,支持删除推拉流域名限额配置。 |
2023 年 3 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 CreateTimeShiftPresetV3 | 2023-03-27 | 级添加、更新和删除时移配置接口为 V3 版本。 | 时移配置 |
| 新增 UpdateTimeShiftPresetV3 |
| 新增 UpdateTimeShiftPresetV3 |
| 新增 CreateRecordPresetV2 | ▪ 升级添加录制配置、更新录制配置和查询录制配置列表接口为 V2 版本。 ▪ 支持 FLV 录制格式。 | 录制配置 |
| 新增 UpdateRecordPresetV2 |
| 新增 ListVhostRecordPresetV2 |
| 修改 UpdateCallback | ▪ 新增回调密钥参数。 ▪ 支持配置截图审核回调。 | 回调配置 |
| 修改 DescribeCallback |
| 修改 DeleteCallback |
| 新增 DescribeIpInfo | 2023-03-07 | 支持查询指定 IP 地址是否属于火山引擎 CDN 节点。 | 统计分析 |
| 修改 DescribeLiveBandwidthData | 2023-03-03 | Aggregation 取值为 300 秒时,支持查询最近 93 天的数据,开始和结束时间的最大时间差为 31 天。 | 用量统计 |
| 修改 DescribeLiveTrafficData |
| 修改 DescribeRecordData |
| 修改 DescribePullToPushBandwidthData |
| 修改 DescribeLiveStreamSessionData | 统计分析 |
| 修改 DescribeLiveMetricTrafficData |
| 修改 DescribeLiveMetricBandwidthData |
| 修改 DescribeLiveSourceTrafficData |
| 修改 DescribeLiveSourceBandwidthData |
| 新增 DescribeLiveBatchPushStreamMetrics | 2023-03-03 | 新增接口,支持批量查询多路推流的监控数据。 | 统计分析 |
| 新增 DescribeLiveBatchSourceStreamMetrics | 新增接口,批量查询多路回源流的监控数据。 |
2023 年 2 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 DescribeLivePlayStatusCodeData | 2023-02-28 | 新增接口,支持查询接口状态码占比。 | 统计分析 |
| 删除 DescribePlayResponseStatusStat | 接口下线,使用新接口替代。 |
| 修改 DescribeLiveDomainLog | 2023-02-27 | 修改日志下载链接有效期为 7 天 | 日志管理。 |
| 修改 DescribeLivePullToPushLog |
2023 年 1 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreatePullToPushTask | 2023-01-13 | 支持通过 Domain、App 和 Stream 创建/更新拉流转推任务。 | 拉流转推 |
| 修改 UpdatePullToPushTask |
| 修改 DescribeTranscodeData | 2023-01-10 | ▪ 新增 TranscodeType 参数。 ▪ 修改 Vcodec 枚举值,并增加表示纯音频的枚举 audio。 | 用量统计 |
| 修改 DescribeLiveP95PeakBandwidthData | 支持筛选大区和协议。 |
| 修改 DescribeLiveBandwidthData | 域名带宽/流量用量包含直播 CDN 和时移分发用量。 |
| 修改 DescribeLiveTrafficData |
| 修改 CreateDomain | 参数 Region 新增 cn-global 和 cn-oversea 2 个枚举值。 | 域名管理 |
| 修改 DescribeDomain |
| 修改 ListDomainDetail |
| 修改 DescribeLiveStreamInfoByPage | 支持查询已删除域名产生的数据。 |
| 修改 DescribeClosedStreamInfoByPage |
| 修改 DescribeLiveBandwidthData | 用量查询 |
| 修改 DescribeLiveTrafficData |
| 修改 DescribeRecordData |
| 修改 DescribeTranscodeData |
| 修改 DescribeSnapshotData | 统计分析 |
| 修改 DescribeLiveAuditData |
| 修改 DescribePushStreamMetrics |
| 修改 DescribeLiveStreamSessionData |
| 修改 DescribeLiveMetricTrafficData |
| 修改 DescribeLiveMetricBandwidthData |
| 修改 DescribePlayResponseStatusStat |
2022 年 12 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreateRecordPreset | 2022-12-26 | 直播录制支持录制 MP4 格式。 | 录制配置 |
| 修改 UpdateRecordPreset |
| 修改 ListVhostRecordPreset |
| 修改 DescribePushStreamMetrics | 2022-12-16 | 删除通过 Vhost 查询推流监控数据 | 统计分析 |
| 新增 DescribeLiveSourceStreamMetrics | 新增接口,支持查询回源流监控数据。 |
| 修改 DescribeLiveStreamInfoByPage | 2022-12-06 | 修改入参中 Vhost 和 Domain 的传参规则。 | 流管理 |
| 修改 DescribeClosedStreamInfoByPage |
2022 年 11 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreateTranscodePreset | 2022-11-14 | 优化新增/更新转码配置接口的参数取值 | 转码配置 |
| 修改 UpdateTranscodePreset |
| 新增 UpdateDenyConfig | 2022-11-02 | 新增接口,支持添加或更新 IP 黑白名单。 |
| 新增 DescribeDenyConfig | 新增接口,支持查询 IP 黑白名单。 |
2022 年 9 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 GeneratePlayURL | 2022-09-27 | 新增接口,支持生成拉流地址。 | 直播地址 |
| 新增 GeneratePushURL | 新增接口,支持生成推流地址。 |
| 修改 DescribeLiveStreamInfoByPage | 2022-09-14 | 支持区分回源流和直播流。 | 流管理 |
| 修改 DescribeClosedStreamInfoByPage |
| 修改 DescribeLiveMetricTrafficData | 使用 Server IP 作为大区和地域归属的筛选参数。 | 统计分析 |
| 修改 DescribeLiveMetricBandwidthData |
| 修改 DescribeLiveSourceTrafficData | 支持回源流量和带宽的查询。 |
| 修改 DescribeLiveSourceBandwidthData |
2022 年 8 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 CreateSnapshotAuditPreset | 2022-08-17 | 新增接口,支持添加截图审核配置。 | 截图审核 |
| 新增 ListVhostSnapshotAuditPreset | 新增接口,支持查询截图审核配置列表。 |
| 新增 UpdateSnapshotAuditPreset | 新增接口,支持更新截图审核配置。 |
| 新增 DeleteSnapshotAuditPreset | 新增接口,支持删除截图审核配置。 |
| 新增 DescribeLiveAuditData | 新增接口,支持查询截图审核用量 | 用量查询 |
2022 年 7 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 修改 CreateRecordPreset | 2022-07-29 | 修改创建和更改录制配置的拼接规则参数取值。 | 录制配置 |
| 修改 UpdateRecordPreset |
| 修改 CreateTranscodePreset | 修改转码音频编码格式和 B 帧数参数。 | 转码配置 |
| 修改 ListVhostTransCodePreset |
| 修改 UpdateTranscodePreset |
| 修改 ListCommonTransPresetDetail |
| 新增 DescribeLivePullToPushLog | 2022-07-11 | 新增接口,支持查询拉流转推日志文件。 | 日志管理 |
| 新增 DescribePullToPushBandwidthData | 2022-07-08 | 新增接口,支持查询拉流转推代用用量。 | 用量查询 |
2022 年 6 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 UpdateTranscodePreset | 2022-06-20 | 新增接口,支持更新转码配置。 | 转码配置 |
| 新增 ListCommonTransPresetDetail | 新增接口,支持查询通用转码。 |
| 新增 CreateCert | 2022-06-17 | 新增接口,支持添加证书。 | 证书管理 |
| 新增 UpdateCert | 新增接口,支持更新证书。 |
| 新增 ListCert | 新增接口,支持查询证书列表。 |
| 新增 BindCert | 新增接口,支持绑定证书。 |
| 新增 UnbindCert | 新增接口,支持解绑证书。 |
| 新增 CreateRecordPreset | 新增接口,支持添加录制配置。 | 录制配置 |
| 新增 CreateWatermarkPreset | 新增接口,支持添加水印配置。 | 水印配置 |
| 新增 DeleteWatermarkPreset | 新增接口,支持删除水印配置。 |
| 新增 UpdateWatermarkPreset | 新增接口,支持更新水印配置。 |
| 新增 ListWatermarkPreset | 新增接口,支持查询水印配置。 |
| 新增 ListVhostWatermarkPreset | 新增接口,支持查询水印配置列表。 |
| 新增 DescribeLiveMetricTrafficData | 2022-06-06 | 新增接口,支持查询直播流或域名流量监控数据。 | 统计分析 |
| 新增 DescribeLiveMetricBandwidthData | 新增接口,支持查询直播流或域名带宽监控数据。 |
2022 年 5 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 CreateTranscodePreset | 2022-05-20 | 新增接口,支持添加转码配置。 | 转码配置 |
| 新增 DeleteTranscodePreset | 新增接口,支持删除转码配置。 |
| 新增 ListVhostTransCodePreset | 新增接口,支持查询转码配置列表。 |
| 新增 CreateSnapshotPreset | 2022-05-19 | 新增接口,支持添加截图配置。 | 截图配置 |
| 新增 DeleteSnapshotPreset | 新增接口,支持删除截图配置。 |
| 新增 UpdateSnapshotPreset | 新增接口,支持更新截图配置。 |
| 新增 ListVhostSnapshotPreset | 新增接口,支持查询截图配置列表。 |
2022 年 4 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 DescribeSnapshotData | 2022-04-22 | 新增接口,支持查询直播域名截图张数。 | 用量查询 |
| 新增 ListVhostRecordPreset | 2022-04-20 | 新增接口,支持查询录制配置列表。 | 录制配置 |
| 新增 UpdateRecordPreset | 新增接口,支持更新录制配置。 |
| 新增 DeleteRecordPreset | 新增接口,支持删除录制配置。 |
| 新增 CreateTimeShiftPresetV2 | 2022-04-19 | 新增接口,支持添加直播时移配置。 | 时移配置 |
| 新增 DeleteTimeShiftPresetV2 | 新增接口,支持删除直播时移配置。 |
| 新增 UpdateTimeShiftPresetV2 | 新增接口,支持更新直播时移配置。 |
| 新增 ListTimeShiftPresetV2 | 新增接口,支持查询直播时移配置列表。 |
2022 年 2 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 DescribeLiveDomainLog | 2022-02-24 | 新增接口,支持查询日志文件信息。 | 日志管理 |
| 新增 DescribeLiveTimeShiftData | 新增接口,支持查询直播时移存储用量。 | 用量查询 |
| 新增 DescribeLiveStreamState | 2022-02-09 | 新增接口,支持查询流状态。 | 流管理 |
2022 年 1 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 CreatePullToPushTask | 2022-01-18 | 新增接口,支持创建拉流转推任务。 | 拉流转推 |
| 新增 ListPullToPushTask | 新增接口,支持获取拉流转推任务列表。 |
| 新增 UpdatePullToPushTask | 新增接口,支持修改拉流转推任务。 |
| 新增 DeletePullToPushTask | 新增接口,支持删除拉流转推任务。 |
| 新增 RestartPullToPushTask | 新增接口,支持重启拉流转推任务。 |
| 新增 StopPullToPushTask | 新增接口,支持停用拉流转推任务。 |
2021 年 12 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 DescribePushStreamMetrics | 2021-12-03 | 新增接口,支持查询推流监控数据。 | 统计分析 |
| 新增 DescribeLiveStreamSessionData | 2021-12-02 | 新增接口,支持查询直播流历史请求数和在线人数。 |
| 新增 DescribePlayResponseStatusStat | 新增接口,支持查询域名 HTTP 返回码展播。 |
| 新增 DescribeLiveBandwidthData | 新增接口,支持查询直播域名带宽用量。 | 用量查询 |
| 新增 DescribeLiveTrafficData | 新增接口,支持查询直播域名流量用量。 |
| 新增 DescribeRecordData | 新增接口,支持查询直播域名录制用量。 |
| 新增 DescribeTranscodeData | 新增接口,支持查询直播域名转码用量。 |
| 新增 DescribeSnapshotData | 新增接口,支持查询直播域名截图数量。 |
2021 年 11 月
| API | 发布时间 | 变更记录 | 关联功能 |
|---|
| 新增 DeleteCallback | 2021-11-23 | 新增接口,支持删除回调配置。 | 回调管理 |
| 新增 UpdateCallback | 新增接口,支持设置回调配置。 |
| 新增 DescribeCallback | 新增接口,支持查询回调配置。 |
| 新增 CreateDomain | 2021-11-10 | 新增接口,支持添加域名。 | 域名管理 |
| 新增 ListDomainDetail | 新增接口,支持查询域名列表。 |
| 新增 DeleteDomain | 新增接口,支持删除域名。 |
| 新增 DescribeDomain | 新增接口,支持查询域名信息。 |
| 新增 EnableDomain | 新增接口,支持启用域名。 |
| 新增 DisableDomain | 新增接口,支持禁用域名。 |
| 新增 ManagerPullPushDomainBind | 新增接口,支持修改推拉流域名绑定关系。 |
| 新增 UpdateAuthKey | 新增接口,支持新增或修改推拉流鉴权配置。 | 安全管理 |
| 新增 DescribeAuth | 新增接口,支持查询推拉流鉴权配置。 |
| 新增 UpdateReferer | 新增接口,支持设置 Referer 黑白名单。 |
| 新增 DiscribeReferer | 新增接口,支持查询 Referer 黑白名单。 |
| 新增 DeleteReferer | 新增接口,支持删除 Referer 黑白名单。 |
| 新增 DescribeLiveStreamInfoByPage | 新增接口,支持查询域名在线流列表。 | 流管理 |
| 新增 DescribeClosedStreamInfoByPage | 新增接口,支持查询域名历史流列表。 |
| 新增 KillStream | 新增接口,支持断开直播流。 |
| 新增 ForbidStream | 新增接口,支持禁推直播流。 |
| 新增 DescribeForbiddenStreamInfoByPage | 新增接口,支持查询禁推直播流列表。 |
| 新增 ResumeStream | 新增接口,支持恢复禁推直播流。 |