测试 Zyla API Hub 的 YouTube 下载和信息 API 与 Postman

您的产品团队本周需要一个可用的 YouTube 下载器，您需要在将其连接到后端之前在 Postman 中进行端到端验证。在本指南结束时，您将能够使用 Zyla API Hub 进行身份验证，在 Postman 中访问 YouTube 下载和信息 API 的下载端点，并以编程方式检索作业 ID 和缩略图 URL，以便跟踪并向用户展示进度。

YouTube 下载和信息 API 的功能

YouTube 下载和信息 API 提供一个简单的 HTTP 端点，以启动特定格式（视频分辨率或音频格式）的常规 YouTube 视频下载，并返回一个短 JSON，其中包含唯一的下载作业 ID、视频的缩略图图像 URL 和进度 URL。它通常用于：

插图：测试 Zyla API Hub 的 YouTube 下载和信息 API 与 Postman

在服务器端工作的工人，排队转换并轮询进度。
为前端服务返回作业 ID 以进行 UI 更新。
需要快速获取特定格式可播放文件的内部工具。

您在实施中应考虑的注意事项：

音频下载链接在 2 小时后过期。
此端点仅支持下载常规视频。

在 Zyla API Hub 上开始

打开 Zyla API Hub 上的 YouTube 下载和信息 API 页面： YouTube 下载和信息 API。点击订阅（或在可用时开始免费试用），然后生成 API 密钥。计费为订阅 + 配额（不是按调用计费）。Zyla 的第一个 API 通常提供 7 天试用或 50 次请求；没有免费计划。请查看 API 页面以获取当前访问选项和定价。

如果您还没有帐户，请在此处创建一个：注册。您可以随时在 Zyla API Hub 上浏览其他类别和 API。

您将在 Postman 中测试的端点

该 API 暴露一个可下载的触发端点，您可以使用视频 URL 和所需格式调用它。

下载 (GET)

方法：GET
URL： https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
身份验证：带 Bearer 令牌的授权头
所需查询参数：
- url (字符串)：YouTube 视频 URL。示例： https://www.youtube.com/watch?v=aGSKrC7dGcY
- format (字符串)：所需输出格式。

格式参数的接受值：

视频：360p、480p、720p、1080p、1440p、2160p
音频：mp3、m4a、flac、opus、wav

注意：

音频下载链接在 2 小时后过期。
此端点仅支持下载常规视频。

Postman：逐步指南

1) 创建新请求

在 Postman 中，点击新建 → HTTP 请求。将方法设置为 GET。

2) 设置请求 URL

粘贴带查询参数的完整端点（您可以粘贴编码形式或使用参数选项卡）：

https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720

如果在 Postman 中使用参数 UI，请添加：

键： url | 值： https://www.youtube.com/watch?v=aGSKrC7dGcY
键： format | 值： 720

3) 添加授权头

在头部下，添加：

键： Authorization
值： Bearer YOUR_API_KEY

用您 Zyla 帐户中的密钥替换 YOUR_API_KEY。

4) 发送并检查响应

点击发送。您应该收到一个 JSON 有效负载，其中包含您可以用来跟踪作业并向用户显示预览图像的字段。

您可以导入到 Postman 的官方 cURL

您还可以将此确切的 cURL 导入到 Postman（文件 → 导入 → 原始文本），以获取预填充的请求：

curl -s -X GET "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DaGSKrC7dGcY&format=720"
-H "Authorization: Bearer YOUR_API_KEY"

示例 JSON 响应

{
"success": true,
"id": "2ec15939807689549d3f3115f168be6b9c868105",
"image": "https://i.ytimg.com/vi/aGSKrC7dGcY/hqdefault.jpg",
"progress_url": "https://youtube-api-progress-copy-development.up.railway.app/api/progress?id=2ec15939807689549d3f3115f168be6b9c868105"
}

您实际使用的字段含义：

success：布尔值，指示请求被接受。
id：发起下载的唯一作业标识符。
image：缩略图 URL（在下载进行时对您的 UI 有用）。
progress_url：您可以用来跟踪作业进度的 URL。

