跳到正文
视频 · 音频 · 元数据 · 转录文本

一个 YouTube 下载 API 为 开发者打造，而非浏览器。

粘贴 YouTube URL，即可获取直接下载链接或带时间戳的转录文本——无需排队、轮询或进度 webhook。MP4 最高 4K，MP3 最高 320kbps。

tunelio.dev
$ curl "https://tunelio.dev/create?quality=720p&url=…" \
  -H "Authorization: Bearer tnl_…"
{ "url": "…/tunnel?id=…&sig=…", "file_size_str": "28.52 MB", "status": "ok"  }
工作原理

简单调用。 无需等待。

大多数“下载 API”会把你的任务排进队列，让你不停轮询进度。我们直接把链接给你。一次请求，一次响应。

016 个额度
GET /info
发送任意 YouTube URL。我们会在一秒内返回元数据、全部可用视频清晰度以及音频格式。
0210 个额度
GET /create
选好清晰度，带上 URL 调用 /create。下载链接就在同一个响应里返回。
03免费
直接下载
把返回的 tunnel URL 直接交给你的用户、S3 或转码器。我们直接通过隧道推流——你的服务器全程不掺和。
在这里你找不到的东西
✗ 没有任务队列✗ 没有状态轮询✗ 没有进度 webhook✗ 没有 SSE 流
面向 yt-dlp 用户

什么是 Tunelio？

Tunelio 是一个托管式 YouTube 下载 API。发送一个 YouTube 链接，一次 HTTP 请求（通常不到一秒）即可得到直接的 MP4 或 MP3 下载链接、视频元数据，或带时间戳的转录文本。它是自行维护 yt-dlp、cookies、代理和 ffmpeg 的托管替代方案。

从 yt-dlp 迁移？保留工作流，告别日常维护。

无需 cookies 与 PO token
YouTube 的机器人验证、proof-of-origin token 和 IP 信誉都由我们处理。你的代码永远不会遇到 “Sign in to confirm you’re not a bot”。
无需每日更新
YouTube 一有变动，yt-dlp 就会失效。我们持续修补提取集群，你的集成在你睡觉时也照常工作。
无需 ffmpeg 与代理池
最高 4K 的合流 MP4 与 320 kbps MP3 以一个签名 URL 返回，可直接交给用户、机器人或 S3 上传——无需本地转换，无需轮换 IP。
yt-dlp 替代方案：何时该用托管 API →修复 “Sign in to confirm you’re not a bot” →修复 yt-dlp 403 Forbidden →
开发者 API

今天就把它接入 你的技术栈.

一个认证头即可访问直连媒体、元数据和转录文本，并提供常用语言的可复制示例。

即时下载 URL
/create 在同一个响应里返回链接。无需轮询。
Telegram 和邮箱认证
通过 Telegram 或邮箱注册。在几秒钟内生成密钥。
用多少付多少
按月发放额度，每个周期都是新的。
# 1. Get available formats
curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_8f3a92…"

# 2. Get a direct download URL (returns instantly)
curl "https://tunelio.dev/create?quality=720p&url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_8f3a92…"

# 3. Get a timestamped transcript
curl "https://tunelio.dev/transcript?url=dQw4w9WgXcQ&lang=en&format=json" \
  -H "Authorization: Bearer tnl_8f3a92…"
完整参考
Endpoint

专注的 API。 清晰的契约。

GET/info
6 个额度
返回标题、时长、缩略图，以及每一种可用的视频和音频格式及其文件大小。
Query 参数
urlstring必填— 任意 YouTube watch / shorts / share URL
响应结构
{ title, duration_seconds, thumbnail, formats[], audioFormat }
GET/create
10 个额度
在同一个响应里返回一个签名的、直连下载 URL。无需轮询，无需进度 webhook。
Query 参数
urlstring必填— 任意 YouTube watch / shorts / share URL
qualitystring必填— 例如 144p、360p、720p、1080p、mp3、opus
响应结构
{ url, filename, quality, file_size_str, expires, status }
GET/transcript
6 个额度
以结构化 JSON 返回带时间戳的字幕，也支持纯文本、SRT 和 VTT 输出。
Query 参数
urlstring必填— 任意 YouTube watch / shorts / share URL
langstring— 可选语言代码，例如 en、ru、zh
响应结构
{ language, available_languages[], segments[], full_text, status }
/create 返回的 URL 指向 tunelio.dev/tunnel——那就是文件本身。你不需要在代码里调用它,而是把它交给你的用户或下载器。
能力

