# 阿里云视频点播 ApsaraVideo VOD

> 阿里云视频点播（ApsaraVideo VOD）是一站式音视频点播解决方案，提供视频上传、存储、转码、AI处理、CDN加速分发和播放的完整服务端能力。面向视频网站、短视频、在线教育、微短剧等场景。
>
> API 版本：2017-03-21 | 接入地址：`vod.{regionId}.aliyuncs.com`
>
> 本文档同时包含服务端能力与客户端 SDK（播放器/短视频/客户端上传）的完整内容。

## Quick start: 你想做什么？

- **上传视频到点播** → [媒体上传概述](./媒体上传/媒体上传概述.md)，然后看 [服务端上传](./媒体上传/服务端上传.md)
- **获取播放地址给前端** → [播放音视频](./音视频播放/播放音视频.md)
- **对视频做转码/截图/水印** → [媒体处理概述](./媒体处理/媒体处理概述.md)
- **搜索和管理媒资** → [媒资管理概述](./媒资管理/媒资管理概述.md)
- **配置视频加密防盗** → [媒体安全概述](./安全与访问控制/媒体安全概述.md)
- **集成服务端SDK** → [服务端SDK](./服务端SDK/服务端SDK.md)
- **接收异步事件通知** → [事件通知概述](./事件通知/事件通知_2.md)
- **用API合成剪辑视频** → [云剪辑概述](./云剪辑/云剪辑概述.md)
- **集成客户端播放器** → [Android 播放器 SDK](./端侧播放器/player-atomic-android.md) / [iOS 播放器 SDK](./端侧播放器/player-atomic-ios.md) / [Web 播放器 SDK](./端侧播放器/player-atomic-web.md)
- **接入短视频拍摄编辑** → [Android 短视频 SDK](./端侧短视频/short-video-android.md) / [iOS 短视频 SDK](./端侧短视频/short-video-ios.md)
- **客户端上传视频** → [客户端上传](./端侧上传/客户端上传.md)
- **查看完整API列表** → [API概览](./API参考/API概览.md)

## Common mistakes to avoid

- **用主账号 AccessKey 调用 API。** 必须创建 RAM 子账号并授予最小权限，主账号 AK 泄露会导致全部资源被控制。
- **上传凭证过期后重新调 CreateUploadVideo。** 凭证有效期 3000s，过期后应调 RefreshUploadVideo 刷新，重新创建会产生新 VideoId。
- **轮询 API 查转码/上传状态。** 应配置事件通知（HTTP回调/MNS），收到 TranscodeComplete 等事件后再处理。
- **混淆 VideoId 和播放 URL。** VideoId 用于管理，播放必须通过 GetPlayInfo 获取转码后地址，不要拼源文件 URL。
- **URL 拉取上传时未编码。** UploadMediaByURL 要求 URL 经过 URLEncode，含特殊字符的 URL 会导致上传失败。
- **超 QPS 限制未做退避重试。** 超频返回 Throttling.User（HTTP 400），需客户端实现指数退避或申请提升配额。

## 产品概述

- [什么是视频点播](./产品介绍/什么是视频点播.md): 产品定义、系统架构和核心能力的整体介绍
- [基本概念](./产品介绍/基本概念.md): 封装格式、编码方式、转码、分辨率、码率等核心术语解释
- [使用限制](./产品介绍/使用限制.md): 资源配额上限（域名/模板/分类等）和 API 调用频率限制
- [服务接入点](./产品介绍/服务接入点.md): 各地域的公网和 VPC 接入地址列表
- [开通视频点播](./产品介绍/开通视频点播.md): 开通服务的前置条件和操作步骤

## 媒体上传

- [媒体上传概述](./媒体上传/媒体上传概述.md): 支持的媒体格式、所有上传方式对比和功能差异说明
- [上传地址和凭证](./媒体上传/上传地址和凭证.md): 上传凭证的获取、解码、使用和刷新机制说明
- [服务端上传](./媒体上传/服务端上传.md): 服务端上传 SDK 的使用场景、流程和各语言（Java/Python/PHP/C++）操作指引
- [URL拉取上传](./媒体上传/URL拉取上传.md): 通过 UploadMediaByURL 从公网 URL 批量拉取文件上传到点播
- [OSS上传](./媒体上传/OSS上传.md): 基于 OSS 原生 SDK 实现上传的完整流程（适用于无上传 SDK 的语言）
- [分片上传](./媒体上传/分片上传.md): 大文件分片上传和断点续传的机制说明

