Meting-API 使用说明

2026-02-28

欢迎使用本站提供的KUGOU_API解析服务~

1. 基础地址

主地址：https://api.kfjie.me/music
请求方式：GET
用途：给 MetingJS、APlayer 和站内自定义播放器提供统一数据入口
管理页登录：https://api.kfjie.me/music/manage/login
管理页监控：https://api.kfjie.me/music/manage/monitor

2. 常用参数

接口最常用的 3 个参数如下：

参数	说明
`server`	平台，如 `netease`、`tencent`、`kugou`
`type`	操作类型，如 `search`、`song`、`playlist`、`album`
`id`	对应平台的资源 ID、关键词、哈希，或酷狗桌面歌单分享短码/链接

常见 type：

`type`	作用	返回
`search`	搜索歌曲	JSON 数组
`song`	获取单曲详情	JSON 数组
`playlist`	获取歌单列表	JSON 数组
`album`	获取专辑歌曲	JSON 数组
`artist`	获取歌手热门歌曲	JSON 数组
`url`	获取播放地址	302 / 404
`pic`	获取封面地址	302
`lrc`	获取歌词	文本

3. 返回结果长什么样

search / song / album / artist / playlist 一般返回 JSON 数组：

[
  {
    "title": "歌曲名称",
    "author": "艺术家1 / 艺术家2",
    "url": "https://api.kfjie.me/music?server=netease&type=url&id=xxx&auth=xxx",
    "pic": "https://api.kfjie.me/music?server=netease&type=pic&id=xxx&auth=xxx",
    "lrc": "https://api.kfjie.me/music?server=netease&type=lrc&id=xxx&auth=xxx"
  }
]

url / pic 会直接 302 跳转到真实资源；lrc 返回歌词文本。实际接入里一般不需要手动拼这些子链接，播放器会直接消费 song / album 等返回结果里的现成字段。

4. 关于 `auth` `key`

url / pic / lrc 这类敏感资源会带上 auth。日常接入时通常不需要手动计算，直接使用接口返回的现成链接即可。

如果你持有服务端分配的 key，也可以在请求里附带 key=... 直接使用酷狗 Pro 池，并在对应分钟额度内继续访问 url / pic / lrc，这类场景可不再额外拼 auth。

5. 最常见的接入方式

场景 A：前端接入 (MetingJS)

只需要把统一 API 地址指向本站接口：

<!-- 设定接口主轴引擎 -->
<script>
    var meting_api = 'https://api.kfjie.me/music?server=:server&type=:type&id=:id&auth=:auth&r=:r';
</script>
<!-- 调用指定参数渲染音乐卡片 -->
<meting-js server="netease" type="song" id="29732235"></meting-js>

场景 B：终端快速测试

可以用这些东西快速测一下是否正常：

获取歌曲详情信息：

curl "https://api.kfjie.me/music?server=kugou&type=song&id=d0ee43db52939cb9feefa4513573ffb4"

搜索特定歌手资源：

curl "https://api.kfjie.me/music?server=kugou&type=search&id=邓紫棋"

获取酷狗桌面分享歌单：

curl "https://api.kfjie.me/music?server=kugou&type=playlist&id=7PUvhf0FZV2"

6. 使用建议

需要播放器时，优先用 song / playlist / album 返回的现成 url、pic、lrc
需要排障时，先测 search 或 song，再看播放器是否能正常消费返回结果
对酷狗桌面歌单分享，优先传短码或 t1.kugou.com 短链，避免直接依赖带签名参数的长链接
对酷狗场景，运行时更推荐直接使用歌曲哈希而不是依赖专辑展开
当前酷狗歌单可使用桌面版KUGOU分享链路，可详细获取到酷狗全部歌单，推荐使用标准 type=playlist，并把 id 传成分享短码或短链，例如 7PUvhf0FZV2 或 https://t1.kugou.com/7PUvhf0FZV2。
手机版分享链接暂时无法解析。
~~或许使用酷狗码可以？但是好累啊不想搞了，有没有人给点现成的~~