TuneHub API 接口文档
TuneHub 是一个统一的音乐信息解析服务。它打破了不同音乐平台之间的壁垒，提供了一套标准化的 API 接口。

Base URL: https://music-dl.sayqz.com

在线调试页面
- 访问首页 `/`（本仓库提供 `public/index.php`）即可在线填写参数并直接请求接口。
- 本地启动示例：`php -S 127.0.0.1:8000 -t public`，然后打开 `http://127.0.0.1:8000/`。

参数约定
- `source`：`netease` / `kuwo` / `qq`（内部会映射为 Meting 的 `tencent`）/ `auto`
- 对于会 302 跳转的接口（如 `type=url`、`type=pic`），调试时可加 `output=json` 返回 JSON，避免浏览器直接跳走。

支持的平台
平台标识 (source)	平台名称	状态
netease	网易云音乐	✅ 已启用
kuwo	酷我音乐	✅ 已启用
qq	QQ音乐	✅ 已启用
1. 获取歌曲基本信息
GET
调试此接口
GET /api/?source={source}&id={id}&type=info
获取歌曲的名称、歌手、专辑等基本元数据信息。

Response Example
{
  "code": 200,
  "message": "success",
  "data": {
    "name": "歌曲名称",
    "artist": "歌手名称",
    "album": "专辑名称",
    "url": "https://music-dl.sayqz.com/api/?source=netease&id=123456&type=url",
    "pic": "https://music-dl.sayqz.com/api/?source=netease&id=123456&type=pic",
    "lrc": "https://music-dl.sayqz.com/api/?source=netease&id=123456&type=lrc"
  },
  "timestamp": "2025-11-23T12:00:00.000+08:00"
}
2. 获取音乐文件链接
GET
调试此接口
GET /api/?source={source}&id={id}&type=url&br=[320k]
音质参数 (br) 对照表
值	说明	比特率
128k	标准音质	128kbps
320k	高品质	320kbps
flac	无损音质	~1000kbps
flac24bit	Hi-Res 音质	~1400kbps
💡 响应说明 (Response)
成功时返回 302 Redirect 到实际的音乐文件 URL。
自动换源：当请求的原平台失败时，系统会自动尝试其他平台。此时响应头会包含 X-Source-Switch 字段（例如：netease -> kuwo）。
3. 获取专辑封面
GET
调试此接口
获取歌曲的专辑封面图片。

GET /api/?source={source}&id={id}&type=pic
Response: 302 Redirect to image URL.
4. 获取歌词
GET
调试此接口
获取歌曲的 LRC 格式歌词。

GET /api/?source={source}&id={id}&type=lrc
Response Example (Text/Plain)
[00:00.00]歌词第一行
[00:05.50]歌词第二行
[00:10.20]歌词第三行
5. 搜索歌曲
GET
调试此接口
GET /api/?source={source}&type=search&keyword={keyword}&limit=[20]
Response Example
{
  "code": 200,
  "message": "success",
  "data": {
    "keyword": "周杰伦",
    "total": 10,
    "results": [
      {
        "id": "123456",
        "name": "歌曲名称",
        "artist": "周杰伦",
        "album": "专辑名称",
        "url": "https://music-dl.sayqz.com/api/?...",
        "platform": "netease"
      }
    ]
  }
}
6. 聚合搜索
GET
调试此接口
GET /api/?type=aggregateSearch&keyword={keyword}
Response Example
{
  "code": 200,
  "message": "success",
  "data": {
    "keyword": "周杰伦",
    "results": [
      {
        "id": "123456",
        "name": "歌曲名称",
        "artist": "周杰伦",
        "platform": "netease"
      },
      {
        "id": "789012",
        "name": "另一首歌",
        "artist": "周杰伦",
        "platform": "kuwo"
      }
    ]
  }
}
7-9. 歌单与排行榜
7. 获取歌单详情
调试
GET /api/?source={source}&id={id}&type=playlist
{
  "code": 200,
  "data": {
    "list": [
      {
        "id": "123456",
        "name": "歌曲名称",
        "types": ["flac", "320k", "128k"]
      }
    ],
    "info": {
      "name": "歌单名称",
      "author": "创建者"
    }
  }
}
8. 获取排行榜列表
调试
GET /api/?source={source}&type=toplists
{
  "code": 200,
  "data": {
    "list": [
      {
        "id": "19723756",
        "name": "飙升榜",
        "updateFrequency": "每天更新"
      }
    ]
  }
}
9. 获取排行榜歌曲
调试
GET /api/?source={source}&id={id}&type=toplist
{
  "code": 200,
  "data": {
    "list": [
      {
        "id": "123456",
        "name": "歌曲名称"
      }
    ],
    "source": "netease"
  }
}