/ 接口详情
大鹅音乐
维护中
可以点VIP音乐，优化了返回结果。增加了音质选择，请求参数优化。
当前接口维护中，暂时无法调用。
接口信息
GET / POST
api.317ak.com/api/yinyue/qqyinyue/api.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| msg | string | 是 | 搜索的歌名(必填,不传或为空时返回错误) | 江南 |
| n | string | 否 | 选第几首(1-based)。不传或为空 => 列表模式;1=第1首,2=第2首,以此类推 | 1 |
| i | string | 否 | 直接指定歌曲hash(传了i则忽略msg/n,直接取链) | |
| br | string | 否 | 音质数字，对应规格如下 | 1 |
| page | string | 否 | 搜索页码,默认1 | 1 |
| limit | string | 否 | 每页数量,默认10 | 10 |
| type | string | 是 | 输出格式。json=完整信息(默认) / text=纯链接文本 / mp3=302跳转到音频 | json |
| lrc | string | 否 | 是否返回歌词。1=返回(默认) / 0=不返回 | 1 |
| ck | string | 否 | 通过获取ck工具获取的全部ck，填写进来 | {"musicid":3121871622,"musickey":"Q_H_L_63k3NW9T3Ubu_DejkXTDE6pstF7vD6clNhyMIUdLPzSo6Klqz5ToykmzU3BmdXRaMJSNVgKzNzNKeHivjYJcgmKVC9npbQ8RqRVw_SxBi6T3cbDqDFcxxfQyznylW3rjwDO_T8HjarJsijy4XexKKlBvH5E-IIQ" |
| string | 是 | 用户名用语于调用储存的ck文件 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "搜索的歌名(必填,不传或为空时返回错误)",
"example": "江南"
},
{
"name": "n",
"type": "string",
"required": false,
"description": "选第几首(1-based)。不传或为空 => 列表模式;1=第1首,2=第2首,以此类推",
"example": "1"
},
{
"name": "i",
"type": "string",
"required": false,
"description": "直接指定歌曲hash(传了i则忽略msg/n,直接取链)",
"example": ""
},
{
"name": "br",
"type": "string",
"required": false,
"description": "音质数字，对应规格如下",
"example": "1"
},
{
"name": "page",
"type": "string",
"required": false,
"description": "搜索页码,默认1",
"example": "1"
},
{
"name": "limit",
"type": "string",
"required": false,
"description": "每页数量,默认10",
"example": "10"
},
{
"name": "type",
"type": "string",
"required": true,
"description": "输出格式。json=完整信息(默认) / text=纯链接文本 / mp3=302跳转到音频",
"example": "json"
},
{
"name": "lrc",
"type": "string",
"required": false,
"description": "是否返回歌词。1=返回(默认) / 0=不返回",
"example": "1"
},
{
"name": "ck",
"type": "string",
"required": false,
"description": "通过获取ck工具获取的全部ck，填写进来",
"example": "{\"musicid\":3121871622,\"musickey\":\"Q_H_L_63k3NW9T3Ubu_DejkXTDE6pstF7vD6clNhyMIUdLPzSo6Klqz5ToykmzU3BmdXRaMJSNVgKzNzNKeHivjYJcgmKVC9npbQ8RqRVw_SxBi6T3cbDqDFcxxfQyznylW3rjwDO_T8HjarJsijy4XexKKlBvH5E-IIQ\""
},
{
"name": "qq",
"type": "string",
"required": true,
"description": "用户名用语于调用储存的ck文件",
"example": ""
}
]
{
"openapi": "3.1.1",
"info": {
"title": "大鹅音乐",
"description": "可以点VIP音乐，优化了返回结果。增加了音质选择，请求参数优化。",
"version": "1.0.0"
},
"paths": {
"/api/yinyue/qqyinyue/api.php": {
"get": {
"summary": "大鹅音乐",
"description": "可以点VIP音乐，优化了返回结果。增加了音质选择，请求参数优化。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "msg",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "江南"
},
"description": "搜索的歌名(必填,不传或为空时返回错误)"
},
{
"name": "n",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "选第几首(1-based)。不传或为空 => 列表模式;1=第1首,2=第2首,以此类推"
},
{
"name": "i",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "直接指定歌曲hash(传了i则忽略msg/n,直接取链)"
},
{
"name": "br",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "音质数字，对应规格如下"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "搜索页码,默认1"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "每页数量,默认10"
},
{
"name": "type",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "json"
},
"description": "输出格式。json=完整信息(默认) / text=纯链接文本 / mp3=302跳转到音频"
},
{
"name": "lrc",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "是否返回歌词。1=返回(默认) / 0=不返回"
},
{
"name": "ck",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "{\"musicid\":3121871622,\"musickey\":\"Q_H_L_63k3NW9T3Ubu_DejkXTDE6pstF7vD6clNhyMIUdLPzSo6Klqz5ToykmzU3BmdXRaMJSNVgKzNzNKeHivjYJcgmKVC9npbQ8RqRVw_SxBi6T3cbDqDFcxxfQyznylW3rjwDO_T8HjarJsijy4XexKKlBvH5E-IIQ\""
},
"description": "通过获取ck工具获取的全部ck，填写进来"
},
{
"name": "qq",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "用户名用语于调用储存的ck文件"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "大鹅音乐",
"description": "可以点VIP音乐，优化了返回结果。增加了音质选择，请求参数优化。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "msg",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "江南"
},
"description": "搜索的歌名(必填,不传或为空时返回错误)"
},
{
"name": "n",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "选第几首(1-based)。不传或为空 => 列表模式;1=第1首,2=第2首,以此类推"
},
{
"name": "i",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "直接指定歌曲hash(传了i则忽略msg/n,直接取链)"
},
{
"name": "br",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "音质数字，对应规格如下"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "搜索页码,默认1"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "每页数量,默认10"
},
{
"name": "type",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "json"
},
"description": "输出格式。json=完整信息(默认) / text=纯链接文本 / mp3=302跳转到音频"
},
{
"name": "lrc",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "是否返回歌词。1=返回(默认) / 0=不返回"
},
{
"name": "ck",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "{\"musicid\":3121871622,\"musickey\":\"Q_H_L_63k3NW9T3Ubu_DejkXTDE6pstF7vD6clNhyMIUdLPzSo6Klqz5ToykmzU3BmdXRaMJSNVgKzNzNKeHivjYJcgmKVC9npbQ8RqRVw_SxBi6T3cbDqDFcxxfQyznylW3rjwDO_T8HjarJsijy4XexKKlBvH5E-IIQ\""
},
"description": "通过获取ck工具获取的全部ck，填写进来"
},
{
"name": "qq",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "用户名用语于调用储存的ck文件"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https://api.317ak.com",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"success": true,
"code": 1,
"songName": "江南",
"artistName": "林俊杰",
"albumName": "第二天堂",
"mid": "004TXEXY2G2c7C",
"cover": "https://y.gtimg.cn/music/photo_new/T002R300x300M000000y5gq7449K9I.jpg",
"actualQuality": "流畅音质 AAC 96K",
"actualQualityCode": 1,
"size": "3.11 MB",
"url": "https://isure.stream.qqmusic.qq.com/C400003NikJo0a0uzm.m4a?guid=9985721428&vkey=47E116A898176A2CEB9111F8DCED1CBD348EB3A51E9D9AF2799B8049594B6ECC118C7957A3216AFC7CA38DD5117D78ADE8E0006CD5C0CF16__v21e29702f&uin=3121871622&redirect=1",
"lyric": "[ti:江南]\n[ar:林俊杰]\n[al:靓点屋精选辑]\n[by:]\n[offset:0]\n[00:00.00]江南 - 林俊杰 (JJ Lin)\n[00:09.28]词：李瑞洵\n[00:18.56]曲：林俊杰\n[00:27.85]编曲：蔡政勋/陈建玮\n[00:37.13]风到这里就是黏\n[00:39.46]\n[00:40.56]黏住过客的思念\n[00:43.42]\n[00:45.03]雨到了这里缠成线\n[00:47.53]\n[00:48.68]缠着我们留恋人世间\n[00:51.52]\n[00:53.02]你在身边就是缘\n[00:55.29]\n[00:56.54]缘分写在三生石上面\n[00:59.61]\n[01:01.07]爱有万分之一甜\n[01:03.44]\n[01:04.58]宁愿我就葬在这一点\n[01:07.80]\n[01:08.90]圈圈圆圆圈圈\n[01:10.87]天天年年天天的我\n[01:13.72]深深看你的脸\n[01:16.02]生气的温柔\n[01:18.05]埋怨的温柔的脸\n[01:23.39]\n[01:24.17]不懂爱恨情愁煎熬的我们\n[01:27.80]都以为相爱就像风云的善变\n[01:31.36]\n[01:32.00]相信爱一天抵过永远\n[01:35.99]\n[01:36.73]在这一刹那冻结了时间\n[01:39.42]\n[01:40.26]不懂怎么表现温柔的我们\n[01:43.94]还以为殉情只是古老的传言\n[01:48.09]离愁能有多痛痛有多浓\n[01:52.34]当梦被埋在江南烟雨中\n[01:55.56]心碎了才懂\n[01:58.81]\n[02:21.27]圈圈圆圆圈圈\n[02:22.81]天天年年天天的我\n[02:25.85]深深看你的脸\n[02:28.11]生气的温柔\n[02:30.20]埋怨的温柔的脸\n[02:35.54]\n[02:36.08]不懂爱恨情愁煎熬的我们\n[02:39.84]都以为相爱就像风云的善变\n[02:43.91]相信爱一天抵过永远\n[02:48.24]在这一刹那冻结了时间\n[02:52.20]不懂怎么表现温柔的我们\n[02:55.81]还以为殉情只是古老的传言\n[02:59.24]\n[02:59.97]离愁能有多痛痛有多浓\n[03:04.34]当梦被埋在江南烟雨中\n[03:07.62]心碎了才懂\n[03:11.12]\n[03:20.13]相信爱一天抵过永远\n[03:24.40]在这一刹那冻结了时间\n[03:28.51]不懂怎么表现温柔的我们\n[03:32.15]还以为殉情只是古老的传言\n[03:36.21]离愁能有多痛痛有多浓\n[03:40.39]当梦被埋在江南烟雨中\n[03:45.69]心碎了才懂"
}
详细文档
大鹅音乐
接口说明
大鹅音乐接口用于搜索并获取音乐资源信息，支持音乐播放相关调用。
适用于需要接入音乐查询与获取服务的应用或开发场景。
调用地址
https://api-v2.317ak.com/api/yinyue/qqyinyue/api.php
请求方式
GET、POST
鉴权说明
接口调用需要进行鉴权，请在 Query 参数中传递 key=… 进行身份验证。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥，通过 Query 参数 key 传递 |
| msg | string | 是 | 搜索的歌名，不传或为空时返回错误 |
| n | string | 否 | 选择歌曲序号（从 1 开始）。不传或为空时返回歌曲列表 |
| i | string | 否 | 直接指定歌曲 hash。传入后将忽略 msg 和 n，直接获取对应歌曲链接 |
| br | string | 否 | 音质选择参数 |
| page | string | 否 | 搜索页码，默认值为 1 |
| limit | string | 否 | 每页返回数量，默认值为 10 |
| type | string | 是 | 输出格式，可选 json、text、mp3。json 返回完整信息，text 返回纯链接文本，mp3 返回音频跳转 |
| lrc | string | 否 | 是否返回歌词。默认返回歌词 |
| ck | string | 否 | 歌曲校验信息参数 |
| string | 是 | 用户标识，用于调用已保存的信息 |
音质参数说明
br 用于选择返回音频质量，填写对应音质参数即可。
成功响应示例
{
"success": true,
"code": 1,
"songName": "江南",
"artistName": "林俊杰",
"albumName": "第二天堂",
"mid": "004TXEXY2G2c7C",
"cover": "https://y.gtimg.cn/music/photo_new/T002R300x300M000000y5gq7449K9I.jpg",
"actualQuality": "流畅音质 AAC 96K",
"actualQualityCode": 1,
"size": "3.11 MB",
"url": "https://isure.stream.qqmusic.qq.com/C400003NikJo0a0uzm.m4a",
"lyric": "[ti:江南]\n[ar:林俊杰]\n[al:第二天堂]\n[00:00.00]江南 - 林俊杰"
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| code | number | 返回状态标识 |
| songName | string | 歌曲名称 |
| artistName | string | 歌手名称 |
| albumName | string | 专辑名称 |
| mid | string | 歌曲标识 |
| cover | string | 歌曲封面地址 |
| actualQuality | string | 实际返回的音质信息 |
| actualQualityCode | number | 音质标识 |
| size | string | 音频文件大小 |
| url | string | 音频播放地址 |
| lyric | string | 歌词内容 |
错误响应示例
请求失败时，接口返回统一错误结构：
{
"code":0,
"msg":"未提供调用密钥",
"errcode":11001
}
业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | 外部请求地址无效 |
| 11015 | 外部请求地址不允许 |
| 11016 | 外部请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用指定出口服务须提供有效密钥 |
| 11021 | 未配置可用出口服务 |
| 11022 | 出口服务不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
调用示例
终端 curl（bash）
curl -G "https://api-v2.317ak.com/api/yinyue/qqyinyue/api.php" \
--data-urlencode "key=YOUR_KEY" \
--data-urlencode "msg=江南" \
--data-urlencode "type=json" \
--data-urlencode "n=1"PHP
// PHP
$url = "https://api-v2.317ak.com/api/yinyue/qqyinyue/api.php?key=YOUR_KEY&msg=江南&type=json&n=1";
$response = file_get_contents($url);
echo $response;注意事项
-
请妥善保管接口调用密钥
key，避免泄露、公开分享或提交到不受信任的环境中。 -
请勿将接口密钥直接暴露在前端页面、客户端代码或公开仓库中，建议通过服务端调用接口。
-
本接口需要通过 Query 参数
key=...进行鉴权，请确保请求中正确携带有效密钥。 -
建议使用 HTTPS 请求接口地址，避免请求参数在传输过程中被窃取。
-
msg为必填参数，用于搜索歌曲名称；未传入或为空时接口会返回错误信息。 -
使用
n参数选择歌曲时，从1开始计数；不传n时默认返回搜索列表。 -
传入
i（歌曲 hash）后会直接获取对应歌曲信息，此时会忽略msg和n参数。 -
br用于选择音质规格，请根据实际需求填写对应音质值。 -
page与limit用于控制搜索结果分页，未传入时分别默认为第 1 页和每页 10 条。 -
type参数决定返回格式，请根据业务场景选择json、text或mp3。 -
如需歌词信息，可通过
lrc参数控制返回内容；不传时默认返回歌词。 -
使用
ck参数时，请确保传入内容格式完整有效；参数内容较长时注意避免因编码、转义问题导致请求失败。 -
qq参数用于调用已保存的信息，请确保填写正确的用户名。 -
请根据业务需求合理控制调用频率，避免短时间内大量重复请求影响接口稳定性。
-
返回的歌曲信息、音频链接及歌词内容请遵循相关平台规则和版权要求使用。
快速上手
curl "https://api-v2.317ak.com/api/yinyue/qqyinyue/api.php?key=YOUR_API_KEY&msg=%E6%B1%9F%E5%8D%97&type=json&n=1&br=1&lrc=1" \
-X GET在线测试
维护中，暂不可测试。
