排障指南--视频点播-火山引擎

文档中心

简体

文档备案控制台

登录立即注册

视频点播

视频点播

视频点播

文档指南

请输入

产品动态

功能发布历史

关于 Web 播放器 SDK 正式商业化并启用 License 校验的公告

关于部分媒体处理功能进行调整的公告

关于尽快升级旧版本服务端 SDK 的公告

关于视频点播推出特惠体验资源包套餐的公告

产品简介

产品功能

媒资存储管理

音视频播放

产品计费

计费方式

媒资存储计费

媒体处理计费

智能应用 Aideo Agent 计费

分发加速计费

视频剪辑计费

播放器 SDK 计费

视频 AI 应用

视频点播-智能应用 Aideo Agent (Beta)

Aideo Agent 快速开始

通过 API 接入 Aideo Agent

短剧高光智剪

短剧高光智剪快速开始

通过 API 接入短剧高光智剪

AI 视频翻译（声影智译）

AI 视频翻译快速开始

通过 API 接入 AI 视频翻译

AI 短剧解说生成

AI 短剧二创解说快速开始

通过 API 生成解说视频

长视频理解

精细化字幕擦除

人声背景音分离

AI 漫剧转绘

AI 文字成片

AI 剧本还原

OCR 提取字幕

智能分段摘要

智能场景切分

AI 剧情故事线分析

巨量广告预审

使用动态输入 Schema 实现任务串联

OpenAPI 参考

如何调用 OpenAPI

StartExecution - 提交媒体处理任务

GetExecution - 获取媒体处理任务执行结果

Aideo Agent

SubmitAideoTaskAsync - 提交智能视频处理任务

GetAideoTaskResult - 获取智能视频处理任务结果

AI 视频翻译

翻译项目与工作流管理

SubmitAITranslationWorkflow - 提交 AI 翻译任务

ListAITranslationProject - 获取 AI 翻译项目列表

GetAITranslationProject - 获取 AI 翻译项目详细信息

RefreshAITranslationProject - 导出 AI 翻译项目产物

ContinueAITranslationWorkflow - 恢复 AI 翻译工作流

UpdateAITranslationProjectConfig - 更新 AI 翻译项目配置

字幕句段管理

CreateAITranslationUtterance - 创建 AI 翻译项目的字幕句段

RemoveAITranslationUtterance - 删除 AI 翻译项目的字幕句段

UpdateAITranslationUtterances - 更新 AI 翻译项目字幕文本

GenerateAITranslationUtteranceAudio - 生成 AI 翻译文本音频

说话人和音色管理

CreateAITranslationSpeaker - 创建 AI 语音翻译的说话人

UpdateAITranslationSpeakers - 更新 AI 翻译说话人信息

CreateAITranslationSpeech - 创建 AI 语音翻译的自定义音色

UpdateAITranslationSpeeches - 更新 AI 语音翻译的自定义音色

ListAITranslationSpeech - 获取 AI 语音翻译的音色

DeleteAITranslationSpeech - 删除 AI 语音翻译的自定义音色

术语库管理

CreateAITermbase - 创建 AI 翻译术语库

UpdateAITermbase - 更新 AI 翻译术语库

SetAITermItem - 向术语库添加术语

GetAITermbase - 获取 AI 翻译术语库信息

DeleteAITermItem - 从术语库删除术语

DeleteAITermbase - 删除 AI 翻译术语库

ListAITermbase - 获取术语库列表

AI 解说生成

CreateDramaRecapTask - 创建解说视频生成任务

QueryDramaRecapTask - 查询短剧解说生成任务结果

AI 剧本还原

CreateDramaScriptTask - 创建剧本还原任务

QueryDramaScriptTask - 查询剧本还原任务结果

AI 智剪

AsyncVCreativeTask - 提交 AI 视频智剪任务

GetVCreativeTaskResult - 获取 AI 智剪任务结果

用户指南

用户指南概述

媒资上传及存储

