聚合视频解析

提供抖音、小红书、哔哩哔哩统一视频解析接口

GET https://api.odysphere.tech/jiexi

接口描述

本API服务提供统一的视频平台聚合解析接口，客户端无需判断具体平台，只需提交视频链接，服务端会根据链接域名自动判断平台调用对应的抖音、小红书或哔哩哔哩解析器。

接口列表

https://api.odysphere.tech/jiexi

HTTPS GET - 自动识别平台并进行视频解析

https://api.odysphere.tech/jiexi

HTTPS POST - 自动识别平台并进行视频解析

平台识别规则

域名	平台
douyin.com	抖音
v.douyin.com	抖音
xiaohongshu.com	小红书
xhslink.com	小红书
xhs.com	小红书
bilibili.com	哔哩哔哩
b23.tv	哔哩哔哩

HTTPS GET 请求示例

GET /jiexi?url=https%3A%2F%2Fv.douyin.com%2Fxxxx%2F HTTP/1.1
Host: api.odysphere.tech

响应数据示例

{
  "code": 200,
  "msg": "解析成功",
  "data": {
    "type": "video",
    "title": "抖音视频标题",
    "desc": "抖音视频描述",
    "author": {
      "name": "作者名称",
      "id": "123456789",
      "avatar": "https://example.com/avatar.jpg"
    },
    "cover": "https://example.com/cover.jpg",
    "url": "https://example.com/video.mp4",
    "duration": 17834,
    "video_backup": [
      "https://example.com/video_backup.mp4"
    ],
    "images": [],
    "live_photo": [],
    "music": {
      "title": "背景音乐",
      "author": "音乐作者",
      "url": "https://example.com/music.mp3",
      "cover": "https://example.com/music.jpg"
    },
    "video_id": "v0300xxxxxxxx"
  },
  "platform": "douyin"
}

字段说明

字段名	类型	说明
`code`	number	下游解析器返回的业务状态码
`msg`	string	下游解析器返回的解析结果说明
`data`	object/array	对应平台解析器返回的数据主体
`platform`	string	聚合接口识别出的平台

状态码说明

状态码	描述
200	解析成功
400	链接为空、无法识别链接或暂不支持该平台
404	下游平台解析器未找到有效内容时可能返回
500	聚合服务或下游解析服务发生错误

使用说明

推荐优先使用本聚合接口。调用方无需单独判断抖音、小红书和B站，只需提交 url 参数。

本接口结构可能发生改动，使用时请以实际返回内容为准。

免责声明：本API不提供任何 SLA 保证，因此也不对因平台限制、数据延迟、解析失败、链接失效或数据不完整等造成的直接或间接损失负责。使用时即代表知晓并同意。

接口描述

本API服务提供抖音短视频、图集、实况视频解析，返回结构化 JSON 数据，可获取视频直链、封面、作者信息、背景音乐、图集等信息。

接口列表

https://api.odysphere.tech/jiexi/douyin

HTTPS GET - 提供抖音短视频、图集、实况解析

HTTPS GET 请求示例

GET /jiexi/douyin?url=https%3A%2F%2Fv.douyin.com%2Fxxxx%2F HTTP/1.1
Host: api.odysphere.tech

响应数据示例

{
  "code": 200,
  "msg": "解析成功",
  "data": {
    "type": "video",
    "title": "视频标题",
    "desc": "视频描述内容",
    "author": {
      "name": "作者名称",
      "id": "123456789",
      "avatar": "https://example.com/avatar.jpg"
    },
    "cover": "https://example.com/cover.jpg",
    "url": "https://example.com/video.mp4",
    "duration": 17834,
    "video_backup": [
      "https://example.com/video_backup_1.mp4"
    ],
    "images": [],
    "live_photo": [],
    "music": {
      "title": "背景音乐标题",
      "author": "背景音乐作者",
      "url": "https://example.com/music.mp3",
      "cover": "https://example.com/music_cover.jpg"
    },
    "video_id": "v0300xxxxxxxxxxxxxxxx"
  }
}

上述字段结构来自当前抖音解析器实际返回格式。图集及实况内容返回的字段会根据内容类型有所不同。

字段说明