## 媒体处理

- [媒体处理概述](./媒体处理/媒体处理概述.md): 媒体处理整体能力（转码/截图/动图/水印/数字水印/工作流等）、调用方式、处理流程和场景导航
- [音视频转码](./媒体处理/音视频转码.md): 转码功能介绍、触发方式、普通/窄带高清选择和转码模板管理
- [视频截图](./媒体处理/视频截图.md): 指定时间点截图、雪碧图截图和截图模板的使用方法
- [视频图文水印](./媒体处理/视频图文水印.md): 为视频添加图片水印、文字水印的配置和模板管理
- [视频动图](./媒体处理/视频动图.md): 将视频片段转换为 GIF/WebP 动图及动图模板管理
- [数字水印](./媒体处理/数字水印.md): 隐形数字水印嵌入与提取，用于版权溯源和泄露追踪
- [工作流](./媒体处理/工作流.md): 上传后自动触发转码/截图/审核等处理任务的配置方法
- [多码率自适应转码](./媒体处理/多码率自适应转码.md): HLS/DASH 多码率打包配置，实现播放端自适应切换
- [媒体处理参数说明](./媒体处理/媒体处理参数说明.md): 转码、截图、动图等处理接口的参数详细说明

## 媒资管理

- [媒资管理概述](./媒资管理/媒资管理概述.md): 媒资类型、管理功能和使用场景的整体介绍
- [搜索媒资信息](./媒资管理/搜索媒资信息.md): 通过 SearchMedia 接口按条件筛选查询音视频、图片等媒资
- [媒资搜索协议](./媒资管理/媒资搜索协议.md): SearchMedia 的查询语法、可用字段和排序规则
- [媒体存储](./媒资管理/媒体存储.md): 存储 Bucket 管理、分级存储（标准/低频/归档）和存储类型变更
- [下载媒体文件](./媒资管理/下载媒体文件.md): 源文件和转码文件的下载方式及安全下载配置
- [删除媒体文件](./媒资管理/删除媒体文件.md): 删除源文件、转码流、截图等资源的操作方式和注意事项

## 音视频播放

- [播放音视频](./音视频播放/播放音视频.md): 服务端获取播放信息的完整流程，包含地址播放和凭证播放两种方式
- [获取播放地址](./音视频播放/获取播放地址.md): 通过 GetPlayInfo 获取转码后各清晰度的播放 URL
- [获取播放凭证](./音视频播放/获取播放凭证.md): 通过 GetVideoPlayAuth 获取播放器 SDK 所需的播放凭证
- [播放鉴权方案](./音视频播放/播放鉴权方案.md): URL 鉴权机制和安全播放方案的设计说明
- [试看视频](./音视频播放/试看视频.md): 通过 PreviewTime 参数实现视频部分试看功能的服务端配置
- [播放常见设置](./音视频播放/播放常见设置.md): 清晰度切换、输出格式、CDN 域名指定等常见播放配置

## 媒体安全

- [媒体安全概述](./安全与访问控制/媒体安全概述.md): 所有安全机制（访问限制/URL鉴权/加密/安全下载）的对比和选型指南
- [创建RAM用户并授权](./安全与访问控制/创建RAM用户并授权.md): 创建子账号并授予视频点播最小权限的操作步骤
- [STS临时Token](./安全与访问控制/STS临时Token.md): 通过 STS 获取临时 AccessKey 用于客户端安全上传/播放
- [凭证方式与STS方式对比](./安全与访问控制/凭证方式与STS方式对比.md): 上传凭证/播放凭证与 STS 方式的区别和适用场景选择
- [视频加密保护内容安全](./安全与访问控制/视频加密保护内容安全.md): 三种加密方案（私有加密/HLS标准加密/DRM）的对比和接入指南
- [HLS标准加密](./安全与访问控制/HLS标准加密.md): 基于 AES-128 的 HLS 加密方案配置和密钥管理说明
- [DRM加密](./安全与访问控制/DRM加密.md): Widevine/FairPlay DRM 数字版权管理加密的接入方法

