红云点歌v4
红云点歌v3备用接口
接口信息
GET / POST
api.11as.cn/apis/wymusicv4
Method
GET / POST
分类
歌曲下载
Calls
1,370
KEY
KEY 必填
计费
免费
QPM
不限制
鉴权方式
Query 参数、Header(X-API-Key)、Bearer Token
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 平台 API 访问密钥(选填) | sk_xxxxxxxxxxxxxxxx |
| action | string | 是 | 操作类型: song(单曲所有信息), search(搜索), album(专辑), playlist(歌单) | |
| id | integer | 否 | 歌曲ID/专辑ID/歌单ID,action为song/album/playlist时必填 | |
| keyword | string | 否 | 搜索关键词,action为search时必填 | |
| level | string | 否 | 音质级别: standard, exhigh, lossless, hires, jyeffect, sky, jymaster,默认lossless | |
| limit | integer | 否 | 搜索返回数量,默认20,仅search有效 | |
| offset | integer | 否 | 搜索偏移量,默认0,仅search有效 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "平台 API 访问密钥(选填)",
"example": "sk_xxxxxxxxxxxxxxxx"
},
{
"name": "action",
"type": "string",
"required": true,
"description": "操作类型: song(单曲所有信息), search(搜索), album(专辑), playlist(歌单)",
"example": ""
},
{
"name": "id",
"type": "integer",
"required": false,
"description": "歌曲ID/专辑ID/歌单ID,action为song/album/playlist时必填",
"example": ""
},
{
"name": "keyword",
"type": "string",
"required": false,
"description": "搜索关键词,action为search时必填",
"example": ""
},
{
"name": "level",
"type": "string",
"required": false,
"description": "音质级别: standard, exhigh, lossless, hires, jyeffect, sky, jymaster,默认lossless",
"example": ""
},
{
"name": "limit",
"type": "integer",
"required": false,
"description": "搜索返回数量,默认20,仅search有效",
"example": ""
},
{
"name": "offset",
"type": "integer",
"required": false,
"description": "搜索偏移量,默认0,仅search有效",
"example": ""
}
]
返回示例
{
"code": 0,
"message": "success",
"data": {
"code": 200,
"msg": "success",
"data": {
"url": "https://m701.music.126.net/20260724015820/306e074ec3cb45d6b96ae1b9ba8d6bee/jdymusic/obj/wo3DlMOGwrbDjj7DisKw/28558663931/6655/b421/eb79/bac943f935d7c0b5ca0943fccb41e5d5.flac?vuutv=9hXJ4jV7PrwtemqU8iwnOhMhSAOYoFUCpJIosvOQ0PeJNxbw9/J+G4MC5coMDciWP1ksuVEQtf74qGmnSFWZcklJJ9g5YPH8Z8KYw07+4OU=",
"cover": "https://p4.music.126.net/ZKVM7N458RJtG_EO6EB62w==/109951171391306381.jpg",
"artist": "洛天依Official/ilem",
"album": "2:3",
"type": "flac",
"level": "无损音质",
"name": "勾指起誓",
"size": "20.93MB",
"lrc": "[00:00.000] 作词 : ilem\n[00:01.000] 作曲 : ilem\n[00:03.578]编曲:ilem\n[00:07.453]\n[00:22.067]你是信的开头诗的内容\n[00:25.001]童话的结尾\n[00:27.190]你是理所当然的奇迹\n[00:30.390]你是月色真美\n[00:32.729]你是圣诞老人送给我\n[00:36.230]好孩子的礼物\n[00:38.588]你是三千美丽世界里\n[00:41.711]我的一瓢水\n[00:43.731]所以让我再靠近一点点\n[00:47.278]因为你太温暖\n[00:49.711]我会再变得坚强一点点\n[00:53.005]因为你太柔软\n[00:55.326]交换无名指金色的契约\n[00:58.582]给彼此岁月\n[01:01.127]说好从今以后都牵着手\n[01:04.164]因为要走很远\n[01:19.467]\n[01:30.083]你是我万水千山的冒险\n[01:33.017]要找的标记点\n[01:35.121]你是分割我人生的线\n[01:38.393]又将它们相连\n[01:40.677]你是前世千次的回眸\n[01:44.083]虔诚牵的手\n[01:46.103]你是其余所有的一切\n[01:49.364]是我的世界\n[01:51.838]所以请你再闪亮一点点\n[01:55.131]尽管我太平凡\n[01:57.396]我会再变得柔软一点点\n[02:01.216]因为你太敏感\n[02:03.123]交换无名指金色的契约\n[02:06.358]给彼此岁月\n[02:08.754]说好从今以后都牵着手\n[02:12.026]不管要走多远\n[02:14.432]\n[02:37.560]让我再靠近一点点\n[02:40.313]因为你太温暖\n[02:42.519]我会再变得坚强一点点\n[02:45.986]因为你太柔软\n[02:48.375]交换无名指金色的契约\n[02:51.518]给彼此岁月\n[02:54.054]说好从今以后都牵着手\n[02:57.278]因为要走很远\n[02:59.942]\n[03:00.506]混音:Tolein\n"
}
}
}
接口反馈
红云点歌v4
接口说明
红云点歌v4是红云点歌v3的备用接口,提供歌曲信息、专辑、歌单查询及搜索能力,供点歌类应用获取歌曲播放地址、歌词、封面等资源信息。调用时需在请求中通过 Query 参数 key 携带平台访问密钥;本接口为免费接口。
调用地址
https://api.xunjinlu.fun/apis/wymusicv4
请求方式
GET、POST
鉴权说明
本接口采用 Query 方式鉴权,调用时需在请求 URL 的查询参数中携带平台 API 访问密钥。参数名为 key,值为调用方所持有的有效 API 密钥。未提供有效密钥的请求将被拒绝。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 平台 API 访问密钥,通过 Query 传递 |
| action | string | 是 | 操作类型,取值:song(单曲所有信息)、search(搜索)、album(专辑)、playlist(歌单) |
| id | integer | 否 | 歌曲 ID / 专辑 ID / 歌单 ID,当 action 为 song、album、playlist 时必填 |
| keyword | string | 否 | 搜索关键词,当 action 为 search 时必填 |
| level | string | 否 | 音质级别,取值:standard、exhigh、lossless、hires、jyeffect、sky、jymaster,默认 lossless |
| limit | integer | 否 | 搜索返回数量,默认 20,仅 search 有效 |
| offset | integer | 否 | 搜索偏移量,默认 0,仅 search 有效 |
参数取值说明
action:必填,决定接口行为。song获取单曲信息,search执行关键词搜索,album查询专辑,playlist查询歌单。id:与action配合使用,当action为song/album/playlist时该参数必填。keyword:仅当action为search时必填。level:可选音质等级,不传时默认使用lossless。limit与offset:仅对搜索请求生效,用于控制返回结果的分页。
成功响应示例
以下是调用成功时的标准响应结构:
{
"code": 0,
"message": "success",
"data": {
"code": 200,
"msg": "success",
"data": {
"url": "https://m701.music.126.net/...flac",
"cover": "https://p4.music.126.net/...jpg",
"artist": "洛天依Official/ilem",
"album": "2:3",
"type": "flac",
"level": "无损音质",
"name": "勾指起誓",
"size": "20.93MB",
"lrc": "[00:00.000] 作词 : ilem\n..."
}
}
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 最外层状态码,0 表示请求成功 |
| message | string | 请求状态描述,成功时为 success |
| data | object | 响应数据主体,包含服务端状态及业务数据 |
| data.code | integer | 业务状态码,200 表示业务处理成功 |
| data.msg | string | 业务状态描述,成功时为 success |
| data.data | object | 具体音视频业务数据 |
| data.data.url | string | 歌曲试听或下载直链 |
| data.data.cover | string | 歌曲封面图片地址 |
| data.data.artist | string | 歌手名称,多个歌手以斜杠分隔 |
| data.data.album | string | 所属专辑名称 |
| data.data.type | string | 音频文件格式,如 flac、mp3 等 |
| data.data.level | string | 音质等级中文描述,如 无损音质 |
| data.data.name | string | 歌曲名称 |
| data.data.size | string | 音频文件大小,含单位 |
| data.data.lrc | string | 歌词文本(LRC 格式),包含时间标签 |
错误响应示例
当请求未通过密钥校验或业务处理失败时,接口返回统一错误格式,HTTP 状态码保持正常,具体错误信息以 errcode 字段为准。
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
code 固定为 0,msg 为错误描述,errcode 为业务错误码。
业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
调用示例
终端 curl(bash)
curl -G "https://api.xunjinlu.fun/apis/wymusicv4" \
--data-urlencode "key=sk_xxxxxxxxxxxxxxxx" \
--data-urlencode "action=search" \
--data-urlencode "keyword=勾指起誓" \
--data-urlencode "limit=5" \
--data-urlencode "offset=0"
PHP
// PHP
$params = [
'key' => 'sk_xxxxxxxxxxxxxxxx',
'action' => 'song',
'id' => 123456,
'level' => 'lossless'
];
$url = 'https://api.xunjinlu.fun/apis/wymusicv4?' . http_build_query($params);
$response = file_get_contents($url);
echo $response;
注意事项
- 请妥善保管您的 API 访问密钥,该密钥通过 Query 参数(
key=...)传递,仅在服务端调用时使用;切勿将其硬编码在前端代码、公开仓库或任何客户端可读取的位置,以免被他人盗用。 - 建议所有请求均使用 HTTPS 协议访问
https://api.xunjinlu.fun/apis/wymusicv4,确保密钥和请求数据在传输过程中不被窃听或篡改。 - 每次请求都必须携带有效的
key,否则接口将拒绝服务。若密钥泄露,请及时在平台侧重置并更换。 - 接口为免费服务,但为避免滥用影响稳定性,请合理控制请求频率,不要发起高并发或无意义的轮询请求。
- 调用时请根据
action传入正确的参数:song/album/playlist需配合id使用,search必须提供keyword;无关参数将被忽略。 level请按需选择,高音质(如hires、jymaster)可能返回较大文件,请结合实际使用场景设置,避免额外流量消耗。- 搜索时可通过
limit和offset控制返回数量与分页,limit建议不要设置过大,以免响应超时或数据冗余。 - 接口返回的音频链接带有有效期,请勿长期缓存或对外二次分发,应在有效期内使用。
快速上手
curl 'https://api.xunjinlu.fun/apis/wymusicv4?key=YOUR_API_KEY&action=song&id=1967061810&level=lossless'
免责声明
使用本平台接口即表示同意本声明。
- 数据来源:接口数据来自第三方公开网络或用户上传,本平台不保证准确性、完整性、实时性,请以官方信息为准。
- 合法性与安全性:本平台无法核实每个接口的安全性、合法性,使用者自行承担相关风险。
- 用途限制:标注“学习专用”的接口禁止商用;严禁用于违法违规行为(如诈骗、赌博、侵权等)。违规后果由使用者自行承担。
- 损害免责:使用本接口产生的任何直接或间接损失,本平台不承担责任。
- 第三方上传:用户/商户上传的接口若侵权或违法,由上传者承担全部责任。
- 监督配合:本平台依法记录访问日志,如发现违法活动将配合执法部门处理,并有权随时限制或封禁服务。
注:本平台保留最终解释权,并可能随时更新本声明。
在线测试
请求地址
api.11as.cn/apis/wymusicv4
Method
参数
Response
等待中
// 结果将在此处显示