[ PROMPT_NODE_24336 ]
Stream 说明文档
[ SKILL_DOCUMENTATION ]
# Cloudflare Stream
通过单一 API 实现的无服务器实时及点播视频流媒体平台。
## 概述
Cloudflare Stream 提供视频上传、存储、编码和分发功能,无需管理基础设施,运行在 Cloudflare 的全球网络上。
### 关键特性
- **点播视频**: 上传、编码、存储、分发
- **实时流媒体**: 支持 ABR 的 RTMPS/SRT 摄入
- **创作者直接上传**: 终端用户无需 API 密钥即可上传
- **签名 URL**: 基于令牌的访问控制
- **分析**: 通过 GraphQL 获取服务端指标
- **Webhooks**: 处理通知
- **字幕**: 上传或 AI 生成字幕
- **水印**: 为视频应用品牌标识
- **下载**: 启用 MP4 离线观看
## 核心概念
### 视频上传方式
1. **API 上传 (TUS 协议)**: 直接服务器上传
2. **从 URL 上传**: 从外部源导入
3. **创作者直接上传**: 用户生成内容(推荐)
### 播放选项
1. **Stream 播放器 (iframe)**: 内置优化播放器
2. **自定义播放器 (HLS/DASH)**: Video.js, HLS.js 集成
3. **缩略图**: 静态或动画预览图
### 访问控制
- **公开**: 无限制
- **requireSignedURLs**: 基于令牌的访问
- **allowedOrigins**: 域名限制
- **访问规则**: 令牌中的地理位置/IP 限制
### 实时流媒体
- 支持来自 OBS, FFmpeg 的 RTMPS/SRT 摄入
- 自动录制为点播视频
- 同步推流至 YouTube, Twitch 等
- 支持浏览器流媒体的 WebRTC
## 快速开始
**通过 API 上传视频**
bash
curl -X POST
"https://api.cloudflare.com/client/v4/accounts/{account_id}/stream/copy"
-H "Authorization: Bearer "
-H "Content-Type: application/json"
-d '{"url": "https://example.com/video.mp4"}'
**嵌入播放器**
html
<iframe
src="https://customer-.cloudflarestream.com/