参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
action	string	是	操作类型，仅可为：search（搜索）、detail（歌曲详情）、play（获取播放）、mv（MV资源）、lyric（歌词资源）
type	string	否	搜索资源类型，仅当action为search时有效，仅可为：mv（MV资源）、song（歌曲资源）	song
keyword	string	否	搜索资源名称，仅当action为search时有效	起风了
hash	string	否	资源hash的id，仅当action为detail（歌曲详情）、play（获取播放）、mv（MV资源）、lyric（歌词资源）时有效，注意：此字段可变，quality=flac 用 sq_hash，res 用 res_hash，super 用 super_hash	F125DA898596AC226085281F476BDB7E
quality	string	否	音质映射，res/hires→res、super→super、flac→flac、high→high、320→320、128→128，注意：res、super需要解密，建议flac及以下音质	flac
mixsong_id	string	否	资源id，仅当action为play时有效	264086632

酷狗音乐

接口说明

提供酷狗音乐资源的搜索与获取能力，支持歌曲与 MV 搜索，并可获取歌曲详情、播放地址、MV 及歌词资源。适用于需要在自有应用中集成音乐检索与播放能力的开发者。调用需携带密钥，按次计费。

调用地址

http://xiaoapi.cn/v1/kugou_music.php

请求方式

支持 GET 与 POST 两种方式提交请求，请求参数均可通过查询字符串或表单形式传递。

鉴权说明

本接口必须携带调用密钥，密钥通过 Query 参数 key 传递，即在请求地址后附加 key=你的接口调用密钥。未携带或密钥无效时，请求将无法正常返回数据。

请求参数

调用地址：http://xiaoapi.cn/v1/kugou_music.php，请求方式支持 GET 与 POST。密钥通过 Query 参数 key 传递。

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 传递，如 `key=…`
action	string	是	操作类型，仅可为：`search`（搜索）、`detail`（歌曲详情）、`play`（获取播放）、`mv`（MV 资源）、`lyric`（歌词资源）
type	string	否	搜索资源类型，仅当 `action=search` 时有效，仅可为：`mv`（MV 资源）、`song`（歌曲资源），例如 `song`
keyword	string	否	搜索资源名称，仅当 `action=search` 时有效，例如 `起风了`
hash	string	否	资源 hash 的 id，仅当 `action` 为 `detail`（歌曲详情）、`play`（获取播放）、`mv`（MV 资源）、`lyric`（歌词资源）时有效。注意：此字段可变，`quality=flac` 用 `sq_hash`，`res` 用 `res_hash`，`super` 用 `super_hash`，例如 `F125DA898596AC226085281F476BDB7E`
quality	string	否	音质映射，`res`/`hires`→`res`、`super`→`super`、`flac`→`flac`、`high`→`high`、`320`→`320`、`128`→`128`。注意：`res`、`super` 需要解密，建议使用 `flac` 及以下音质，例如 `flac`
mixsong_id	string	否	资源 id，仅当 `action=play` 时有效，例如 `264086632`

参数取值说明

action：五个取值分别对应搜索、歌曲详情、获取播放、MV 资源、歌词资源，需按目标能力选择；type、keyword 仅在 search 下生效，hash、quality 在 detail、play、mv、lyric 下生效，mixsong_id 仅在 play 下生效。
quality：不同取值对应不同音质档位，且与 hash 的取值来源相关，按音质选择对应 hash 字段传入，否则可能取不到目标音源。

成功响应示例

{
  "code": 200,
  "message": "ok",
  "data": {
    "hash": "f125da898596ac226085281f476bdb7e",
    "request_hash": "cd0af377206daaacaee61b76d32360a3",
    "quality": "flac",
    "play_url": "http://fs.youthandroid2.kugou.com/202610062125/a7709c241f4afcfdaf4cced8bbc10c8d/v3/f125da898596ac226085281f476bdb7e/yp/full/ap1005_us638411479_dfKCQ89Z5POG6O2G3WDAV8I1Q7_mi268500970247877721068168694046846264778_pi411_quflac_mx264086632_ct330100__s2801405976.flac",
    "bitrate": 999,
    "filesize": 38913855,
    "duration": 311,
    "ext": "flac",
    "img": "http://imge.kugou.com/stdmusic/20250703/20250703225416338652.png",
    "vip": 1
  }
}

响应字段说明

