无需维护的 yt-dlp 替代方案

yt-dlp 是一款出色的工具——直到你必须让它在生产环境中持续运行。如果你厌倦了 PO token、IP 封禁和每晚更新，本指南展示如何用一次 API 调用获得同样的结果。

yt-dlp 的强项

yt-dlp 是最好的开源提取器：支持数千个网站、维护活跃，对于脚本和一次性下载很难被超越。这里绝非贬低该项目——Tunelio 也站在同样的肩膀上。

自建的隐性成本

当真实产品依赖它时，麻烦就开始了。YouTube 积极对抗自动化访问，因此自建方案会变成一台停不下来的维护跑步机：

• 仅为让 YouTube 正常工作，就越来越需要 PO token 和 JS 运行时（Deno）。
• 你的服务器 IP 会被标记并限速，于是不得不购买并轮换代理。
• Telegram 机器人会撞上 50 MB 上传上限，2 GB 文件需要自建 Bot API 服务器。
• 错过一次每晚的 yt-dlp 更新，第二天提取就会悄悄失效。
• 你仍然需要自己用 ffmpeg 合并视频和音频。

一次 API 调用得到同样结果

Tunelio 为你运行这一切，并提供两个端点。GET /create 接收一个 URL 和画质，返回直接的签名下载链接——无队列、无轮询，你这边也无需任何基础设施。

curl "https://tunelio.dev/create?url=https://youtu.be/dQw4w9WgXcQ&quality=1080p" \
  -H "Authorization: Bearer tnl_your_api_key"

何时保留 yt-dlp，何时切换

对于本地脚本、归档工具以及 Tunelio 未覆盖的网站，保留 yt-dlp。当正常运行时间很重要、当你不想照看代理和 PO token、或当你要向真实用户发布机器人或应用时，选择托管 API。

从 yt-dlp 子进程迁移

如果你现在调用 yt-dlp 二进制文件，替代方案就是一次 HTTPS 请求——服务器保持轻量，下载 URL 会立即返回。

import os, requests

# Before: shelling out to a self-hosted yt-dlp you must keep updated.
# After: one HTTPS call — no binary, no PO token, no proxy pool.
dl = requests.get(
    "https://tunelio.dev/create",
    params={"url": "https://youtu.be/dQw4w9WgXcQ", "quality": "1080p"},
    headers={"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"},
).json()
print(dl["url"])  # a direct, ready-to-use download URL

后续步骤

新账户可获得 100 个免费额度，无需信用卡。阅读完整 API 参考，然后把你的第一次 yt-dlp 调用换成 GET /create。