/ 接口详情
蓝狗音乐概念版
使用蓝狗音乐概念版官方的接口获取音乐播放链接
接口信息
GET / POST
api.317ak.com/api/yinyue/kugougl/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/kugougl/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": "b83dbb8e3dd3fcf86bf32690b91547f5",
"cover": "http://imge.kugou.com/stdmusic/500/20250221/20250221180752107045.jpg",
"actualQuality": "标准音质",
"actualQualityCode": "128k",
"size": "4.09 MB",
"url": "http://fs.youthandroid2.kugou.com/202608130820/d9fdd9803e83905d8ee95485f55c4a67/v3/b83dbb8e3dd3fcf86bf32690b91547f5/yp/full/ap3116_us1011924939_mimusicapi_pi411_mx32125113_qu128_pa967177915_ct420600_s1410125025.mp3",
"lyric": "[id:$00000000]\r\n[ar:林俊杰]\r\n[ti:江南]\r\n[by:]\r\n[hash:b83dbb8e3dd3fcf86bf32690b91547f5]\r\n[al:]\r\n[sign:]\r\n[qq:]\r\n[total:267000]\r\n[offset:63]\r\n[00:00.43]林俊杰 - 江南\r\n[00:01.04]作词：林秋离\r\n[00:01.25]作曲：林俊杰\r\n[00:01.40]编曲：蔡政勋、陈建玮\r\n[00:37.10]风到这里就是黏\r\n[00:40.77]黏住过客的思念\r\n[00:44.84]雨到了这里缠成线\r\n[00:48.78]缠着我们留恋人世间\r\n[00:53.14]你在身边就是缘\r\n[00:56.79]缘分写在三生石上面\r\n[01:01.20]爱有万分之一甜\r\n[01:04.65]宁愿我就葬在这一点\r\n[01:08.95]圈圈圆圆圈圈\r\n[01:10.83]天天年年天天的我\r\n[01:13.51]深深看你的脸\r\n[01:16.09]生气的温柔\r\n[01:18.16]埋怨的温柔的脸\r\n[01:24.13]不懂爱恨情愁煎熬的我们\r\n[01:27.93]都以为相爱就像风云的善变\r\n[01:31.89]相信爱一天抵过永远\r\n[01:36.44]在这一刹那冻结了时间\r\n[01:39.98]不懂怎么表现温柔的我们\r\n[01:43.98]还以为殉情只是古老的传言\r\n[01:47.83]离愁能有多痛痛有多浓\r\n[01:52.53]当梦被埋在江南烟雨中\r\n[01:55.77]心碎了才懂\r\n[02:21.07]圈圈圆圆圈圈\r\n[02:22.95]天天年年天天的我\r\n[02:25.58]深深看你的脸\r\n[02:28.17]生气的温柔\r\n[02:30.19]埋怨的温柔的脸\r\n[02:36.37]不懂爱恨情愁煎熬的我们\r\n[02:40.02]都以为相爱就像风云的善变\r\n[02:43.92]相信爱一天抵过永远\r\n[02:48.22]在这一刹那冻结了时间\r\n[02:51.97]不懂怎么表现温柔的我们\r\n[02:55.66]还以为殉情只是古老的传言\r\n[02:59.86]离愁能有多痛痛有多浓\r\n[03:04.43]当梦被埋在江南烟雨中\r\n[03:07.72]心碎了才懂\r\n[03:20.25]相信爱一天抵过永远\r\n[03:24.50]在这一刹那冻结了时间\r\n[03:28.10]不懂怎么表现温柔的我们\r\n[03:31.86]还以为殉情只是古老的传言\r\n[03:35.91]离愁能有多痛痛有多浓\r\n[03:40.55]当梦被埋在江南烟雨中\r\n[03:45.72]心碎了才懂\r\n"
}
详细文档
蓝狗音乐概念版
接口说明
用于通过蓝狗音乐概念版官方接口获取音乐播放链接及相关歌曲信息。适合需要按歌名搜索并获取音乐播放资源的调用方使用。接口免费调用，但需要提供有效密钥。
调用地址
https://api-v2.317ak.com/api/yinyue/kugougl/api.php
请求方式
GET、POST
鉴权说明
接口调用需要进行鉴权，请通过 Query 参数传递调用密钥：
key=接口调用密钥
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥 |
| msg | string | 是 | 搜索的歌名，不传或为空时返回错误。例如：江南 |
| n | string | 否 | 选择第几首歌曲（从 1 开始）。不传或为空时返回列表模式，例如：1 表示第 1 首 |
| i | string | 否 | 直接指定歌曲 hash。传入后将忽略 msg 和 n，直接获取对应歌曲链接 |
| br | string | 否 | 音质设置参数 |
| page | string | 否 | 搜索页码，默认值为 1 |
| limit | string | 否 | 每页数量，默认值为 10 |
| type | string | 是 | 输出格式。json：完整信息（默认）；text：纯链接文本；mp3：跳转到音频 |
| lrc | string | 否 | 是否返回歌词。1：返回（默认）；0：不返回 |
| ck | string | 否 | 填写通过相关获取方式得到的 ck 内容 |
| string | 是 | 用户名，用于调用已保存的 ck 文件 |
成功响应示例
{
"success": true,
"code": 1,
"songName": "江南",
"artistName": "林俊杰",
"albumName": "第二天堂",
"hash": "b83dbb8e3dd3fcf86bf32690b91547f5",
"cover": "http://imge.kugou.com/stdmusic/500/20250221/20250221180752107045.jpg",
"actualQuality": "标准音质",
"actualQualityCode": "128k",
"size": "4.09 MB",
"url": "http://fs.youthandroid2.kugou.com/202608130820/d9fdd9803e83905d8ee95485f55c4a67/v3/b83dbb8e3dd3fcf86bf32690b91547f5/yp/full/ap3116_us1011924939_mimusicapi_pi411_mx32125113_qu128_pa967177915_ct420600_s1410125025.mp3",
"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/kugougl/api.php" \
--data-urlencode "key=你的密钥" \
--data-urlencode "msg=江南" \
--data-urlencode "type=json" \
--data-urlencode "n=1"PHP
// PHP
注意事项
- 请妥善保管接口调用密钥，避免将
key直接暴露在公开页面、前端代码、客户端安装包或可被他人获取的位置。 - 本接口通过 Query 参数
key进行鉴权，请确保请求中正确填写有效密钥，否则接口将无法正常调用。 msg为必填搜索内容，不传或传入空值时会返回错误结果。建议使用明确的歌曲名称以提高搜索准确性。- 当传入
i参数指定歌曲 hash 时，将直接获取对应歌曲链接，此时无需依赖msg和n参数。 n从 1 开始计数，用于选择搜索结果中的指定歌曲；不填写时返回搜索列表。type用于控制返回格式，请根据调用场景选择合适值：json：返回完整歌曲信息。text：仅返回播放链接文本。mp3：返回音频跳转结果。
page与limit用于控制搜索结果分页，未填写时会使用默认分页设置。br用于选择音质规格，请填写接口支持的有效值，避免因参数不匹配导致无法获取播放链接。- 如需歌词信息，可通过
lrc控制返回内容；不需要歌词时可关闭该选项以减少返回数据量。 - 使用 HTTPS 方式调用接口，避免请求过程中的敏感参数被泄露。
- 请根据实际业务场景合理控制调用频率，避免短时间内大量重复请求影响接口稳定性。
快速上手
curl -G "https://api-v2.317ak.com/api/yinyue/kugougl/api.php" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "msg=江南" \
--data-urlencode "type=json" \
--data-urlencode "n=1" \
--data-urlencode "qq=YOUR_QQ"在线测试
请求地址
api.317ak.com/api/yinyue/kugougl/api.php
Method
参数
Response
// 结果将在此处显示
