跳转到正文
中文
获取 API 密钥

YouTube 视频下载 API

批量下载 YouTube 视频并直达你的云存储。提交视频 ID,选择 MP4、音频或片段并跟踪交付。FlashData 负责机器人验证、代理和重试。

20 GB 免费试用 · $0.10/GB 按量付费 · 支持用量报价

无需信用卡。试用详情

API 试用控制台

API 试用控制台
API 文档

YouTube 下载 API

支持 www.youtube.com 链接。

1粘贴链接2准备3播放并保存
视频文件视频预览
Introducing the new iPhone Duo 视频缩略图
Introducing the new iPhone Duo准备完成后即可在此播放。
FUfGcZ092b0.mp4

MP4

选择“准备视频”以创建下载任务。

查看您的第一个 API 请求

YouTube 错误交给我们处理

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

近乎无限的下载并发能力

通过 FlashData 的托管下载基础设施扩展大规模视频采集。

无需维护 Cookie 或代理

FlashData 管理 YouTube 访问、会话和代理选择。你的团队只需提交视频 ID,即可接收交付的媒体。

功能

格式、片段与存储选项。

为媒体选择格式、画质和目标云存储。可用画质取决于源视频。

YouTube 下载 API:如何批量交付到自己的云存储

开始使用

从视频 ID 到文件交付。

  1. 01

    选择文件和目标位置

    提供视频 ID,选择视频或音频,并设置输出偏好。添加存储目标,并授予文件上传权限。

  2. 02

    提交并跟踪下载

    保存返回的任务 ID,以便检查进度。您也可以设置回调,在处理完成时通知您的应用。

  3. 03

    使用已交付的媒体

    任务完成后,打开其结果,查看文件位置和元数据。使用您的云存储权限访问媒体。

阅读集成指南通过 MCP 连接你的 AI 助手
请求示例后台下载
Python 3.10+ · flashdata
python3 -m pip install -U flashdata
from 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 ,位于示例靠前的位置。不要将真实密钥提交到版本控制系统。 将示例中的存储设置替换为你自己的设置。使用返回的任务链接查看进度并获取结果。

YouTube 视频下载 API — Python 示例

文件批处理下载

批量视频下载,从列表直达云端。

在这里整理视频列表,然后在控制台上传或运行 Python 示例。整个集合共用输出设置,文件直接交付到你的存储。

查看 Python 示例

每行一个 11 位视频 ID。UTF-8 文本;自动移除重复项。

去重后的视频: 3

video-ids.txtUTF-8

jNQXAC9IVRw
FUfGcZ092b0
dQw4w9WgXcQ
开始批量下载
  1. 01

    上传您的视频 ID

    在文本文件中每行填写一个 ID。整批内容使用相同的输出设置和存储目标。

  2. 02

    跟踪进度

    下载提交受你的套餐限额约束。你可以暂停提交新任务,现有下载会继续进行。

  3. 03

    获取结果

    媒体文件会交付到你的存储。请在文件批处理任务完成后 24 小时内保存摘要和各项结果。

输入文件最大为 2 GiB。处理会使用套餐的容量和可用积分。

使用 Python 批量下载

将 ID 文件和此脚本保存在同一文件夹中。填写 API 密钥和存储设置,然后运行 python3 bulk_download.py。

bulk_download.py
Python 3.10+ · flashdata
python3 -m pip install -U flashdata
import 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 负责获取与交付,让您专注于围绕媒体构建产品体验。

减少需要运维的基础设施

将下载器运维交给 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

无需月度订阅,按需充值积分。

按量付费也可协商用量报价

告诉我们您的预计使用量,与团队协商按量付费的定制单位价格。

咨询用量报价

Business

US$0.04每交付 1 GB

US$40.00 每交付 1 TB

US$1,999.00 / 月 · 订阅

每个计费周期约包含 50 TB,假设全部包含积分均用于下载。

示例:交付 100 GB

US$10.00 积分用量,按按量付费费率计算。下载用量取决于文件大小,不能仅按视频数量估算。

订阅包含用量积分,可在 FlashData 各 API 间共用。积分已覆盖的用量不会重复收费。存储服务商费用另计。1 TB = 1,000 GB。

常见问题

常见问题。