## 媒体审核

- [智能审核](./媒体审核/智能审核.md): AI 自动检测视频中的违规内容（涉黄/暴恐/涉政等）并返回审核结果
- [人工审核](./媒体审核/人工审核.md): 通过 API 对视频设置人工审核状态和获取审核历史
- [审核安全IP](./媒体审核/审核安全IP.md): 配置允许预览未审核通过视频的安全 IP 白名单

## 视频AI

- [视频AI概述](./视频AI/视频AI概述.md): 所有视频 AI 能力（审核/DNA/标签/封面/字幕等）的功能介绍和对比
- [智能封面](./视频AI/智能封面.md): AI 自动分析视频内容并提取最优帧作为封面图
- [智能标签](./视频AI/智能标签.md): AI 识别视频中的人物、场景、物体等并生成多维度分类标签
- [智能高光片段提取](./视频AI/智能高光片段提取.md): AI 自动识别视频中的精彩片段并输出时间区间
- [字幕提取](./视频AI/字幕提取.md): 基于语音识别自动生成字幕文件（SRT/VTT）
- [字幕擦除](./视频AI/字幕擦除.md): AI 检测并擦除视频画面中的硬编码字幕
- [AI视频翻译](./视频AI/AI视频翻译.md): 将视频中的语音和字幕翻译为目标语言并重新合成

## 云剪辑

- [云剪辑概述](./云剪辑/云剪辑概述.md): 云剪辑系统架构、核心链路（合成服务+工程管理）和费用说明
- [剪切合并](./云剪辑/剪切合并.md): 通过 Timeline 对视频进行时间维度的裁剪和多段拼接合成
- [音频处理](./云剪辑/音频处理.md): Timeline 中的音频混合、静音、音量调节和多轨配置
- [图片叠加](./云剪辑/图片叠加.md): 在视频画面上叠加图片素材（Logo/贴纸/遮标）
- [文字叠加](./云剪辑/文字叠加.md): 在视频画面上叠加动态文字（标题/花字/字幕）
- [特效](./云剪辑/特效.md): 视频转场效果和滤镜特效的 Timeline 配置方法
- [Timeline配置示例](./云剪辑/Timeline配置示例.md): 完整的 Timeline JSON 结构示例和字段说明
- [常见Timeline示例](./云剪辑/常见Timeline示例.md): 常见剪辑场景（拼接/画中画/字幕条等）的 Timeline 配置参考

## CDN分发加速

- [CDN分发加速](./CDN分发加速/CDN分发加速.md): 点播 CDN 加速的整体架构、域名接入流程和功能配置导航
- [域名准入标准](./CDN分发加速/域名准入标准.md): 加速域名的备案要求和准入规则
- [域名归属校验](./CDN分发加速/域名归属校验.md): 通过 DNS 或文件方式验证域名归属权的操作方法
- [URL鉴权](./CDN分发加速/URL鉴权.md): 配置 URL 鉴权（A/B/C 三种模式）防止视频资源被盗链
- [HTTPS安全加速](./CDN分发加速/HTTPS安全加速.md): 配置 HTTPS 证书实现全链路安全加速传输
- [刷新预热](./CDN分发加速/刷新预热.md): CDN 缓存刷新（URL/目录）和内容预热的操作方法
- [如何提高视频点播缓存命中率与访问速度](./CDN分发加速/如何提高视频点播缓存命中率与访问速度.md): 优化缓存策略提高命中率的最佳实践

## 事件通知

- [事件通知概述](./事件通知/事件通知_2.md): 事件通知机制介绍和 HTTP 回调/MNS 两种接收方式的配置方法
- [HTTP回调](./事件通知/HTTP回调.md): HTTP 回调方式的接入地址配置和回调鉴权说明
- [事件列表](./事件通知/事件列表.md): 所有支持的事件类型（上传/转码/截图/审核/AI/剪辑/工作流等）的触发条件
- [事件通知常见问题](./事件通知/事件通知常见问题.md): 回调收不到、重复回调、回调延迟等常见问题排查