字段名	类型	说明
`code`	number	业务状态码，200 表示解析成功
`msg`	string	解析结果说明
`data`	object/array	解析数据主体
`data.type`	string	内容类型：video / image / live / unknown
`data.title`	string	视频或内容标题
`data.desc`	string	视频描述文本
`data.author`	object	作者信息
`data.author.name`	string	作者昵称
`data.author.id`	string/number	作者唯一标识
`data.author.avatar`	string	作者头像 URL
`data.cover`	string	封面图片 URL
`data.url`	string/null	视频主直链，视频类型时返回
`data.duration`	number/null	视频时长，单位通常为毫秒
`data.video_backup`	array	视频备用直链列表
`data.video_id`	string	视频唯一标识
`data.images`	array	图集图片 URL 列表
`data.live_photo`	array	实况资源列表，每项包含 image、video
`data.music`	object	背景音乐信息
`data.music.title`	string	音乐标题
`data.music.author`	string	音乐作者
`data.music.url`	string	音乐直链
`data.music.cover`	string	音乐封面 URL

状态码说明

状态码	描述
200	解析成功
400	请求参数错误或链接格式错误
404	未找到有效内容
500	解析请求失败或服务器错误

使用说明

接口描述

本API服务提供小红书图文、视频、实况内容解析，支持小红书主域名及短链接，返回结构化 JSON 数据，可获取标题、描述、作者、封面、视频直链、图集及实况资源等信息。

接口列表

https://api.odysphere.tech/jiexi/xhs

HTTPS GET - 提供小红书图文、视频、实况解析

HTTPS GET 请求示例

GET /jiexi/xhs?url=https%3A%2F%2Fwww.xiaohongshu.com%2Fexplore%2Fxxxx HTTP/1.1
Host: api.odysphere.tech

响应数据示例

{
  "code": 200,
  "msg": "解析成功",
  "data": {
    "type": "video",
    "title": "小红书视频标题",
    "desc": "小红书笔记描述",
    "author": {
      "name": "作者名称",
      "id": "123456789",
      "avatar": "https://example.com/avatar.jpg"
    },
    "cover": "https://example.com/cover.jpg",
    "url": "https://example.com/video.mp4",
    "images": [],
    "live_photo": [],
    "video_backup": null
  }
}

小红书解析器会根据内容类型返回 video、image 或 live，视频类型会返回 url 和 video_backup，图文类型会返回 images，实况内容会返回 live_photo。

字段说明

字段名	类型	说明
`code`	number	业务状态码，200 表示解析成功
`msg`	string	解析结果说明
`data`	object	解析数据主体
`data.type`	string	内容类型：video / image / live
`data.title`	string	笔记标题
`data.desc`	string	笔记描述
`data.author`	object	作者信息
`data.author.name`	string	作者昵称
`data.author.id`	string	作者唯一 ID
`data.author.avatar`	string	作者头像 URL
`data.cover`	string	封面 URL
`data.url`	string/null	视频主直链，视频类型时返回
`data.video_backup`	string/null	第二备用视频直链，没有时为 null
`data.images`	array	图集图片 URL 列表
`data.live_photo`	array	实况资源列表，每项包含 image、video

状态码说明

状态码	描述
200	解析成功
400	请求参数错误或链接格式错误
404	未找到有效内容
500	服务器错误

使用说明

接口描述

本API服务提供哔哩哔哩视频解析，可自动获取视频 BV 号、视频标题、封面、作者、视频直链以及多分P视频信息。

接口列表

https://api.odysphere.tech/jiexi/bilibili

HTTPS GET - 提供哔哩哔哩视频及分P内容解析

请求参数

参数名	类型	描述	是否必填
`url`	string	哔哩哔哩视频链接或 b23.tv 短链接	是

当前接口会对 b23.tv 自动跟随重定向并提取最终视频 BV 号。

HTTPS GET 请求示例

GET /jiexi/bilibili?url=https%3A%2F%2Fwww.bilibili.com%2Fvideo%2FBVxxxxxxxxxx HTTP/1.1
Host: api.odysphere.tech

响应数据示例（单P视频）

{
  "code": 200,
  "msg": "解析成功！",
  "data": {
    "title": "视频标题",
    "cover": "https://example.com/cover.jpg",
    "description": "视频简介",
    "url": "https://example.com/video.mp4",
    "user": {
      "name": "作者名称",
      "avatar": "https://example.com/avatar.jpg"
    }
  }
}

响应数据示例（多P视频/合集）

{
  "code": 200,
  "msg": "解析成功！",
  "data": {
    "title": "视频合集标题",
    "cover": "https://example.com/cover.jpg",
    "description": "视频简介",
    "url": "https://example.com/video.mp4",
    "user": {
      "name": "作者名称",
      "avatar": "https://example.com/avatar.jpg"
    },
    "videos": [
      {
        "title": "第一P",
        "duration": 120,
        "durationFormat": "00:01:59",
        "url": "https://example.com/video1.mp4",
        "index": 1
      },
      {
        "title": "第二P",
        "duration": 180,
        "durationFormat": "00:02:59",
        "url": "https://example.com/video2.mp4",
        "index": 2
      }
    ],
    "totalVideos": 2
  }
}

