PyTube API 完全指南：从视频下载到字幕处理

PyTube API 完全指南：从视频下载到字幕处理

pytube A lightweight, dependency-free Python library (and command-line utility) for downloading YouTube Videos. 项目地址: https://gitcode.com/gh_mirrors/py/pytube

概述

PyTube 是一个强大的 Python 库，专门用于处理 YouTube 视频内容。本文将深入解析 PyTube 的核心 API，帮助开发者全面掌握其功能架构和使用方法。无论你是想下载视频、处理播放列表，还是获取字幕信息，PyTube 都提供了简洁而强大的接口。

核心对象解析

YouTube 对象

YouTube 类是 PyTube 的核心，代表一个 YouTube 视频。通过它，你可以：

• 获取视频基本信息（标题、作者、时长等）
• 访问视频的所有可用流（不同分辨率、格式）
• 下载视频或音频
• 获取视频字幕

from pytube import YouTube

# 创建 YouTube 对象
yt = YouTube("视频URL")

# 获取视频标题
print(yt.title)

# 获取视频作者
print(yt.author)

播放列表对象 (Playlist)

Playlist 类专门用于处理 YouTube 播放列表：

• 获取播放列表中所有视频
• 批量下载播放列表内容
• 获取播放列表元数据

from pytube import Playlist

# 创建播放列表对象
pl = Playlist("播放列表URL")

# 获取播放列表中的所有视频URL
for video_url in pl.video_urls:
    print(video_url)

频道对象 (Channel)

Channel 类提供了对 YouTube 频道的操作能力：

• 获取频道所有视频
• 获取频道信息
• 处理频道相关内容

from pytube import Channel

# 创建频道对象
channel = Channel("频道URL")

# 获取频道名称
print(channel.channel_name)

# 获取频道所有视频URL
for video_url in channel.video_urls:
    print(video_url)

流处理系统

Stream 对象

Stream 代表视频的一个具体流（如 720p MP4 格式），提供：

• 流的具体属性（分辨率、编码、文件大小等）
• 下载方法
• 流类型判断

# 获取最高分辨率的流
stream = yt.streams.get_highest_resolution()

# 下载流
stream.download()

StreamQuery 对象

StreamQuery 是流的查询接口，允许你：

• 按条件过滤流（分辨率、文件类型等）
• 排序流
• 获取特定流

# 获取所有 MP4 格式的流
mp4_streams = yt.streams.filter(file_extension="mp4")

# 获取 720p 的流
hd_stream = yt.streams.get_by_resolution("720p")

字幕处理

Caption 对象

Caption 类表示视频的字幕，功能包括：

• 获取字幕文本
• 下载字幕文件
• 转换字幕格式

# 获取视频字幕
caption = yt.captions.get_by_language_code("en")

# 生成字幕文本
print(caption.generate_srt_captions())

CaptionQuery 对象

CaptionQuery 用于查询和管理视频的字幕：

• 按语言代码获取字幕
• 列出所有可用字幕
• 检查字幕可用性

# 检查是否有英文字幕
if yt.captions.get_by_language_code("en"):
    print("英文字幕可用")

辅助功能模块

Extract 模块

提供 YouTube URL 和 ID 的解析功能：

• 从 URL 提取视频 ID
• 验证 URL 有效性
• 处理各种 YouTube URL 格式

Cipher 模块

处理 YouTube 的加密签名，用于解密某些视频流的 URL。

Request 模块

封装了 HTTP 请求功能，包括：

• 自定义请求头
• 请求重试机制
• 响应处理

异常处理

PyTube 定义了一系列异常类，帮助开发者处理各种错误情况：

• 视频不可用
• 年龄限制内容
• 直播内容处理
• 提取错误
• 最大重试次数超出

from pytube.exceptions import VideoUnavailable

try:
    yt = YouTube("无效URL")
except VideoUnavailable:
    print("视频不可用")

最佳实践建议

1. 流选择策略：根据需求平衡视频质量和文件大小
2. 错误处理：始终封装下载代码在 try-except 块中
3. 进度监控：使用回调函数跟踪下载进度
4. 批量处理：对于播放列表，考虑添加延迟以避免请求限制

PyTube 的 API 设计简洁而强大，几乎涵盖了 YouTube 视频处理的所有需求。通过合理组合这些对象和方法，你可以构建出功能丰富的 YouTube 视频处理应用。

pytube A lightweight, dependency-free Python library (and command-line utility) for downloading YouTube Videos. 项目地址: https://gitcode.com/gh_mirrors/py/pytube