## 数据统计

- [数据监控](./数据统计/数据监控.md): CDN 运行数据（带宽/流量/QPS/状态码/命中率）的查询方法
- [播放数据统计](./数据统计/播放数据统计.md): 视频播放次数、UV、播放时长等统计数据的查询和分析
- [播放数据统计常见问题](./数据统计/播放数据统计常见问题.md): 统计数据不准确、数据延迟等问题的原因和解决方法

## 多应用体系

- [多应用体系](./多应用体系/多应用体系.md): 多租户资源隔离架构和适用场景说明
- [使用多应用体系](./多应用体系/使用多应用体系.md): 创建应用、授权管理和资源迁移的完整操作指南
- [多应用体系常见问题](./多应用体系/多应用体系常见问题.md): 应用配额、权限继承等常见问题解答

## 服务端SDK

- [服务端SDK](./服务端SDK/服务端SDK.md): SDK 版本说明（V1.0/V2.0）、支持语言列表和初始化方式
- [Java SDK示例](./服务端SDK/Java示例.md): Java SDK 安装初始化和各功能模块（上传/播放/管理/处理）调用示例
- [Python SDK示例](./服务端SDK/Python示例.md): Python SDK 安装初始化和各功能模块调用示例
- [PHP SDK](./服务端SDK/PHP%20SDK.md): PHP SDK 原版和升级版的安装配置说明
- [.NET SDK](./服务端SDK/NET%20SDK.md): .NET SDK 安装初始化和调用示例
- [Node.js SDK](./服务端SDK/Node.js%20SDK.md): Node.js SDK 安装初始化和调用示例
- [Go SDK](./服务端SDK/Go%20SDK.md): Go SDK 安装初始化和调用示例
- [C/C++ SDK](./服务端SDK/C_C++%20SDK.md): C/C++ SDK 安装初始化和调用示例
- [Terraform](./服务端SDK/Terraform.md): 通过 Terraform 以 IaC 方式管理点播资源配置
- [服务端SDK发布历史](./服务端SDK/服务端SDK发布历史.md): 各语言 SDK 版本更新日志和变更说明

## 直播转点播

- [配置直播转点播](./直播转点播/配置直播转点播.md): 将直播录制文件自动转为点播视频的配置方法和存储规则
- [直播转点播常见问题](./直播转点播/直播转点播常见问题.md): 录制文件找不到、转点播延迟等常见问题排查

## 计费

- [计费概述](./计费/计费概述.md): 计费组成（基础服务+增值服务）和计费方式总览
- [计费方式](./计费/计费方式.md): 按量付费和资源包两种计费模式的详细规则
- [计费案例](./计费/计费案例.md): 典型业务场景下的费用计算示例
- [资源包](./计费/资源包.md): 资源包类型、购买规格和抵扣规则说明
- [计费常见问题](./计费/计费常见问题.md): 欠费影响、账单疑问等计费相关常见问题

## 微短剧解决方案

- [微短剧解决方案](./微短剧解决方案/微短剧解决方案.md): 微短剧场景整体方案架构和各环节能力说明
- [微短剧服务端开发](./微短剧解决方案/微短剧服务端开发.md): 微短剧场景的服务端 API 集成开发指南
- [微短剧服务端最佳实践](./微短剧解决方案/微短剧服务端最佳实践.md): 上传/转码/分发环节的性能优化和成本控制建议
- [微短剧媒体上传](./微短剧解决方案/微短剧媒体上传.md): 微短剧批量上传和自动化处理的配置方法
- [微短剧媒体处理](./微短剧解决方案/微短剧媒体处理.md): 针对竖屏短视频的转码参数和模板推荐
- [微短剧媒体管理](./微短剧解决方案/微短剧媒体管理.md): 剧集/分集的媒资组织和批量管理方案

## 客户端播放器

播放器文档分为 **Atomic SDKs**（底层平台原生集成）和 **PlayerKits**（高层场景化封装）两大体系。

### 播放器概述

- [播放器 SDK 概述](./端侧播放器/player-overview.md): 播放器架构、核心能力、播放特性与适用场景介绍