字段	类型	说明
code	integer	状态码，200 表示请求成功
message	string	状态描述，成功时为 ok
data	object	业务数据主体，随 action 不同而不同
data.hash	string	实际取用的资源 hash
data.request_hash	string	本次请求传入的 hash
data.quality	string	实际返回的音质标识
data.play_url	string	音频播放地址，可直接用于播放或下载
data.bitrate	integer	音频码率
data.filesize	integer	文件大小，单位字节
data.duration	integer	音频时长，单位秒
data.ext	string	文件扩展名
data.img	string	歌曲封面图片地址
data.vip	integer	是否为 VIP 资源标记

说明：不同 action 返回的 data 内容存在差异，搜索类操作以列表形式返回结果，详情、播放、MV、歌词类操作按上述字段结构返回对应资源信息。

错误响应示例

调用失败时，接口返回统一的 JSON 结构：code 固定为 0，表示本次请求未成功；msg 为可读的错误描述；errcode 为具体业务错误码，可直接对照下表定位原因。

密钥错误时的返回：

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

积分余额不足时的返回：

{
  "code": 0,
  "msg": "积分余额不足",
  "errcode": 11004
}

无论触发哪一类业务错误，返回结构均与上例一致，仅 msg 与 errcode 发生变化。调用方应优先读取 errcode 做分支处理，msg 仅用于展示与日志记录；当 errcode 为 11005 时，请降低请求频率后重试，其余错误码在问题修复前重试通常无效。

业务错误码说明

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	令牌分配积分不足

补充说明：

11001～11003、11011、11023：与密钥本身有关。调用密钥通过 Query 参数 key 传递，缺失、拼写错误、被禁用或已过期都会导致请求被拒绝。
11004、11024：本接口为收费接口，每次成功调用按接口计费规则扣减积分；余额不足或令牌可用额度不足时返回。
11005：短时间内并发或频次超过接口允许的 QPM 上限，稍后重试即可。
11006～11008、11017：接口处于维护、禁用、不可用状态，或服务整体暂时不可用，请稍后再试。
11009、11010：密钥校验服务或积分系统暂时不可用，属于临时性故障。
11012：密钥传递方式不符合本接口要求，请按本接口规定的 Query 方式传递 key。
11013～11016：与资源获取链路相关。11013 表示请求的接口路径不存在；11014～11016 表示目标资源地址无效、不被允许或本次获取失败，音质越高越容易遇到此类情况，可改用较低音质重试。
11018：使用了接口不支持的请求方法，本接口仅接受 GET、POST。
11019：调用来源 IP 未在当前密钥的白名单内。
11020～11022：与出口代理配置相关。密钥已开启出口代理但未提供有效密钥、未配置可用出口代理，或出口代理当前不可用。

调用示例

调用地址：http://xiaoapi.cn/v1/kugou_music.php，请求方式 GET / POST，密钥以 Query 参数 key 传递。

终端 curl（bash）

curl "http://xiaoapi.cn/v1/kugou_music.php?key=你的密钥&action=search&type=song&keyword=起风了"

获取指定音质的播放资源：

curl "http://xiaoapi.cn/v1/kugou_music.php?key=你的密钥&action=play&hash=CD0AF377206DAAACAEE61B76D32360A3&quality=flac&mixsong_id=264086632"

PHP

// PHP 示例
$params = [
    'key'        => '你的密钥',
    'action'     => 'play',
    'hash'       => 'CD0AF377206DAAACAEE61B76D32360A3',
    'quality'    => 'flac',
    'mixsong_id' => '264086632',
];

$url = 'http://xiaoapi.cn/v1/kugou_music.php?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

密钥通过 Query 参数 key 传递，例如 ?action=play&key=你的密钥。请妥善保管密钥，不要写进前端页面、客户端包体、公开仓库或截图，一旦泄露可能被他人消耗你的调用额度。
本接口为收费接口，调用会计费。调试阶段请尽量减少重复请求，先确认参数无误再正式调用。
建议使用 HTTPS 访问，避免密钥与返回的播放地址在明文链路中被截获。
每次请求只传一个 action，取值仅支持 search、detail、play、mv、lyric，其他取值无法正常返回。
type、keyword 仅在 action=search 时生效，type 仅支持 mv、song；搜索时 keyword 不能为空。
hash 会随音质变化：quality=flac 时用 sq_hash，res 用 res_hash，super 用 super_hash。建议先用 detail 取到对应音质的 hash，再调用 play，不要

酷狗音乐

请求参数

返回示例

详细文档

酷狗音乐

接口说明

调用地址

请求方式

鉴权说明

请求参数

参数取值说明

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

葫芦侠板块信息获取

服务免责声明

一、声明目的

二、用户责任与合规承诺

三、禁止性行为

四、第三方内容与数据免责

五、平台免责范围

六、违规处理与账号管理

七、赔偿条款

八、知识产权

九、法律适用与争议解决

十、声明变更

十一、联系我们