媒资上传概述

工具上传

通过控制台上传媒资

通过 PC 客户端工具批量上传媒资

使用数据迁移工具

开发上传

服务端上传

客户端上传

上传功能函数说明

上传及存储设置

跨地域上传加速

媒资存储类型

媒资管理

媒资管理概述

管理媒资信息

设置视频封面

修改音视频发布状态

下载媒体文件

音视频分类

跨地域媒资同步

删除媒体文件

媒体处理

媒体处理概述

音视频转码

音视频转码

自适应码流转码

画质检测 VQScore

画质增强修复

视频截图

生成和使用雪碧图

视频水印

暗水印（数字水印）

视频实时处理

多媒体 AI

媒体处理模板

媒体处理模板概述

视频转码模板

极智超清模板

自适应码流模板

音频转码模板

水印贴片模板

自定义转码组

画质增强修复模板

检测修复模板

多媒体 AI 模板

智能字幕模板

智能转码策略

视频剪辑

视频剪辑概述

通过控制台进行剪辑

通过 OpenAPI 进行视频剪辑

视频剪辑 Web SDK

集成视频剪辑 Web SDK

CDN 分发加速

域名接入

域名接入概述

校验域名归属权

配置 SSL 证书

域名调度配置

域名配置

域名配置概述

访问控制

配置 Referer 黑白名单

配置 IP 黑白名单

配置时间戳防盗链

URL 鉴权

URL 鉴权概述

A 类型签名工具

配置 UA 黑白名单

配置 Origin 黑白名单

配置远程鉴权

地域访问限制

禁用 HTTP 请求方法

配置下载限速

回源配置

配置回源重定向跟随

配置回源 HOST

配置回源协议

配置回源 SNI

配置回源超时时间

配置 HTTP 请求头

配置回源参数

配置回源 URL 改写

协议配置

配置强制跳转

配置 TLS 版本控制

配置 QUIC 协议

缓存配置

配置缓存键值

配置缓存规则

配置状态码缓存

高级配置

配置 HTTP 响应头

配置 HLS 标准加密改写

配置重定向回源规则

IP 归属查询

CDN 日志管理

获取 CDN 日志

CDN 日志投递

音视频播放

音视频播放概述

通过播放地址播放

通过临时播放 Token 播放

常见播放配置

媒资安全

媒资安全概述

视频加密

火山引擎私有加密（新版）

HLS 标准加密（新版）

火山引擎私有加密（旧版）

HLS 标准加密（旧版）

事件通知

事件通知概述

通过控制台配置回调

HTTP 回调鉴权

事件列表

媒资上传完成事件

URL 批量拉取上传完成事件

素材上传完成事件

媒资上传提取元信息完成事件

视频文件删除完成事件

素材文件删除完成事件

媒体处理产物删除完成事件

工作流执行完成事件

媒体处理任务执行完成事件

视频剪辑完成事件

媒资存储类型修改完成事件

文件同步完成事件

DirectUrl 模式媒资上传完成

AI 翻译任务执行完成事件

剧本还原任务完成事件

解说视频生成完成事件

AI 智剪任务完成事件

数据服务

质量平台

质量平台概述

质量平台 Demo

告警管理

飞书通知使用说明

质量平台设置

指标与维度说明

通用指标说明

通用维度说明

播放器起播逻辑说明

旧版文档

播放看板（旧版）

指标拆维（旧版）

通过 Exporter 导出视频点播监控数据至 Prometheus

账号和授权

账号与授权概述

创建子账号并授权

创建自定义权限策略

常见权限问题

播放器 SDK

SDK 发布历史

Android 播放器 SDK

iOS 播放器 SDK

Web 播放器 SDK

Flutter 播放器 SDK

React Native 播放器 SDK

HarmonyOS NEXT 播放器 SDK

小程序播放器 SDK

uni-app 播放器 SDK

播放器 License

Android 播放器 SDK

含 UI 集成方案

