视频下载 API 文档

EasyDown REST API 平台指南

YouTube 视频下载 API

把一个公开 YouTube URL 发送到统一 REST Endpoint。接口会保留全部可用视频与音频候选，方便后端自行选择格式，而不是被限制为单个文件。

使用 EasyDown YouTube 视频下载 API，把公开视频、Shorts 或回放链接解析为视频、音频、缩略图、时长和画质数据。

YouTube 视频解析 API · YouTube Shorts 下载 API

创建 API Token查看 API 价格打开网页下载器

生产环境 REST Endpoint

POST https://api.easydown.org/api/v1/parse

支持的公开 URL 格式

youtube.com/watch?v={id}youtu.be/{id}youtube.com/shorts/{id}youtube.com/live/{id}

真实请求示例

https://www.youtube.com/shorts/xzOtM0x3_LU?feature=share

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/shorts/xzOtM0x3_LU?feature=share"}'

平台专属响应示例

统一响应外层保持稳定；具体平台决定哪些媒体数组和属性会被填充。

媒体返回行为

videos[] 可能同时包含渐进式文件和纯视频流，独立音频位于 audios[]。部分高画质 DASH 结果需要分别下载音视频后使用 FFmpeg 合并。

{
  "status": 200,
  "data": {
    "platform": "youtube",
    "title": "Example youtube public post",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "duration": 24,
    "images": [],
    "videos": [
      {
        "url": "https://cdn.example.com/video.mp4",
        "quality": "1080p video-only",
        "mimeType": "video/mp4",
        "width": 1080,
        "height": 1920,
        "hasAudio": false,
        "source": "direct"
      }
    ],
    "audios": [
      {
        "url": "https://cdn.example.com/audio.m4a",
        "quality": "128kbps",
        "mimeType": "audio/mp4"
      }
    ]
  },
  "msg": "success"
}

媒体下载与代理规则

建议后端携带浏览器 User-Agent、YouTube Referer、Origin 并透传 Range 请求下载。部分流会绑定解析服务器 IP 或受地区限制。

建议的后端请求头

User-Agent: Mozilla/5.0 Referer: https://www.youtube.com/ Origin: https://www.youtube.com/ Range: bytes=0-

不支持或不可用的内容

不支持播放列表、频道页、社区帖子、私密视频、会员内容、DRM 内容和地区不可用视频。

只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。

平台专属排错

所选画质没有声音时，下载独立音频并与视频合并。

签名流过期或返回 403 时，重新解析原始 URL。

地区受限的公开媒体需要使用可访问该内容的后端地区。

REST 集成流程

  1. 1

    创建私有 API Token，并在权限中允许该平台。

  2. 2

    把一个完整的公开作品 URL POST 到统一 Endpoint。

  3. 3

    从 images、videos、audios 中选择所需媒体并通过后端代理。

相关平台 API 文档

TikTok

TikTok 视频下载 API

Instagram

Instagram 下载 API：Reels、视频与图片

Twitter / X

Twitter / X 视频下载 API

Threads

Threads 视频与图片下载 API

Bilibili / B站

Bilibili / B站视频下载 API

小红书 / RedNote

小红书 / RedNote 媒体下载 API

EasyDown 的其他集成方式

AI Agent 可使用 MCP Endpoint；手动处理公开媒体时可直接打开网页下载器。

查看平台 MCP 指南

下载 API 常见问题

YouTube 下载 API 支持哪些 URL？

支持的公开单条作品格式包括 youtube.com/watch?v={id}, youtu.be/{id}, youtube.com/shorts/{id}, youtube.com/live/{id}。不支持播放列表、频道页、社区帖子、私密视频、会员内容、DRM 内容和地区不可用视频。

YouTube 下载 API 会返回哪些媒体？

videos[] 可能同时包含渐进式文件和纯视频流，独立音频位于 audios[]。部分高画质 DASH 结果需要分别下载音视频后使用 FFmpeg 合并。

应用应该如何下载返回的 YouTube 媒体 URL？

建议后端携带浏览器 User-Agent、YouTube Referer、Origin 并透传 Range 请求下载。部分流会绑定解析服务器 IP 或受地区限制。

YouTube API 成功请求如何扣费？

成功返回至少一条图片、视频或音频 URL 时扣 1 credit；失败、不支持、鉴权错误和空媒体结果不扣 credits。