联系支持团队
如何开始免费试用?
创建账户并验证邮箱。符合条件的账户会自动获得试用 Credits。查看余额请前往账户概览。无需信用卡。
试用额度如何共享?
Google 搜索、YouTube 数据及下载共用一份试用余额。此处按该产品的当前随用随付费率估算。下载按实际交付的媒体大小计费。你需要有足够的可用积分用于初始预留;存储服务提供商的费用另计。 余额可在控制台查看。
享受起步价需要满足什么条件?

Business 套餐的用量起价为每交付 1 TB 媒体 US$40.00。此费率需要订阅,费用为 US$1,999.00 / 月;套餐每个账单周期包含 40,000 积分。 使用服务会消耗积分,额外充值需单独付费。提交下载时会暂时预留积分。最终费用按已交付媒体的大小计算。可选的元数据文件不计入该费用。

当前价格与套餐限额
FlashData 的 YouTube 下载 API 是什么?

FlashData 的 YouTube Download API 将视频、音频或片段交付到你配置的云存储。下载可作为异步任务、批量请求或文件批处理任务运行。API 结果描述已上传的文件;媒体访问使用你的存储权限。用量按已交付媒体的字节数计费。

阅读参考文档
谁来处理 YouTube 403、机器人验证和 429?

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

我需要提供 Cookie 或代理吗?

FlashData 管理 YouTube 访问、会话和代理选择。你的团队只需提交视频 ID,即可接收交付的媒体。

我可以同时运行多少个下载?

FlashData 在内部处理 YouTube 403、机器人验证、会话续期和 429。以近乎无限的并发能力运行下载,媒体直接交付到你的存储桶。

可以选择 JSON、纯文本或 Markdown 吗?

可以。下载文件详情默认使用 JSON,也支持纯文本或 Markdown。媒体文件保持你选择的格式,例如 MP4 或 MP3。

阅读参考文档
可以下载数百万个视频吗?

支持。文件批处理支持包含数百万个 YouTube 视频 ID 的集合。上传不超过 2 GiB、每行一个 ID 的文本文件,选择输出和存储设置,并跟踪整个集合的进度。处理受您的套餐限制和可用积分约束。

文件批处理与常规批量请求有何不同?

常规批量请求会一并发送请求列表,数量不得超过套餐的批量请求限额。文件批处理从上传的视频 ID 文件开始,你可以跟踪整个集合、暂停新工作,并统一获取结果。对于较大的集合,请使用文件批处理。

我需要自己的云存储吗?

需要。API 下载需要一个受支持且具有写入权限的云存储目标。文件访问仍受您的存储权限控制。首页演示允许您直接在浏览器中下载示例,以便在配置存储前先行体验。

可以通过实时请求下载文件吗?

不支持。下载以异步任务或批量请求任务的形式运行。提交请求后,使用返回的链接跟踪任务并获取结果。您也可以配置完成回调。

可以将 YouTube 视频下载为 MP4,或将音频下载为 MP3 吗?

可以。视频格式选 MP4;下载类型选音频、输出格式选 MP3,即可获取 MP3。支持设置视频分辨率,文件交付到你的云存储。

阅读参考文档
可以通过 API 只下载 YouTube 视频中的一段吗?

可以。设置起止时间,例如 00:01:00 至 00:02:30,再选择输出格式和存储目标。片段会交付到你的存储。

阅读参考文档
YouTube 下载完成后可以通过 Webhook 通知我吗?

可以。在查询顶层设置 callback_url,使用 443 端口的公网 HTTPS 地址。批量请求需逐项设置;通知验证及结果获取见指南。

阅读参考文档
文件保留多久?

已交付的媒体遵循您自己的存储保留策略。FlashData 的任务结果在完成后保留 24 小时,因此请获取结果并保存所需的文件元数据。

可以将下载内容直接发送到 Cloudflare R2 吗?

支持。选择 s3_compatible 存储,提供您的 R2 存储桶、访问密钥和私密密钥,使用您的 R2 S3 端点,并将 region 设置为 auto。API 会将媒体上传到您的存储桶。创建签名 URL 或使用存储 SDK 来访问私有对象。

阅读参考文档
使用 FlashData 与自行运行 yt-dlp 有何不同?

FlashData 管理下载、重试、任务跟踪及云存储交付。自行运行 yt-dlp 则由你管理工具和基础设施,包括 FFmpeg、上传及任务队列。

阅读参考文档

体验您的第一次 YouTube 下载。

验证邮箱后,符合条件的账户将自动获得试用 Credits,无需信用卡。

指南

yt-dlp 指南与故障排查