核心类使用

进阶功能使用

不含 UI 集成方案

进阶功能

添加外挂字幕

自定义预加载

播放 HDR 视频

播放 H.265 视频

自定义用户 ID

播放源过期自动刷新

多路流管理

ABR 播放

自研协议 ABR 播放

标准协议 ABR 播放

构造 VideoModel 播放源

起播选档

自研协议视频的起播选档

标准协议视频的起播选档

客户端超分

故障排除

使用 Debug 工具

抖音同款短视频最佳实践

西瓜视频同款中视频最佳实践

SDK API 参考

iOS 播放器 SDK

含 UI 集成方案

核心类使用

进阶功能使用

不含 UI 集成方案

进阶功能

使用 Debug 工具

播放 HDR 视频

播放 H.265 视频

自定义预加载

添加外挂字幕

自定义用户 ID

播放源过期自动刷新

多路流管理

构造 VideoModel 播放源

排障指南

获取 SDK 日志

抖音同款短视频最佳实践

西瓜视频同款中视频最佳实践

SDK API 参考

升级指南

动态库升级指南

Web 播放器 SDK

进阶功能

播放 HLS 视频

播放私有加密视频（新版）

播放 DASH 视频

播放 H.265 视频

多码率自适应播放

播放私有加密视频（旧版）

播放 HLS 标准加密视频（旧版）

SDK API 参考

播放器内核

Flutter 播放器 SDK

进阶功能

多路流管理

播放 H.265 视频

短视频场景开启预加载和预渲染策略

自定义预加载

自研协议的起播选档

React Native 播放器 SDK

进阶功能

预加载和预渲染策略

自定义预加载

uni-app 播放器 SDK

HarmonyOS NEXT 播放器 SDK

小程序播放器 SDK

集成微信小程序 SDK

集成抖音小程序 SDK

uni-app/Taro 集成小程序 SDK

集成快应用小程序 SDK

播放器 SDK 错误码

播放器 SDK 常见问题

历史文档

Android 播放器 SDK 使用文档（历史版本）

iOS 快速开始（历史版本）

HarmonyOS NEXT 播放器 SDK 使用文档（历史版本）

上传 SDK

Android 上传 SDK

iOS 上传 SDK

Web 上传 SDK

Flutter 上传 SDK

HarmonyOS NEXT 上传 SDK

小程序上传 SDK

集成小程序上传 SDK

上传 SDK 错误码

历史文档

Android 视频上传 SDK（历史版本）

Android 素材上传 SDK（历史版本）

iOS 视频上传 SDK（历史版本）

iOS 素材上传 SDK（历史版本）

上传错误码（历史版本）

小程序上传 SDK（历史版本）

服务端 API 参考

API 发布历史

使用 API Explorer

公共错误码

空间管理

CreateSpace - 创建空间

ListSpace - 获取空间列表

GetSpaceDetail - 获取空间详细信息

UpdateSpace - 更新空间信息

UpdateUploadSpaceConfig - 更新空间上传配置

DescribeUploadSpaceConfig - 获取空间上传配置

媒资上传

ApplyUploadInfo - 获取上传地址和凭证

CommitUploadInfo - 确认上传

UploadMediaByUrl - URL 批量拉取上传

QueryUploadTaskInfo - 查询 URL 批量上传任务状态

媒资管理

GetMediaInfos - 获取媒资信息

GetMediaList - 获取音视频信息

UpdateMediaInfo - 更新媒资信息

UpdateMediaPublishStatus - 修改媒资发布状态

UpdateMediaStorageClass - 修改媒资存储类型

DeleteMedia - 删除完整媒资

DeleteTranscodes - 删除媒体处理输出文件

DeleteMaterial - 删除素材文件

SubmitMoveObjectTask - 提交跨空间文件迁移任务

QueryMoveObjectTaskInfo - 查询跨空间文件迁移任务状态

ListSnapshots - 获取截图结果