### Atomic SDKs（原子 SDK）

- [Android 播放器 SDK](./端侧播放器/player-atomic-android.md): Android 端播放器集成、API 接口与排障指南
- [iOS 播放器 SDK](./端侧播放器/player-atomic-ios.md): iOS 端播放器集成、API 接口与排障指南
- [Web 播放器 SDK](./端侧播放器/player-atomic-web.md): Web/H5 端播放器集成、API 接口与排障指南
- [Flutter 播放器 SDK](./端侧播放器/player-atomic-flutter.md): Flutter 端播放器集成、API 接口与排障指南
- [HarmonyOS 播放器 SDK](./端侧播放器/player-atomic-harmonyos.md): HarmonyOS NEXT 端播放器集成与排障指南
- [Windows 播放器 SDK](./端侧播放器/player-atomic-windows.md): Windows 端播放器 SDK 集成说明

### PlayerKits（场景化方案层）

- [PlayerKits 概述](./端侧播放器/player-kits-overview.md): AliPlayerKit 方案架构与核心 API 说明
- [AUI Kits](./端侧播放器/player-kits-aui.md): 低代码 AUI Kits 场景化集成方案
- [Flutter Player Widget](./端侧播放器/player-kits-flutter-widget.md): Flutter AliPlayerWidget（自带 UI）集成说明

### 播放器通用

- [License 授权](./端侧播放器/player-common-license.md): License 获取、配置与常见问题
- [播放器常见问题](./端侧播放器/player-common-faq.md): 跨平台播放器常见问题汇总
- [播放器发布历史](./端侧播放器/player-common-release-notes.md): 播放器 SDK 版本变更与更新日志
- [播放器错误码](./端侧播放器/player-common-error-codes.md): 播放器 SDK 错误码参考手册

## 客户端短视频

- [Android 短视频 SDK](./端侧短视频/short-video-android.md): Android 端短视频拍摄、编辑与合成上传集成
- [iOS 短视频 SDK](./端侧短视频/short-video-ios.md): iOS 端短视频拍摄、编辑与合成上传集成
- [短视频通用](./端侧短视频/short-video-common.md): 短视频通用功能、常见问题与发布说明

## 客户端上传

- [客户端上传](./端侧上传/客户端上传.md): Android、iOS、Web、微信小程序等客户端上传集成与 API 说明

## 快速开始（客户端）

- [快速开始](./快速开始/快速开始.md): 跨平台 SDK 快速集成指引、Demo 下载和环境配置说明

## API参考

- [API概览](./API参考/API概览.md): 所有 OpenAPI 的分类索引（上传/播放/管理/处理/审核/AI/CDN/统计/多应用/配置）
- [调用方式](./API参考/调用方式.md): HTTP 请求结构、公共参数和签名机制说明
- [错误码表](./API参考/错误码表.md): 公共错误码和各接口专有错误码的完整列表
- [API QPS限制](./API参考/API%20QPS限制.md): 各接口的单用户调用频率限制和超限处理建议
- [基本数据类型](./API参考/基本数据类型.md): API 请求和返回中使用的数据结构定义

## Notes

- API 版本：2017-03-21
- 接入地址：`vod.{regionId}.aliyuncs.com`（公网）/ `vod-vpc.{regionId}.aliyuncs.com`（VPC）
- SDK 推荐版本：V2.0（基于 alibabacloud-sdk，[源码](https://github.com/aliyun/alibabacloud-java-sdk/tree/master/vod-20170321)）
- 支持地域：华北2（北京）、华东2（上海）、华南1（深圳）、日本、新加坡、印尼、中国香港、德国、美国
- URL 上传仅支持华东2（上海）地域
- OpenAPI 门户（在线调试 + 多语言 SDK 示例自动生成）：https://next.api.alibabacloud.com/api/vod/2017-03-21
- 客户端 SDK 版本请以各平台发布历史为准
- License 是客户端播放器/短视频 SDK 的必选项，首次接入前请先完成 License 配置
- 播放器与短视频 SDK 支持组合包接入，可根据业务场景选择合适的包体组合
- 最后更新时间：2025-05-13