AgentBodyAgentBody
登录

YouTube 视频下载 API

通过一次 POST 将公开 YouTube 视频下载为 MP4。响应返回永久下载 URL 和视频元数据。

  • 一次 POST，一个 MP4
  • 画质参数
  • 永久下载 URL
  • 所有公开链接形式
  • 幂等键支持
  • 需要服务器端密钥
工具APIAgent

请求示例

查看 API 文档 完整 API 文档 
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.video_download 操作将一个公开 YouTube 视频保存为 MP4 文件。您的服务器持有 API 密钥；端点在单次调用中返回永久下载 URL。

一次 POST，一个 MP4

发送 POST /v1/youtube/video/download 和公开视频 URL 及画质偏好。成功的 200 返回视频标题、时长、缩略图、文件大小和永久下载 URL——管道所需的一切。

画质参数

请求用例所需的分辨率。API 按您选择的画质提供源视频可用的选项，输出过程不重新编码。

永久下载 URL

URL 指向完全保存的文件，而非过期 CDN 跳转。可从任何服务器、任何 IP、任何时间下载——可安全交给队列工作器或媒体服务器。

所有公开链接形式

Watch 页面、youtu.be 短链、Shorts URL 和嵌入均可解析为同一视频。私密、已删除和年龄限制视频返回结构化错误。

幂等键支持

传递 Idempotency-Key 头，网络重试不会触发第二次下载或扣费。网关按键去重。

需要服务器端密钥

端点需要服务器持有的 AgentBody API 密钥。通过后端路由调用；绝不将密钥发到客户端。

使用步骤

三步 API 集成 YouTube 视频下载。

01

获取 API 密钥

创建免费 AgentBody 账户并从仪表板生成 API 密钥。

02

POST 视频 URL

向 /v1/youtube/video/download 发送 POST 请求和公开视频 URL 及画质偏好。包含 Idempotency-Key 头以安全重试。

03

接收下载链接

200 返回永久 MP4 URL 及标题、时长、缩略图和文件大小。直接下载或交给存储管道。

常见问题

YouTube 视频下载 API 如何工作？

向 /v1/youtube/video/download 发送 POST 请求和公开视频 URL 及画质偏好。API 将视频保存为 MP4 文件，并返回带标题、时长、缩略图和文件大小的永久下载 URL。

有哪些画质选项？

API 按您请求的画质提供源视频可用的分辨率。不是每个视频都有所有分辨率——响应反映上传实际包含的内容。

下载 URL 会过期吗？

不会。URL 指向完全保存的文件而非临时 CDN 跳转，调用后可从任何服务器和任何网络使用。

可以下载哪些视频？

仅公开视频。私密、已删除、年龄限制和地区屏蔽视频返回错误且不计费。

如何计费？

每次成功下载按网关管理价格从您的 AgentBody 余额扣除固定金额。失败不计费；使用 Idempotency-Key 头避免重试重复扣费。

有文件大小或时长限制吗？

超长视频可能被上游成本保护拒绝，以保持每次下载价格可预测。典型上传和 Shorts 正常处理。