代码示例：JavaScript (Node.js)

此 Node.js 示例调用相同的端点，解析 JSON，并记录您将连接到作业跟踪和 UI 代码的字段。它仅使用文档中记录的 URL 和参数。

import fetch from "node-fetch";

const API_KEY = process.env.ZYLA_API_KEY; // 在环境中设置 YOUR_API_KEY
const videoUrl = "https://www.youtube.com/watch?v=aGSKrC7dGcY";
const format = "720"; // 请参阅下面支持的值列表

async function startDownload() {
const endpoint = "https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download";
const url = new URL(endpoint);
url.searchParams.set("url", videoUrl);
url.searchParams.set("format", format);

const res = await fetch(url.toString(), {
method: "GET",
headers: {
Authorization: `Bearer ${API_KEY}`
}
});

if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}

const data = await res.json();
// 官方示例的预期字段：
// success, id, image, progress_url
console.log("Accepted:", data.success);
console.log("Job ID:", data.id);
console.log("Thumbnail:", data.image);
console.log("Progress URL:", data.progress_url);

// 现在您可以将 data.id 和 data.progress_url 持久化，以便从工作者/UI 轮询。
}

startDownload().catch(err => {
console.error("Failed to start download:", err);
});

支持的格式值：

视频：360p、480p、720p、1080p、1440p、2160p
音频：mp3、m4a、flac、opus、wav

实施注意事项：

音频下载链接在 2 小时后过期；请相应地规划您的工作流程。
此端点仅支持常规视频。

现实世界集成提示

URL 编码：如果您手动构建查询字符串，请确保 YouTube URL 按照 cURL 示例中的方式进行百分比编码。高级客户端（Postman 中的 URL、参数选项卡）会为您处理此问题。
身份验证处理：保持授权头为 Bearer YOUR_API_KEY。不要将密钥作为查询参数发送。
作业跟踪：立即将 id 和 progress_url 持久化到您的数据存储中，以便工作者或客户端可以轮询并更新 UI。
格式选择：仅向用户提供文档中记录的集合。视频：360p、480p、720p、1080p、1440p、2160p。音频：mp3、m4a、flac、opus、wav。
过期感知的用户体验：如果您向最终用户展示音频链接，请显示时间敏感的消息，因为链接在 2 小时后过期。
错误表面：如果您收到非 2xx 响应，请记录状态和主体以进行调试（如 JS 示例所示）。

通过 MCP 从 AI 代理使用 API

Zyla 上的每个 API 都可以从支持模型上下文协议（MCP）的 AI 代理调用。将您的 MCP 兼容客户端（例如 Claude Code、Cursor、Windsurf）指向 MCP 端点并提供您的 Zyla API 密钥。有关 MCP 的详细信息，请参见此处： MCP。相同的授权头适用：Bearer YOUR_API_KEY。配置工具后，提示代理使用 URL 和格式参数调用下载端点以启动作业并返回 id、image 和 progress_url。

您本周可以交付的常见工作流程

后端 API 用于“下载”按钮：您的服务接收 YouTube URL，验证它，并使用用户选择的分辨率或音频格式调用下载端点。它立即返回作业 id 和 image 以实现响应式 UI。
基于工人的转换：后台工人读取排队的作业，监控 progress_url，并更新数据库状态，以便您的客户端向用户显示进度。
仅音频流：对于播客工具或声音库，请请求音频格式（mp3、m4a、flac、opus、wav），并提醒链接在 2 小时后过期。

回顾：您需要集成的最小字段

端点：GET https://zylalabs.com/api/11016/youtube-download-and-info-api/20761/download
头部：Authorization: Bearer YOUR_API_KEY
查询参数：url、format
响应核心字段：success、id、image、progress_url

将 API 页面添加到书签以供参考： Zyla 上的 YouTube 下载和信息 API。在 Zyla API Hub 上浏览其他现成的 API。