网易云点歌

# 网易云音乐点歌API文档 ## 接口简介 网易云音乐搜索+播放链接整合API，支持歌曲搜索、获取播放链接、9种音质选择。支持付费歌曲（付费专辑除外），自动整合搜索结果和播放地址。 ## 接口地址 ``` GET/POST https://api.xunjinlu.fun/api/wyy/chant.php ``` ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | word | string | 条件必填 | 歌名关键词，用于搜索。有id时可不填 | | id | int | 条件必填 | 网易云音乐歌曲ID，与word二选一 | | page | int | 否 | 页码，默认1 | | num | int | 否 | 每页数量，默认10 | | choose | int | 否 | 选择第几首，0返回列表，默认0 | | quality | int | 否 | 音质1-9，默认9（超清母带）| ## 音质参数说明 | quality值 | 音质说明 | |-----------|----------| | 1 | 标准（64k）| | 2 | 标准（128k）| | 3 | HQ极高（192k）| | 4 | HQ极高（320k）| | 5 | SQ无损 | | 6 | 高解析度无损（Hi-Res）| | 7 | 高清臻音（Spatial Audio）| | 8 | 沉浸环绕声（Surround Audio）| | 9 | 超清母带（Master）| ## 请求示例 ### 按歌名搜索 ``` GET https://api.xunjinlu.fun/api/wyy/chant.php?word=勾指起誓 ``` ### 指定ID获取 ``` GET https://api.xunjinlu.fun/api/wyy/chant.php?id=1345872140 ``` ### 完整参数示例 ``` GET https://api.xunjinlu.fun/api/wyy/chant.php?word=勾指起誓&choose=2&quality=9&page=1&num=10 ``` ### POST请求 (JSON) ```bash curl -X POST "https://api.xunjinlu.fun/api/wyy/chant.php" \ -H "Content-Type: application/json" \ -d '{"word":"勾指起誓","quality":9,"choose":1}' ``` 响应参数 字段 类型 说明 code int 状态码，200为成功 message string 响应信息 data object 歌曲详细信息 data.id int 歌曲ID data.song string 歌曲名称 data.singer string 歌手名称 data.album string 专辑名称 data.time string 发行时间 data.quality string 音质描述 data.cover string 封面图片URL data.interval string 歌曲时长 data.link string 网易云音乐页面链接 data.size string 文件大小 data.kbps string 码率 data.url string 播放链接（直链） time string 响应时间 错误码说明 状态码 说明 200 请求成功 400 缺少必要参数（word和id至少填一个） 502 上游API请求失败 500 服务器内部错误 注意事项 1. word和id参数二选一，都填时优先使用id 2. 付费专辑无法获取，普通付费歌曲可以 3. 音质自动选择，可通过quality参数限制最大音质 4. choose=0返回搜索列表，choose=N返回第N首详情 5. 播放链接有时效性，建议及时使用或缓存 6. 本接口为代理接口，实际服务依赖上游落月API