视频解析指南

了解如何从社交媒体分享链接提取视频元数据、验证请求、处理响应，并追踪按次计费的用量。

从社交媒体分享链接中提取视频下载信息。传入 URL 或原始分享文本，一次请求即可获得多清晰度视频流、音轨、封面图和元数据。

快速开始

获取 API 密钥

前往 Dashboard 创建 API 密钥。

发送请求

通过 url 参数传入任意受支持的视频 URL：

GET /v1/social-media/video/extract

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
  -H "Authorization: Bearer sk-your-api-key"

获取结果

响应包含统一格式的元数据和多清晰度下载选项：

响应

{
  "platform": "douyin",
  "data": {
    "videoId": "6918273131559881997",
    "title": "骑白马的也可以是公主#百万转场变身",
    "author": "Real机智张",
    "duration": 10,
    "videos": [
      { "url": "https://...mp4", "quality": "1080p", "format": "mp4", "width": 1080, "height": 1920 },
      { "url": "https://...mp4", "quality": "720p", "format": "mp4", "width": 720, "height": 1280 }
    ],
    "audios": [
      { "url": "https://...mp3", "format": "mp3" }
    ]
  }
}

支持的平台

平台	URL 格式	视频	音频	说明
抖音	`v.douyin.com/*`	多清晰度（1080p/720p/540p）	背景音乐 MP3	与 TikTok 共用解析器
快手	`v.kuaishou.com/`, `.gifshow.com/*`	多清晰度	支持	—
哔哩哔哩	`bilibili.com/video/BV`, `b23.tv/`	DASH 多码流	DASH 独立音轨	需要使用 ffmpeg 合并
小红书	`xiaohongshu.com/`, `xhslink.com/`	H.264/H.265	—	支持多种编码
微博	`weibo.com/`, `weibo.cn/`	720p/HD/LD	—	—
西瓜视频	`ixigua.com/*`	支持	—	—
皮皮虾	`pipix.com/`, `pipixia.com/`	高/低清晰度	—	—

平台	URL 格式	视频	音频	说明
TikTok	`tiktok.com/@user/video/*`	多清晰度（1080p/720p/540p）	背景音乐 MP3	与抖音共用解析器
YouTube	`youtube.com/watch?v=`, `youtu.be/`, `youtube.com/shorts/*`	360p–4K、mp4/webm	m4a/weba	最多返回 20 多种格式
Instagram	`instagram.com/reel/*`	多分辨率	—	—
Twitter/X	`x.com//status/`, `twitter.com//status/`	多码率	—	按码率排序

音频说明：“—”表示音频内嵌在视频文件中，此时 audios 返回空数组。哔哩哔哩和 YouTube 使用音视频分离的 DASH 格式，需要使用 ffmpeg 合并。抖音和 TikTok 的 audios 是独立的背景音乐文件。

试用地址

复制下面任意 URL，即可直接调用 API：

抖音

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
  -H "Authorization: Bearer sk-your-api-key"

返回 4 种清晰度选项（1080p 到 540p）和 1 个背景音乐 MP3。

TikTok

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://www.tiktok.com/@bellapoarch/video/6862153058223197445" \
  -H "Authorization: Bearer sk-your-api-key"

返回 4 种清晰度选项和背景音乐，与抖音使用相同的混合解析器。

快手

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://v.kuaishou.com/dEHKhN" \
  -H "Authorization: Bearer sk-your-api-key"

返回多清晰度视频流。

哔哩哔哩

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://www.bilibili.com/video/BV1cAQqBqEpT/" \
  -H "Authorization: Bearer sk-your-api-key"

返回 DASH 格式：6 个不同分辨率的视频流和 3 个不同编码的音频流。使用以下命令合并：

使用 ffmpeg 合并

ffmpeg -i video.mp4 -i audio.m4a -c copy output.mp4

YouTube

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk-your-api-key"

返回 20 多种视频格式（360p–4K、mp4/webm）和 4 个音轨（m4a/weba）。

直接粘贴分享文本

无需手动提取 URL，直接粘贴任意应用生成的原始分享文本：

抖音分享文本

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=5.61 复制打开抖音，看看【某某的作品】标题 https://v.douyin.com/xxxxx/ [email protected] 08/23" \
  -H "Authorization: Bearer sk-your-api-key"

小红书分享文本

curl -G "https://api.leaper.one/v1/social-media/video/extract" \
  --data-urlencode "url=25 【标题 - 作者 | 小红书】 😆 xxxxx 😆 https://www.xiaohongshu.com/discovery/item/xxxxx" \
  -H "Authorization: Bearer sk-your-api-key"

API 会自动从文本中提取 https:// 链接并进行解析。