YouTube Shorts 下载 API

一次带鉴权的 POST 把任意 YouTube Shorts URL 转成已保存的 MP4——最高 720p 画质选择、视频直链和元数据，干净 JSON 返回。

单一 REST 端点
所有 Shorts URL 形态
画质选择器
规范化元数据
幂等的计费写入
可预期的错误码

请求示例

curl -X POST "https://api.agentbody.io/v1/youtube/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"quality":"144p","url":"YOUR_URL"}'

响应示例

来自 OpenAPI 规范的已文档化响应。

Downloaded YouTube media link and normalized public video metadata.

{
  "duration_seconds": 180,
  "format": "mp4",
  "quality": "720p",
  "size_mb": 15.2,
  "title": "Example Video",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_content_type": "video/mp4",
  "video_id": "dQw4w9WgXcQ",
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/dQw4w9WgXcQ.mp4"
}

功能特点

用 YouTube Shorts 下载 API 搭建内容搬运管线、调研和存档系统——Shorts URL 进，MP4 链接出。

单一 REST 端点

带 bearer API 密钥和 Shorts URL 调用 POST /v1/youtube/video/download。API 保存 MP4 并返回直链——无需无头浏览器、无需格式协商、无需爬虫。

所有 Shorts URL 形态

youtube.com/shorts/ 链接、youtu.be 链接、App 分享链、指向 Short 的 watch URL 全部解析。集成侧用户粘什么都能处理，省一步归一化。

画质选择器

quality 字段接受 144p、240p、360p、480p、720p。每次请求钉死输出，响应确认交付的画质、格式和大小。

规范化元数据

每个响应把 video_url 与 video_id、title、duration_seconds、format、quality、size_mb、video_content_type 配对——管线可直接存储的稳定字段。

幂等的计费写入

视频保存是按量计费操作。重试时带 Idempotency-Key 头，中断的响应不会重复计费同一 Short——同键相同请求返回原始结果。

可预期的错误码

文档化状态码：400 请求无效、401 密钥缺失或错误、409 幂等冲突、502/503/504 暂时性上游问题——每类对应明确的修复或重试动作。

使用步骤

按以下步骤调用 YouTube Shorts 下载 API：创建密钥，构造 POST 请求，处理返回的 MP4 链接。

创建 API 密钥

创建 AgentBody 账号并在控制台生成 API 密钥。密钥留在服务端并以 bearer 令牌发送——绝不进浏览器代码。

构造请求

向 /v1/youtube/video/download 发送 POST，带必填的 Shorts url 和可选的 quality。生成示例展示五种语言的确切请求。

加幂等键

给每个可能重试的下载附 Idempotency-Key 头。同键相同请求返回原始响应，不重复计费。

密钥留在服务端

从后端、serverless 函数或定时任务调用端点。若终端用户触发下载，经你自己的端点代理。

解析 JSON 响应

读取返回的 video_url、video_id、title、duration_seconds、format、quality、size_mb。把链接和元数据一起存储——字段跨请求稳定。

正确处理错误

400 修请求体，401 配好密钥，409 按文档化幂等键行为处理。502/503/504 同键带退避重试。

常见问题

YouTube Shorts 下载 API 是什么？

一个带鉴权的 POST 端点 /v1/youtube/video/download，把一条公开 YouTube Short 保存为 MP4，返回视频直链和规范化元数据——video_id、标题、时长、格式、画质、大小——以结构化 JSON 交付。

API 接受哪些 Shorts URL 格式？

youtube.com/shorts/VIDEO_ID 链接、youtu.be 短链、App 分享链、指向 Short 的标准 watch URL——同一请求结构全部解析。

最高画质是多少？

720p。quality 字段接受 144p、240p、360p、480p、720p——本端点没有 1080p 或 4K 档位。响应回报实际交付的画质。

价格怎么算？

每次视频保存是消耗账号额度的按量计费操作。价格由网关管理而非本页写死——控制台查单价，用幂等键确保重试不双重计费。

能下载私密或已删除的 Shorts 吗？

不能。端点只读取公开 Shorts——私密、会员专属和已删除内容不会解析，也不索要 YouTube 凭据绕过限制。

怎么处理 API 错误？

400 修请求体，401 修 bearer 密钥，409 按文档化幂等键行为处理。把 502、503、504 当暂时性上游故障，同键带退避重试。