/ 接口详情
蓝狗音乐
使用蓝狗官方的接口获取音乐播放链接
接口信息
GET / POST
api.317ak.com/api/yinyue/kugou/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": "使用蓝狗官方的接口获取音乐播放链接",
"version": "1.0.0"
},
"paths": {
"/api/yinyue/kugou/api.php": {
"get": {
"summary": "蓝狗音乐",
"description": "使用蓝狗官方的接口获取音乐播放链接",
"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": "使用蓝狗官方的接口获取音乐播放链接",
"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": "第二天堂",
"hash": "819b74bd09009e0422b8f563e12ba96e",
"cover": "http://imge.kugou.com/stdmusic/500/20250221/20250221180752107045.jpg",
"actualQuality": "无损音质",
"actualQualityCode": "flac",
"size": "29.93 MB",
"url": "http://fsandroid.tx.kugou.com/202605232021/0edaab408af9995ee304356652f18061/v3/ead5278c68e0f2af2d8e543f053c6c75/yp/full/ap1005_us1011924939_mimusicapi_pi2_mx32125113_quflac_ct420600_s3202019717.flac",
"lyric": "[id:$00000000]\r\n[ar:林俊杰]\r\n[ti:江南]\r\n[by:]\r\n[hash:3205ee278f932811b86875cd4685e9b2]\r\n[al:]\r\n[sign:]\r\n[qq:]\r\n[total:267860]\r\n[offset:-37]\r\n[00:00.21]林俊杰 - 江南\r\n[00:01.33]作词：李瑞洵\r\n[00:02.29]作曲：林俊杰\r\n[00:03.31]编曲：蔡政勋、陈建玮\r\n[00:37.25]风到这里就是黏\r\n[00:40.73]黏住过客的思念\r\n[00:45.06]雨到了这里缠成线\r\n[00:48.62]缠着我们留恋人世间\r\n[00:53.17]你在身边就是缘\r\n[00:56.55]缘分写在三生石上面\r\n[01:01.13]爱有万分之一甜\r\n[01:04.59]宁愿我就葬在这一点\r\n[01:09.21]圈圈圆圆圈圈\r\n[01:10.88]天天年年天天的我\r\n[01:13.71]深深看你的脸\r\n[01:16.05]生气的温柔\r\n[01:18.02]埋怨的温柔的脸\r\n[01:23.97]不懂爱恨情愁煎熬的我们\r\n[01:27.86]都以为相爱就像风云的善变\r\n[01:32.01]相信那一天抵过永远\r\n[01:36.27]在这一刹那冻结了时间\r\n[01:39.96]不懂怎么表现温柔的我们\r\n[01:43.80]还以为殉情只是古老的传言\r\n[01:47.79]离愁能有多痛痛有多浓\r\n[01:52.34]当梦被埋在江南烟雨中\r\n[01:55.64]心碎了才懂\r\n[02:21.09]圈圈圆圆圈圈\r\n[02:22.91]天天年年天天的我\r\n[02:25.73]深深看你的脸\r\n[02:28.06]生气的温柔\r\n[02:30.03]埋怨的温柔的脸\r\n[02:35.90]不懂爱恨情愁煎熬的我们\r\n[02:39.84]都以为相爱就像风云的善变\r\n[02:43.84]相信那一天抵过永远\r\n[02:48.24]在这一刹那冻结了时间\r\n[02:51.94]不懂怎么表现温柔的我们\r\n[02:55.83]还以为殉情只是古老的传言\r\n[02:59.82]离愁能有多痛痛有多浓\r\n[03:04.27]当梦被埋在江南烟雨中\r\n[03:07.56]心碎了才懂\r\n[03:20.22]相信那一天抵过永远\r\n[03:24.33]在这一刹那冻结了时间\r\n[03:27.91]不懂怎么表现温柔的我们\r\n[03:31.77]还以为殉情只是古老的传言\r\n[03:35.76]离愁能有多痛痛有多浓\r\n[03:40.31]当梦被埋在江南烟雨中\r\n[03:45.71]心碎了才懂\r\n"
}
详细文档
蓝狗音乐
接口说明
蓝狗音乐接口用于获取音乐播放相关信息，适用于需要接入音乐查询与播放能力的应用场景。
接口提供稳定的音乐数据调用服务，支持开发者快速集成。
调用地址
https://api-v2.317ak.com/api/yinyue/kugou/api.php
请求方式
GET、POST
鉴权说明
本接口调用需要密钥认证，请在请求参数中通过 Query 方式传递密钥：
key=接口调用密钥
每次请求需携带有效密钥后方可调用接口。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥 |
| msg | string | 是 | 搜索的歌名，不传或为空时返回错误 |
| n | string | 否 | 选择歌曲序号，不传或为空时返回列表模式 |
| i | string | 否 | 指定歌曲 hash，传入后直接获取对应歌曲链接 |
| br | string | 否 | 音质规格标识 |
| page | string | 否 | 搜索页码，默认值为 1 |
| limit | string | 否 | 每页数量，默认值为 10 |
| type | string | 是 | 输出格式，可选 json、text、mp3 |
| lrc | string | 否 | 是否返回歌词，默认返回歌词 |
| ck | string | 否 | 歌曲校验信息 |
| string | 是 | 用于调用保存信息的用户名 |
成功响应示例
{
"success": true,
"code": 1,
"songName": "江南",
"artistName": "林俊杰",
"albumName": "第二天堂",
"hash": "819b74bd09009e0422b8f563e12ba96e",
"cover": "http://imge.kugou.com/stdmusic/500/20250221/20250221180752107045.jpg",
"actualQuality": "无损音质",
"actualQualityCode": "flac",
"size": "29.93 MB",
"url": "http://fsandroid.tx.kugou.com/202605232021/0edaab408af9995ee304356652f18061/v3/ead5278c68e0f2af2d8e543f053c6c75/yp/full/ap1005_us1011924939_mimusicapi_pi2_mx32125113_quflac_ct420600_s3202019717.flac",
"lyric": "歌词内容"
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| code | number | 返回状态标识 |
| songName | string | 歌曲名称 |
| artistName | string | 歌手名称 |
| albumName | string | 专辑名称 |
| hash | string | 歌曲标识 |
| cover | string | 歌曲封面地址 |
| actualQuality | string | 实际音质描述 |
| actualQualityCode | string | 实际音质编码 |
| 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/kugou/api.php" \
--data-urlencode "key=你的接口密钥" \
--data-urlencode "msg=江南" \
--data-urlencode "n=1" \
--data-urlencode "type=json"PHP
// PHP
## 注意事项
- 调用接口前请妥善保管密钥，避免将 `key` 直接暴露在客户端代码、公开页面或可被他人获取的位置。
- 本接口要求通过 Query 参数 `key=…` 进行鉴权，请确保每次请求均携带有效密钥，否则请求可能失败。
- 接口调用地址需使用本站提供的固定地址：
`https://api-v2.317ak.com/api/yinyue/kugou/api.php`
- `msg` 为必填搜索内容，不传或传空值时会返回错误信息。建议传入准确的歌曲名称以提高搜索结果匹配度。
- `n` 用于选择搜索结果中的指定歌曲，未填写时返回歌曲列表；填写时请使用有效序号。
- 使用 `i` 参数指定歌曲 hash 时，将直接获取对应歌曲链接，此时无需依赖 `msg` 和 `n` 参数。
- `br` 参数用于选择音质规格，请根据实际需求填写对应取值，部分歌曲可能因资源情况无法提供指定音质。
- `page` 与 `limit` 用于控制搜索结果分页，未填写时将使用默认分页设置。
- `type` 为必填输出格式参数，可根据调用场景选择：
- `json`：返回完整歌曲信息；
- `text`：仅返回播放链接文本；
- `mp3`：返回音频跳转响应。
- 如需歌词内容，请合理设置 `lrc` 参数；关闭歌词返回可减少部分响应内容。
- `ck` 与 `qq` 参数涉及歌曲信息调用配置，请确保传入内容格式正确，避免因参数错误导致请求异常。
- 建议使用 HTTPS 方式访问接口，避免请求数据在传输过程中被第三方获取。
- 请根据实际业务场景控制调用频率，避免短时间内大量重复请求影响接口稳定性。快速上手
curl "https://api-v2.317ak.com/api/yinyue/kugou/api.php?key=YOUR_API_KEY&msg=%E6%B1%9F%E5%8D%97&n=1&type=json"在线测试
请求地址
api.317ak.com/api/yinyue/kugou/api.php
Method
参数
Response
// 结果将在此处显示