GetRecommendedPoster - 获取封面候选结果

UpdateSubtitleStatus - 修改字幕发布状态

UpdateSubtitleInfo - 更新字幕信息

GetSubtitleInfoList - 获取字幕文件

ListVideoClassifications - 查询视频分类

CreateVideoClassification - 创建视频分类

DeleteVideoClassification - 删除视频分类

UpdateVideoClassification - 更新视频分类

SubmitBlockObjectTasks - 提交媒资封禁或解禁任务

ListBlockObjectTasks - 获取媒资封禁或解禁任务

GetFileInfos - 根据文件路径获取文件信息

ListFileMetaInfosByFileNames - 根据文件路径获取媒资信息

UpdateFileStorageClass - 修改文件存储类型

DeleteMediaTosFile - 根据文件路径删除媒体文件

GetInnerAuditURLs - 获取内网地址

视频剪辑

剪辑任务管理

SubmitDirectEditTaskAsync - 提交异步剪辑任务

SubmitDirectEditTaskSync - 提交同步剪辑任务

CancelDirectEditTask - 取消异步剪辑任务

GetDirectEditResult - 查询剪辑任务详情

GetDirectEditProgress - 查询剪辑任务进度

SubmitEditTaskAsync - 提交工程化异步剪辑任务

GetTaskList - 获取工程化剪辑任务列表

DeleteTask - 删除工程化剪辑任务记录

剪辑工程管理

CreateProject - 创建剪辑工程

SearchGlobalProject - 查询所有剪辑工程

DeleteProject - 删除剪辑工程

UpdateProject - 更新剪辑工程

DescribeProject - 获取剪辑工程

剪辑素材管理

CreateEditMaterial - 向工程添加剪辑素材

DeleteEditMaterial - 从剪辑工程中移除素材

SearchEditMaterial - 搜索剪辑素材

GetURLsByStoreURIs - 获取封面图地址

GetEffectList - 获取特效列表

SearchVideo - 搜索视频

GetVideoPlayInfo - 获取视频播放信息

MGetMaterial - 批量获取素材

媒体处理

StartWorkflow - 触发工作流

RetrieveTranscodeResult - 获取转码结果

GetWorkflowExecution - 获取工作流运行状态

GetWorkflowExecutionResult - 获取工作流执行结果

GetAdAuditResultByVid - 获取广告预审结果

音视频播放

GetPlayInfo - 获取播放地址

CreateHlsDecryptionKey - 创建 HLS 标准加密密钥

点播 CDN

CreateDomain - 添加域名

StartDomain - 启用域名

StopDomain - 停用域名

DeleteDomain - 删除域名

ListDomain - 获取空间域名列表

AddDomainToScheduler - 将域名添加至点播调度

RemoveDomainFromScheduler - 将域名从点播调度移除

UpdateDomainPlayRule - 设置多域名调度策略

UpdateDomainExpire - 更新域名时间戳防盗链配置

GetDomainPlayRule - 获取多域名调度策略

UpdateDomainAuthConfig - 更新域名 URL 鉴权配置

UpdateDomainConfig - 更新域名配置

DescribeDomainConfig - 查询域名配置

DescribeDomainVerifyContent - 获取归属权校验内容

VerifyDomainOwner - 校验域名归属权

CreateCdnRefreshTask - 创建缓存刷新任务

CreateCdnPreloadTask - 创建内容预热任务

ListCdnTasks - 获取刷新预热任务列表

DescribeCdnEdgeIp - 查询域名所属边缘节点 IP

DescribeCdnRegionAndIsp - 获取支持的区域和 ISP 列表

数据统计

DescribeVodDomainBandwidthData - 查询带宽用量

DescribeVodDomainTrafficData - 查询流量用量

DescribeVodSpaceStorageData - 查询存储用量

DescribeVodSpaceTranscodeData - 查询转码用量

DescribeVodEnhanceImageData - 查询画质增强用量

DescribeVodSnapshotData - 查询截图用量