只保留你真正会用到的部分。

即时下载 URL
/create 在同一个响应里把链接给你。零轮询。
所有原生清晰度
开箱即用，144p 到 1080p。4K 在 Mega 上可用。
纯音频 MP3
服务端转封装。省去配置 ffmpeg。
直连流式分发
文件通过我们的隧道直连推流——你的服务器从不代理这些字节。
面向开发者的转录文本
带时间戳的 JSON、纯文本、SRT 或 VTT，并包含语言和来源元数据。
注册即送 100 个免费额度
每个新账户都从 100 个额度开始——付费前先试用 API。无需银行卡。
价格

按调用付费。 没有意外。

简单的按调用计费。每个 endpoint 的费用都会在调用前清楚标示。

按月计费。

注册即免费
Trial
先试用 API，再考虑付费。
$0/月
100 个额度——一次性
每分钟 15 次请求
最高 720p MP4 + 320k MP3
社区支持
Pro
$9/月
每月 100,000 个额度
无速率限制
最高 1080p MP4 + MP3
邮件支持 · 48 小时
推荐
Ultra
$39/月
每月 500,000 个额度
无速率限制
最高 1080p MP4 + MP3
优先支持 · 24 小时
Mega
$89/月
每月 1,500,000 个额度
无速率限制
最高 4K MP4 + MP3
专属支持 · 4 小时
需要定制方案?
更大的用量或专属基础设施——我们会为你量身定制方案。告诉我们你的需求,我们会在一个工作日内回复。
联系支持 support@tunelio.dev
适用于

Telegram 机器人、网站,以及 移动应用.

TG 机器人
Telegram 机器人
几秒内就用下载好的文件回复一条 YouTube 链接。/create 给你一个直接的 URL,Telegram 可以拉取并重新作为文件上传。
网站
网站
在你的站点上嵌入一个下载框。从你的后端把 URL 传给 /create,再把响应里的链接交给浏览器——搞定。
移动端
移动应用
离线优先的视频应用,让用户在登机前保存讲座或播放列表。没有队列,所以你的界面显示的是“正在下载”,而不是“等待中”。
指南

开发者指南

可直接复制的示例，以及你真正会遇到的问题的解决方法。

全部指南 →
yt-dlp 错误全解：每个错误的含义与真正有效的修复
所有常见 yt-dlp 错误集中在一处 —— 机器人验证、403、404、format not available、nsig、ffmpeg、cookies、代理、限速 —— 附原因、第一步修复和完整指南链接。
阅读指南 →
yt-dlp："Sign in to confirm you're not a bot" 的含义与修复方法
yt-dlp 为什么提示 “Sign in to confirm you’re not a bot”，以及 2026 年真正有效的修复顺序：更新、JS 运行时、IPv4、cookies、PO token、更换 IP。
阅读指南 →
yt-dlp 403 Forbidden：为什么会发生，以及有效的修复顺序
按正确顺序修复 yt-dlp “HTTP Error 403: Forbidden”：更新、JS 运行时、IPv4、格式、播放器客户端、PO token、cookies、IP，附真实原因分析。
阅读指南 →
YouTube 下载 API
使用 Tunelio YouTube 下载 API，一次请求即可获取 MP4 和 MP3 直链。附 cURL、Python 和 Node.js 示例。100 个免费额度。
阅读指南 →
问题

常见问题 与解答.

还有疑问? 在 Telegram 上联系我们 →

Tunelio 是一个通用的内容解析 API。你有责任确保后续使用符合 YouTube 的服务条款以及当地的版权法。大多数司法辖区都允许个人用途的下载和教育性的二次使用。

免费开始。 今天就上线。

注册即送 100 个额度,无需银行卡。打开 Telegram,拿到密钥,一分钟内你就能开始下载。