YouTube 错误交给我们处理
FlashData 通过托管代理路由和自动恢复,在内部解决 YouTube 403、机器人验证和 429。

MP4
选择“准备视频”以创建下载任务。
FlashData 通过托管代理路由和自动恢复,在内部解决 YouTube 403、机器人验证和 429。
通过 FlashData 的托管下载基础设施扩展大规模视频采集。
FlashData 管理 YouTube 访问、会话和代理选择。你的团队只需提交视频 ID,即可接收交付的媒体。
功能
为媒体选择格式、画质和目标云存储。可用画质取决于源视频。
开始使用
提供视频 ID,选择视频或音频,并设置输出偏好。添加存储目标,并授予文件上传权限。
保存返回的任务 ID,以便检查进度。您也可以设置回调,在处理完成时通知您的应用。
任务完成后,打开其结果,查看文件位置和元数据。使用您的云存储权限访问媒体。
python3 -m pip install -U flashdatafrom flashdata import FlashData
with FlashData(api_key="your-flashdata-api-key") as client:
job = client.youtube.download(
"jNQXAC9IVRw",
download_type="audio_video",
output_format="mp4",
video_quality="<=1080",
storage={
"storage_type": "s3",
"storage_url": "your-media-bucket",
"region": "us-east-1",
"access_key": "your-storage-access-key",
"secret_key": "your-storage-secret-key",
},
)
print("Job ID:", job["id"])
client.jobs.wait(job["id"], timeout=900)
print(client.jobs.result(job["id"]))替换 your-flashdata-api-key ,位于示例靠前的位置。不要将真实密钥提交到版本控制系统。 将示例中的存储设置替换为你自己的设置。使用返回的任务链接查看进度并获取结果。
文件批处理下载
在这里整理视频列表,然后在控制台上传或运行 Python 示例。整个集合共用输出设置,文件直接交付到你的存储。
每行一个 11 位视频 ID。UTF-8 文本;自动移除重复项。
去重后的视频: 3
video-ids.txtUTF-8
jNQXAC9IVRw FUfGcZ092b0 dQw4w9WgXcQ
在文本文件中每行填写一个 ID。整批内容使用相同的输出设置和存储目标。
下载提交受你的套餐限额约束。你可以暂停提交新任务,现有下载会继续进行。
媒体文件会交付到你的存储。请在文件批处理任务完成后 24 小时内保存摘要和各项结果。
输入文件最大为 2 GiB。处理会使用套餐的容量和可用积分。
将 ID 文件和此脚本保存在同一文件夹中。填写 API 密钥和存储设置,然后运行 python3 bulk_download.py。
python3 -m pip install -U flashdataimport json
from pathlib import Path
from flashdata import FlashData
input_file = Path("video-ids.txt")
receipt = Path("bulk-job.json")
with FlashData(api_key="your-flashdata-api-key") as client:
if receipt.exists():
created = json.loads(receipt.read_text(encoding="utf-8"))
else:
if not input_file.is_file() or not input_file.stat().st_size:
raise ValueError("Save a nonempty video-ids.txt first")
# Reserve the receipt before submitting. Reruns reuse this job.
with receipt.open("x", encoding="utf-8") as saved:
created = client.bulk.create({
"source": "youtube_download",
"options": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=1080",
"storage": {
"storage_type": "s3",
"storage_url": "your-media-bucket",
"object_prefix": "bulk-videos/run-01",
"region": "us-east-1",
"access_key": "your-storage-access-key",
"secret_key": "your-storage-secret-key",
},
},
})
json.dump(created, saved)
bulk_id = created["job"]["id"]
print("Bulk job:", bulk_id, flush=True)
if client.bulk.get(bulk_id)["status"] == "awaiting_upload":
client.bulk.upload_file(created, input_file)
client.bulk.start(bulk_id)
# A polling timeout leaves the job running. Rerun to keep watching it.
job = client.bulk.wait(bulk_id, timeout=3600)
manifest = client.bulk.manifest(bulk_id)
Path("manifest.json").write_text(json.dumps(manifest, indent=2), encoding="utf-8")
# Each row includes the video ID, outcome and delivery result or error.
with Path("results.jsonl.tmp").open("w", encoding="utf-8") as output:
for row in client.bulk.rows(bulk_id):
output.write(json.dumps(row, ensure_ascii=False) + "\n")
Path("results.jsonl.tmp").replace("results.jsonl")
print("Saved manifest.json and results.jsonl. Counts:", job["counts"])
脚本会保存 bulk-job.json,再次运行时继续跟踪同一任务。新集合请使用新文件夹,并在任务完成后 24 小时内保存结果。
应用场景
在您的存储中构建媒体集合,并可附带配套元数据。保留视频 ID 与文件位置的对应关系,用于索引、研究与评估。
将纯音频文件发送到您的转写、语音分析或索引工具,并选择下游服务支持的音频格式。
为剪辑流水线获取源视频或指定时间范围。由 FlashData 负责获取与交付,让您专注于围绕媒体构建产品体验。
减少需要运维的基础设施
专为 YouTube 构建的机器人检测与验证处理技术,配合预选住宅代理路由。您的团队无需自行采购或运维代理。
| 工作事项 | 自建 yt-dlp 工作流 | 使用 FlashData |
|---|---|---|
| YouTube 403 和机器人验证 | 更新 yt-dlp,更换被标记的 IP 并维护重试机制。 | FlashData 通过托管代理路由和自动恢复,在内部解决 YouTube 403、机器人验证和 429。 |
| YouTube 429 限流 | 降低请求频率,并管理工作节点和 IP 之间的流量。 | 托管请求路由与恢复 |
| Cookie、会话和代理 | 获取和更新 Cookie,选择可用代理并更换被封锁的 IP。 | FlashData 管理 YouTube 访问、会话和代理选择。你的团队只需提交视频 ID,即可接收交付的媒体。 |
| 并发下载 | 随着采集规模增长,配置工作节点、带宽和代理容量。 | 近乎无限的下载并发能力 |
| 云端交付 | 运维上传流程,维护源内容与文件的对应关系。 | 交付到受支持的存储,提供每个视频的结果与文件位置。 |
适应工作负载规模的成本
从按量付费开始,根据使用量协商定制单位价格,或选择公开下载费率更低的订阅套餐。最终用量按实际交付媒体字节数结算;可选的配套元数据 JSON 不计入下载数据量费用。
US$0.10每交付 1 GB
US$100.00 每交付 1 TB
无需月度订阅,按需充值积分。
US$0.04每交付 1 GB
US$40.00 每交付 1 TB
US$1,999.00 / 月 · 订阅
每个计费周期约包含 50 TB,假设全部包含积分均用于下载。
US$10.00 积分用量,按按量付费费率计算。下载用量取决于文件大小,不能仅按视频数量估算。
订阅包含用量积分,可在 FlashData 各 API 间共用。积分已覆盖的用量不会重复收费。存储服务商费用另计。1 TB = 1,000 GB。
Business 套餐的用量起价为每交付 1 TB 媒体 US$40.00。此费率需要订阅,费用为 US$1,999.00 / 月;套餐每个账单周期包含 40,000 积分。 使用服务会消耗积分,额外充值需单独付费。提交下载时会暂时预留积分。最终费用按已交付媒体的大小计算。可选的元数据文件不计入该费用。
当前价格与套餐限额FlashData 的 YouTube Download API 将视频、音频或片段交付到你配置的云存储。下载可作为异步任务、批量请求或文件批处理任务运行。API 结果描述已上传的文件;媒体访问使用你的存储权限。用量按已交付媒体的字节数计费。
阅读参考文档FlashData 通过托管代理路由和自动恢复,在内部解决 YouTube 403、机器人验证和 429。
FlashData 管理 YouTube 访问、会话和代理选择。你的团队只需提交视频 ID,即可接收交付的媒体。
FlashData 在内部处理 YouTube 403、机器人验证、会话续期和 429。以近乎无限的并发能力运行下载,媒体直接交付到你的存储桶。
可以。下载文件详情默认使用 JSON,也支持纯文本或 Markdown。媒体文件保持你选择的格式,例如 MP4 或 MP3。
阅读参考文档支持。文件批处理支持包含数百万个 YouTube 视频 ID 的集合。上传不超过 2 GiB、每行一个 ID 的文本文件,选择输出和存储设置,并跟踪整个集合的进度。处理受您的套餐限制和可用积分约束。
常规批量请求会一并发送请求列表,数量不得超过套餐的批量请求限额。文件批处理从上传的视频 ID 文件开始,你可以跟踪整个集合、暂停新工作,并统一获取结果。对于较大的集合,请使用文件批处理。
需要。API 下载需要一个受支持且具有写入权限的云存储目标。文件访问仍受您的存储权限控制。首页演示允许您直接在浏览器中下载示例,以便在配置存储前先行体验。
不支持。下载以异步任务或批量请求任务的形式运行。提交请求后,使用返回的链接跟踪任务并获取结果。您也可以配置完成回调。
可以。视频格式选 MP4;下载类型选音频、输出格式选 MP3,即可获取 MP3。支持设置视频分辨率,文件交付到你的云存储。
阅读参考文档可以。设置起止时间,例如 00:01:00 至 00:02:30,再选择输出格式和存储目标。片段会交付到你的存储。
阅读参考文档可以。在查询顶层设置 callback_url,使用 443 端口的公网 HTTPS 地址。批量请求需逐项设置;通知验证及结果获取见指南。
阅读参考文档已交付的媒体遵循您自己的存储保留策略。FlashData 的任务结果在完成后保留 24 小时,因此请获取结果并保存所需的文件元数据。
支持。选择 s3_compatible 存储,提供您的 R2 存储桶、访问密钥和私密密钥,使用您的 R2 S3 端点,并将 region 设置为 auto。API 会将媒体上传到您的存储桶。创建签名 URL 或使用存储 SDK 来访问私有对象。
阅读参考文档FlashData 管理下载、重试、任务跟踪及云存储交付。自行运行 yt-dlp 则由你管理工具和基础设施,包括 FFmpeg、上传及任务队列。
阅读参考文档验证邮箱后,符合条件的账户将自动获得试用 Credits,无需信用卡。
指南
以 Linux 为主的日常下载指南,涵盖 nightly 版安装、格式、字幕、数据集与可续跑的批量采集。
依次更新到 nightly 版、降低并发、检查 Deno,再测试有效的 Cookie 与可用的出口 IP。
使用 nightly 版、Deno、有效的浏览器会话与可用的出口 IP 排查「Sign in to confirm you’re not a bot」。
暂停受限出口 IP 上的任务,降低提取及字幕请求频率,再用单个下载进程恢复。
可运行的 Python 示例,涵盖下载、元数据、AI 数据集及可续跑的批处理。
复制适用于视频、音频、字幕、数据集和采集恢复的命令。