YouTube 下载 API

作者 Tunelio 团队·发布于 2026年6月13日

YouTube 下载 API 让你的应用、机器人或后端把一个 YouTube 链接变成即用型下载 URL——无需浏览器自动化，也无需本地转换。本指南展示如何用 Tunelio API 在一次请求中完成它。

YouTube 下载 API 有什么用

无需抓取页面或运行笨重的本地提取器，你只需把一个 YouTube URL 发送到某个端点，就能收到该文件直接的、签名的下载 URL。你的服务器保持轻量，响应在一次往返中返回——没有需要跟踪的 job ID，也没有需要轮询的 status 端点。

Tunelio 让下载流程保持简洁：GET /info 检查视频并列出可用格式及精确大小，GET /create 返回所选画质的直接下载 URL。带时间戳的转录文本等相关能力也使用同一个 API key。

认证

每个请求都以 Bearer token 的形式携带你的 API key。新账户可获得 100 个免费额度，你可以用 Telegram 或 Email 在大约一分钟内注册——无需信用卡。

Authorization: Bearer tnl_your_api_key

快速开始

先检查视频，看看有哪些格式可用，然后为你想要的画质请求一个直接 URL。下面是使用 cURL 的完整流程：

# 1. List available formats (6 credits)
curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
  -H "Authorization: Bearer tnl_your_api_key"

# 2. Get a direct download URL for 1080p (10 credits)
curl "https://tunelio.dev/create?url=https://youtu.be/dQw4w9WgXcQ&quality=1080p" \
  -H "Authorization: Bearer tnl_your_api_key"

/create 的响应包含一个 url 字段——一个签名下载链接，你可以直接交给用户，或流式保存到存储。它在数小时内保持有效。

Python

import os, requests

H = {"Authorization": f"Bearer {os.environ['TUNELIO_KEY']}"}

info = requests.get(
    "https://tunelio.dev/info",
    params={"url": "https://youtu.be/dQw4w9WgXcQ"},
    headers=H,
).json()
print(info["formats"][0]["quality"])  # e.g. "1080p"

dl = requests.get(
    "https://tunelio.dev/create",
    params={"url": "https://youtu.be/dQw4w9WgXcQ", "quality": "1080p"},
    headers=H,
).json()
print(dl["url"])  # direct download URL

选择画质和格式

quality 参数接受一个视频标签，例如 144p、240p、360p、480p、720p 或 1080p——以及 Mega 套餐上的 2160p (4K)。改为传入 quality=mp3 即可获得纯音频的 MP3 文件。由于 GET /info 会预先报告每种格式的精确字节大小，你可以在用户决定下载之前向其展示文件大小。

价格与额度

每次调用 /info 花费 6 个额度，每次 /create 花费 10；通过返回的 URL 实际下载文件是免费的。套餐从 100 个额度的免费试用，到 Pro ($9/mo，100,000 额度)、Ultra ($39/mo，500,000 额度) 和 Mega ($89/mo，1.5M 额度，含 4K MP4)。

后续步骤

这就是整个 API。阅读完整参考了解响应字段、错误码和速率限制，然后领取你的免费额度并发起第一次调用。