当前代码会遍历所有分P并尝试获取每个分P的视频直链；当存在多个分P时，会额外返回 videos 与 totalVideos。

字段说明

字段名	类型	说明
`code`	number	业务状态码，200 表示解析成功
`msg`	string	解析结果说明
`data`	object	解析数据主体
`data.title`	string	视频标题
`data.cover`	string	视频封面 URL
`data.description`	string	视频简介
`data.url`	string/null	主视频直链
`data.user`	object	作者信息
`data.user.name`	string	作者名称
`data.user.avatar`	string	作者头像 URL
`data.videos`	array	多P视频列表，多P内容时返回
`data.videos[].title`	string	分P标题
`data.videos[].duration`	number	分P时长，单位秒
`data.videos[].durationFormat`	string	格式化后的分P时长
`data.videos[].url`	string/null	分P视频直链
`data.videos[].index`	number	分P序号，从 1 开始
`data.totalVideos`	number	分P总数

状态码说明

状态码	描述
200	解析成功
201	链接不能为空
-1	视频链接格式错误或不是视频链接
404	获取 BV 号失败
0	解析失败

使用说明

接口描述

本API服务提供网易云音乐歌曲解析，支持通过网易云歌曲 ID 或网易云音乐链接获取歌曲直链、歌曲信息、封面、歌手、专辑、歌词及音质信息。当前接口同时支持 ids 与 url 两种输入方式。

接口列表

https://api.odysphere.tech/jiexi/wyy

HTTPS GET - 提供网易云音乐解析

请求参数

参数名	类型	描述	是否必填
`ids`	string	网易云音乐歌曲 ID	与 url 二选一
`url`	string	网易云音乐歌曲链接	与 ids 二选一
`level`	string	请求的音乐音质	是
`type`	string	返回类型	是

音质参数

参数值	说明
standard	标准音质
exhigh	极高音质
lossless	无损音质
hires	Hires 音质
sky	沉浸环绕声
jyeffect	高清环绕声
jymaster	超清母带

返回类型

参数值	说明
json	返回 JSON 数据
text	返回 HTML 格式的歌曲信息
down	重定向到歌曲音频地址

HTTPS GET 请求示例

使用歌曲 ID：

GET /jiexi/wyy?ids=19610381&level=standard&type=json HTTP/1.1
Host: api.odysphere.tech

使用网易云歌曲链接：

GET /jiexi/wyy?url=https%3A%2F%2Fmusic.163.com%2Fsong%3Fid%3D19610381&level=standard&type=json HTTP/1.1
Host: api.odysphere.tech

JSON 响应数据示例

{
  "status": 200,
  "name": "歌曲名称",
  "pic": "https://example.com/cover.jpg",
  "ar_name": "歌手名称",
  "al_name": "专辑名称",
  "level": "标准音质",
  "size": "8.52MB",
  "url": "https://example.com/song.flac",
  "lyric": "歌词内容",
  "tlyric": "翻译歌词内容"
}

字段说明

字段名	类型	说明
`status`	number	业务状态码，200 表示解析成功
`name`	string	歌曲名称
`pic`	string	歌曲封面 URL
`ar_name`	string	歌手名称，多个歌手使用逗号分隔
`al_name`	string	专辑名称
`level`	string	最终实际返回的歌曲音质
`size`	string	音频文件大小
`url`	string	歌曲音频直链
`lyric`	string	原歌词
`tlyric`	string/null	翻译歌词，没有时可能为 null

状态码说明

状态码	描述
200	解析成功
400	请求参数错误、参数不完整或无法获取完整信息

使用说明

ids 与 url 不需要同时提交，二者任选其一。level 与 type 为必填参数。

免责声明：本API不提供任何 SLA 保证，因此也不对因版权限制、账号权限、数据延迟、解析失败、链接失效或数据不完整等造成的直接或间接损失负责。使用时即代表知晓并同意。

解析API - 枫霖的API服务

聚合视频解析

接口描述

接口列表

平台识别规则

HTTPS GET 请求示例

响应数据示例

字段说明

状态码说明

使用说明

接口描述

接口列表

HTTPS GET 请求示例

响应数据示例

字段说明

状态码说明

使用说明

接口描述

接口列表

HTTPS GET 请求示例

响应数据示例

字段说明

状态码说明

使用说明

接口描述

接口列表

请求参数

HTTPS GET 请求示例

响应数据示例（单P视频）

响应数据示例（多P视频/合集）

字段说明

状态码说明

使用说明

接口描述

接口列表

请求参数

音质参数

返回类型

HTTPS GET 请求示例

JSON 响应数据示例

字段说明

状态码说明

使用说明