跳到正文
两个 endpoint · 无需轮询 · 直接下载链接

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

只有两个 endpoint。粘贴 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": "tunnel"  }
← 约 400ms 返回 · 可直接下载
工作原理

两次调用。 无需等待。

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

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

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

两个 endpoint，一个认证头。为你真正在用的语言提供可直接复制的示例。

即时下载 URL
/create 在同一个响应里返回链接。无需轮询。
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…"
完整参考
Endpoint

整个 API。 两个 endpoint。

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

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

即时下载 URL
/create 在同一个响应里把链接给你。零轮询。
所有原生清晰度
开箱即用，144p 到 1080p。4K 在 Mega 上可用。
纯音频 MP3
服务端转封装。省去配置 ffmpeg。
CDN 直接分发
文件从我们的 CDN 推流——你的服务器从不代理这些字节。
按额度计费
可预测。/info 花 6 个额度，/create 花 10 个。账单没有意外。
Telegram 优先认证
一键注册——无需邮箱、密码或银行卡。
价格

按调用付费。 没有意外。

一次 /info = 6 个额度。一次 /create = 10 个额度。

按月计费。

注册即免费
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
$99/月
每月 1,500,000 个额度
无速率限制
最高 4K MP4 + MP3
专属支持 · 4 小时
需要定制方案?
更大的用量或专属基础设施——我们会为你量身定制方案。告诉我们你的需求,我们会在一个工作日内回复。
联系支持 support@tunelio.dev
适用于

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

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

常见问题 与解答.

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

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

免费开始。 今天就上线。

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