DescribeVodSpaceDetectStatisData - 查询检测修复用量

DescribeVodSpaceAIStatisData - 查询多媒体 AI 用量

DescribeVodSpaceSubtitleStatisData - 查询智能字幕用量

DescribeVodSpaceEditStatisData - 查询视频剪辑用量

DescribeVodRealtimeMediaData - 查询实时处理用量

DescribeVideoStreamOutData - 查询存储流出流量

DescribeVodSpaceWorkflowDetailData - 查询转码详细数据

DescribeVodSpaceEditDetailData - 查询视频剪辑详细数据

DescribeVodRealtimeMediaDetailData - 查询实时处理详细数据

DescribeVodQUICRequestData - 查询 QUIC 用量

ListCdnUsageData - 获取带宽流量

ListCdnPvData - 获取请求数

ListCdnStatusData - 获取状态码

ListCdnHitrateData - 获取命中率

ListCdnTopAccess - 获取热点统计数据

DescribeVodPathRequestData - 按目录维度获取监控数据

DescribeVodPlayedStatisData - 查询视频播放信息

DescribeVodMostPlayedStatisData - 查询播放 TopN 的视频

DescribeVodVidTrafficFileLog - 查询播放统计文件下载地址

GetVodMediaPlayData - 获取播放质量数据

工具服务

ListCdnAccessLog - 获取日志文件下载地址

DescribeIpInfo - 查询 IP 归属信息

事件通知

SetCallbackEvent - 设置回调事件

AddCallbackSubscription - 添加回调订阅地址

GetCallbackRecordV2 - 获取回调记录

历史版本

版本号 2022-12-01

查询媒资信息

查询转码详细数据

查询视频剪辑详细数据

版本号 2022-01-01

UpdateSpaceUploadConfig - 更新空间上传配置

版本号 2021-01-01

查询媒资存储流量用量

版本号 2020-08-01

获取热点 URL 统计

获取上传地址和凭证

用量查询

查询带宽用量

查询流量用量

查询存储用量

查询转码用量

查询截图用量

查询画质增强用量

查询检测修复用量

查询多媒体 AI 用量

查询智能字幕用量

查询视频剪辑用量

附录

工作流状态码

文件命名通用字符规则

幂等行为说明

国家、地区和运营商对照表

视频剪辑错误码

简单 HLS 剪辑

服务端 SDK

服务端 SDK 概述

V1.0

Java SDK

集成 Java SDK

音视频播放

Python SDK

集成 Python SDK

音视频播放

PHP SDK

音视频播放

Go SDK

音视频播放

Node.js SDK

集成 Node.js SDK

音视频播放

V2.0 SDK 介绍与迁移说明

场景方案

短剧场景

短剧场景概述

集成 Android 短剧 Demo

集成 iOS 短剧 Demo

短剧出海场景解决方案

最佳实践

基于 VePlayer 的 H5 短剧应用开发最佳实践

短视频场景最佳实践

内容创作者场景最佳实践

H.265 全链路方案

RTC 录制转点播存储管理

直播录制转点播存储管理

使用 veImageX 实时处理点播空间存储图片

Vid 模式与 DirectUrl 模式说明

视频点播接入云监控查看监控和配置策略

如何使用质量平台排查异常播放数据

内网上传下载

常见问题

费用常见问题

媒资上传相关

质量平台相关

事件通知常见问题

视频播放相关

点播 CDN 常见问题

相关协议

视频云服务专用条款

视频点播服务等级协议

视频点播 SDK 相关协议

视频点播 SDK 隐私政策

视频点播 SDK 开发者使用合规规范

视频点播上传 SDK 相关协议

视频点播上传 SDK 隐私政策

视频点播上传 SDK 开发者使用合规规范

文档首页

视频点播

播放器 SDK

iOS 播放器 SDK

不含 UI 集成方案

排障指南

不含 UI 集成方案

排障指南

获取 SDK 日志