网易云开放平台 Music API 文档镜像

接入前置参考

2 篇

#1

签名sign

官方 Source

官方分类: 接入前置参考
docId: 45aac8d12ccb4a98b14e2ea34a1a9cdb
更新时间: 2023-08-29 10:38:14
Method: 说明文档
accessToken: 说明文档

Endpoint

/openapi/music/basic/oauth2/login/anonymous

摘要

签名sign 签名sign 筛选并排序获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

官方文档未给完整结构化字段表。

#2

生成密钥并上传

官方 Source

官方分类: 接入前置参考
docId: 56fb9f543d6f4cc3b48a862ed408a075
更新时间: 2026-01-20 10:45:13
Method: 说明文档
accessToken: 说明文档

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

生成密钥并上传生成密钥并上传第一步生成RSA密钥公私钥生成工具： ==》2048位，pkcs#8 以下为老方式，可直接用上面的工具生成首先进入OpenSSL工具，输入以下命令： OpenSSL> genrsa -out app_private_key.

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

官方文档未给完整结构化字段表。

动态与公告

3 篇

#3

杜比问题

官方 Source

官方分类: 动态与公告
docId: 81958035bf3a4ab691d34b84be706ceb
更新时间: 2026-01-23 15:31:34
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/song/detail/get/v2

摘要

杜比问题问题1：歌曲音量问题问题描述某些歌曲的音质会有明显的音量上升/下降，甚至完全听不到，非杜比的其他立体声音质希望调整响度原因分析出现该问题可能的原因有：音源本身音量大/小：同一首歌不同音质的音量是不同的设备问题：不同设备播放同一首歌曲，可能出现不同响度的效果，建议用实车解决方案对于音源音量不同的问题，可以使用音效增益gain来优化缓解：名词解释：gain：音频增益； peak：音频峰值标准：-18...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

官方文档未给完整结构化字段表。

#4

数据规范

官方 Source

官方分类: 动态与公告
docId: 6d76f387e72e43818fd716c93eb521b8
更新时间: 2026-04-22 17:21:48
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/play/data/record

摘要

数据规范新版IOT端公共参数公共参数：参数名类型必选说明 appId String 是云音乐分配给开发者的应用ID，控制台上 appSecret String 是云音乐分配给开发者的应用Secret，控制台上 signType String 是应用生成签名字符串所使用的签名算法类型，目前支持：RSA_SHA256 sign String 是请求参数的签名串，签名生成方式详见 RSA加密 timestamp Long...

bizContent / 请求参数

表 1

参数名	类型	必选	说明
appId	String	是	云音乐分配给开发者的应用ID，控制台上
appSecret	String	是	云音乐分配给开发者的应用Secret，控制台上
signType	String	是	应用生成签名字符串所使用的签名算法类型，目前支持：RSA_SHA256
sign	String	是	请求参数的签名串，签名生成方式详见 RSA加密
timestamp	Long	是	请求发出的UNIX时间戳，毫秒级，服务端会校验是否在5分钟内，超时拒绝
bizContent	String	是	业务请求参数的集合，json格式化，最大长度不限，除公共参数外所有业务请求参数都必须放在这个参数中传递，具体参照各Api文档
accessToken	String	是	登录令牌，匿名接口不需要，其他接口必传。匿名登录时，每台设备需生成唯一的accessToken
device	String	是	设备信息，json格式化

表 2

参数名	类型	必选	说明
channel	String	是	厂商标识，由云音乐分配，需线下联系云音乐同事确认
deviceId	String	是	设备唯一Id （每台设备需保持唯一，可传sn、mac、IMEI、vin、iccid等值）
deviceType	String	是	设备类型，需线下联系云音乐同事确认
appVer	String	是	客户端版本号（自研的云音乐版本号，可自定义，如1.1.1）
os	String	是	端类型，由云音乐分配，需线下联系云音乐同事确认
osVer	String	是	系统版本（车机系统，可自定义，如：8.1.0）
brand	String	是	品牌，需线下联系云音乐同事确认
model	String	是	设备型号（车型，可自定义）
clientIp	String	是	终端IP，设备调用接口时的出口IP地址
netStatus	String	是	网络状态，wifi/2g/3g/4g/5g

表 3

参数名	必选	类型	说明
id	是	Sting	当前资源id, 例如：歌曲的id，声音的id或者encVoiceId
action	是	String	行为，startplay:开始播放
bitrate	是	Int	码率，单位/kbps。song传实际播放码率，128：标准，320：极高，999：无损，1999：hires，高清臻音：3999，超清母带：4999，沉浸环绕声：4099，杜比全景声：2999，臻音全景声（vivid）：5999，播客固定传128
file	是	Int	文件类型回传枚举值：0：下载文件， 1：本地文件， 2：缓存文件， 3：云盘文件， 4：线上文件。不清楚填4
type	是	Sting	类型，song：歌曲, dj：播客
startLogTime	是	Long	开始播放时的时间戳，单位：毫秒
alg	是	Sting	算法使用，私人漫游、每日推荐和场景音乐已返回该字段，产生播放时需透传alg（其余场景可参考下方，也可不传）
isAudition	否	Int	试听类型，1：片段试听（固定传1），2：全曲试听
auditionStart	否	Int	试听片段开始时间点（从上游接口取，不同用户不一样），单位/s
auditionEnd	否	Int	试听片段结束时间点（从上游接口取，不同用户不一样），单位/s
sourceId	是	Sting	播放来源资源ID（最近常听必传）
sourceType	是	Sting	播放来源资源类型（最近常听必传）
categoryId	否	Long	播客categoryId
openApiTraceInfo	否	String	全曲试听播放时需透传该字段（播放地址相关接口会下发）
ext	否	String	设备唯一识别码，游戏必传，ios传idfa，android传oaid，eg：{"idfa":"abc"}或{"oaid":"def"}

表 4

参数名	必选	类型	说明
id	是	Sting	当前资源id, 例如：歌曲的id，声音的id或者encVoiceId
action	是	String	行为，play：结束播放
bitrate	是	Int	码率，单位/kbps。song传实际播放码率，128：标准，320：极高，999：无损，1999：hires，高清臻音：3999，超清母带：4999，沉浸环绕声：4099，杜比全景声：2999，臻音全景声（vivid）：5999，播客固定传128
file	是	Int	文件类型回传枚举值：0：下载文件， 1：本地文件， 2：缓存文件， 3：云盘文件， 4：线上文件。不清楚填4
type	是	Sting	类型，song：歌曲, dj：播客
startLogTime	是	long	开始播放时的时间戳，单位：毫秒
time	是	double	播放时长，单位：秒，播放完成或者中止播放时的时长，按照实际播放时长统计，不包含暂停，不能超过歌曲总时长
end	是	Sting	结束方式回传枚举值：playend：正常结束（歌曲播放到结尾自然结束；系统自动触发上报）；interrupt：第三方APP打断（第三方应用抢占音频焦点；系统通知或电话等打断播放）； exception：错误（网络错误导致播放失败；歌曲文件损坏；其他技术异常）； ui: 用户切歌（用户主动切换到下一首/上一首；用户切换播放列表；用户点击指定歌曲播放；用户暂停播放）。不清楚填playend
alg	是	Sting	算法使用，私人漫游、每日推荐和场景音乐已返回该字段，产生播放时需透传alg（其余场景可参考下方，也可不传）
isAudition	否	Int	试听类型，1：片段试听（固定传1），2：全曲试听
auditionStart	否	Int	试听片段开始时间偏移（从上游接口取，不同用户不一样），单位/s
auditionEnd	否	Int	试听片段时间偏移（从上游接口取，不同用户不一样），单位/s
sourceId	是	Sting	播放来源资源ID（最近常听必传）
sourceType	是	Sting	播放来源资源类型（最近常听必传）
categoryId	否	Long	播客categoryId
openApiTraceInfo	否	String	全曲试听播放时需透传该字段（播放地址相关接口会下发）
ext	否	String	设备唯一识别码，游戏必传，ios传idfa，android传oaid，eg：{"idfa":"abc"}或{"oaid":"def"}

关键响应字段

官方文档未给完整结构化字段表。

#5

新功能发布记录

官方 Source

官方分类: 动态与公告
docId: 4d1bd372f8b444ddb6bbde7197bea19f
更新时间: 2026-05-19 14:27:02
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/custom/page/list /openapi/music/basic/recommend/more/song /openapi/music/basic/song/music/quality/sound/sp/get /openapi/music/basic/complex/search /openapi/music/basic/artist/zone/tab/list /openapi/music/basic/artist/zone/get/by/tab /openapi/music/basic/playlist/play/record/list /openapi/music/basic/album/play/record/list /openapi/djradio/play/progress/record/list /openapi/music/basic/song/lyric/word/by/word/get /openapi/music/basic/mix/recent/get /openapi/music/basic/query/song/record/get /openapi/voice/fall/list /openapi/voice/list /openapi/dj/program/news/fall/list /openapi/dj/program/song/list /openapi/music/basic/link/page/rcmd/resource/show /openapi/music/basic/yida/hifi/module/get /openapi/podcast/scene/fm/private/podcast/voices /openapi/music/basic/song/download/count/get /openapi/music/basic/playlist/detail/get/v2 /openapi/music/basic/song/detail/get/v2 /openapi/music/basic/search/charts/list/get /openapi/radio/gold/sentences/query /openapi/podcast/my/created/voicelist /openapi/podcast/fallspage/my/page/list /openapi/music/basic/album/subed/get/v2 /openapi/music/basic/album/sub /openapi/music/basic/album/unsub /openapi/music/interest/trial/card/get /openapi/music/interest/trial/card/obtained /openapi/music/basic/user/id/info /openapi/music/basic/recommend/daily/mix /openapi/music/basic/private/fm/roaming/song/list /openapi/music/basic/song/daily/style/get /openapi/music/basic/song/play/intelligence/get /openapi/podcast/ranklist/square/ranklist/get /openapi/podcast/ranklist/charts/get /openapi/podcast/ranklist/voice/charts/get /openapi/voice/get/voicelist /openapi/music/basic/album/paid/get/v2 /openapi/music/basic/song/paid/get /openapi/voicelist/bought/list /openapi/music/basic/artist/detail/get/v2 /openapi/music/basic/song/freely/sing/get /openapi/music/basic/song/freely/sing/detail /openapi/podcast/block/module/content /openapi/music/basic/search/song/get/v3 /openapi/music/basic/recommend/style/songlist/get /openapi/music/basic/voice/assistant/multi/search /openapi/music/basic/private/cloud/song/list/get /openapi/voice/category/rcmd/program /openapi/music/basic/song/quality/interests/get /openapi/music/basic/song/quality/interests/start /openapi/music/basic/play/data/record /openapi/voicebook/play/progress/record/list /openapi/music/basic/playlist/song/list/get/v4 /openapi/music/multi/reconnect/play/report /openapi/music/multi/reconnect/play/info/get /openapi/music/basic/song/listen/type/get /openapi/music/basic/song/play/record/list /openapi/voice/play/record/list /openapi/music/basic/scene/radio/tags/get /openapi/music/basic/scene/radio/get /openapi/music/basic/yida/page/get /openapi/music/common/recently/heard/get /openapi/music/basic/song/aidj/chat/rcmd /openapi/music/basic/private/fm/roaming/category /openapi/music/basic/recommend/playlist/get /openapi/music/basic/playlist/radar/get /openapi/music/basic/sound/effect/list /openapi/music/heart/beat/widget/get /openapi/music/basic/playlist/detail/list /openapi/music/basic/song/bpm/get /openapi/music/basic/dolby/list/get/v3 /openapi/music/song/simulation/get /openapi/music/banner/get /openapi/music/resource/short/url/get /openapi/search/multi/terminal/voicelist /openapi/search/multi/terminal/program /openapi/podcast/song/block /openapi/music/basic/playlist/oftag/get/v2 /openapi/music/basic/song/music/quality/sound/get /openapi/music/basic/httpdns/d /openapi/v1/resource/comments/add /openapi/v1/resource/comments/reply /openapi/music/basic/playlist/song/batch/like /openapi/music/basic/song/lyric/get/v2 /openapi/music/basic/playlist/song/like/v2 /openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/song/list/get/v2 /openapi/podcast/scene/fm/voice/list /openapi/podcast/block/list /openapi/podcast/block/content/list /openapi/music/basic/song/playurl/get/v2 /openapi/music/basic/batch/song/playurl/get /openapi/music/basic/album/song/list/get/v2

摘要

新功能发布记录商务合作需表明公司信息、产品信息（核心功能、市场定位）、终端类型（手机端、PC、车载、音箱、电视、手表等）、合作诉求等注意：本平台音乐服务不是免费提供，项目合作会在3~5个工作日内，经过云音乐团队评估后告知结果新功能发布记录本文介绍云音乐开放平台的api功能动态及对应的文档 api接入指南： 2026-05-19 功能名称功能描述功能类型涉及api 自定义页面可自定义页面新增 /openapi/mus...

bizContent / 请求参数

表 1

功能名称	功能描述	功能类型	涉及api
自定义页面	可自定义页面	新增	/openapi/music/basic/custom/page/list

表 2

功能名称	功能描述	功能类型	涉及api
推荐歌曲	推荐更多歌曲	新增	/openapi/music/basic/recommend/more/song

表 3

功能名称	功能描述	功能类型	涉及api
CLI	网易云音乐CLI	新增	CLI

表 4

功能名称	功能描述	功能类型	涉及api
音质	获取歌曲音质（新版）	新增	/openapi/music/basic/song/music/quality/sound/sp/get

关键响应字段

表 1

功能名称	功能描述	功能类型	涉及api
最近播放	支持获取播客播放记录	新增	/openapi/djradio/play/progress/record/list
最近播放	支持获取有声书播放记录	新增	/openapi/voicebook/play/progress/record/list

表 2

功能名称	功能描述	功能类型	涉及api
vipPlayFlag	vipPlayFlag字段正确赋值	优化	/openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/song/detail/get/v2 /openapi/music/basic/song/list/get/v2
歌单广场	修复Bossa Nova标签下歌单空白问题	优化	/openapi/music/basic/playlist/oftag/get/v2

公共

4 篇

#6

访问方式

官方 Source

官方分类: 公共
docId: d5ab035d4b9d4a088ff9f4ef3ea5005a
更新时间: 2025-12-25 17:57:53
Method: GET
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

访问方式请求说明统一采用https、get/post请求，加密形式： RSA加密线上环境域名：openapi.

bizContent / 请求参数

表 1

模块	核心功能	实现逻辑
接口鉴权	验证请求合法性	1. 签名校验：业务方需使用预置密钥，对请求参数和当前 Unix 时间戳生成 sign。服务端校验其正确性。<br>2. 时效性校验：校验 timestamp，拒绝过期请求（如 >5 分钟）
访问频率限制	防盗刷	1. 限流对象：AppID中的各个接口为单位进行限流。2. 触发机制：当调用频率超过约定阈值50，触发限流，返回-444、-445、-446。
用户会员身份	内容差异化	身份识别：解析用户登录态，返回差异化数据：仅向会员返回可播放的音频链接，非会员返回试听片段或无链接）。具体字段见各接口文档。
默认登录策略	优化算法推荐	网易云将根据部分接口类型，强制要求登录策略。

关键响应字段

官方文档未给完整结构化字段表。

#7

HTTPDNS接入

官方 Source

官方分类: 公共
docId: c46ab3181cc348bdb1df1324aec66f88
更新时间: 2026-01-21 10:46:26
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/httpdns/d

摘要

HTTPDNS接入 HTTPDNS接入 /openapi/music/basic/httpdns/d 请求方式： GET/POST 公共参数： IOT公共参数前置条件 openapi httpdns在local dns得到的ip，访问出现问题时作为备用方式获取ip 访问异常指以下两类异常： SocketTimeout ConnectionTimeout 注意，openapi httpdns并不接受所有请求，只解析云音乐相关域名。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
domain	是	String	云音乐相关域名
ip	否	Int	若未填会尝试获取请求发起的ip

关键响应字段

表 1

参数名	类型	说明
ip	String	ipv4列表
ipv6	String	ipv6列表
prefer	String	推荐ipv4或ipv6
ttl	String	过期时间

#8

公共错误码

官方 Source

官方分类: 公共
docId: 920866a9a2c2439da4d85ee5c4d23700
更新时间: 2025-12-24 11:34:00
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

公共错误码公共错误码 code message 200 成功 300 应用未授权当前接口 2403 缺少signType参数 2402 缺少sign参数 2404 缺少timestamp参数 2405 缺少appId参数 2406 应用未完成加密配置 2501 缺少channel参数 2502 缺少deviceId参数 2503 缺少deviceType参数 2504 缺少appVer参数 2505 缺少os参数 2506 缺少os...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

code	message
200	成功
300	应用未授权当前接口
2403	缺少signType参数
2402	缺少sign参数
2404	缺少timestamp参数
2405	缺少appId参数
2406	应用未完成加密配置
2501	缺少channel参数
2502	缺少deviceId参数
2503	缺少deviceType参数
2504	缺少appVer参数
2505	缺少os参数
2506	缺少osVer参数
2507	缺少brand参数
2508	缺少model参数
401	非法参数
402	非法业务参数
1401	不支持的HTTP方法
1402	非法sign参数
1403	非法signType参数
1404	非法timestamp参数
1405	非法appId参数
1406	accessToken过期
1407	对应账号不存在或者账号被封禁，grantcode(授权码错误或者已过期)；
1408	accesstoken 无效
-444	请求太过频繁
-445	请求太过频繁
-446	请求太过频繁
-461	请求总量超限

#9

IOT端公共参数

官方 Source

官方分类: 公共
docId: 0f7801d7d6d24180b8fc9058d1ffe593
更新时间: 2026-04-22 12:07:38
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

IOT端公共参数 IOT端公共参数使用范围：车载、手表、音箱、电视、智能硬件等所有iot设备（移动端app亦可）公共参数：参数名类型必选说明 appId String 是云音乐分配给开发者的应用ID ，控制台上有 signType String 是应用生成签名字符串所使用的签名算法类型，目前支持RSA_SHA256 sign String 是请求参数的签名串，签名生成方式详见 RSA加密 timestamp Long...

bizContent / 请求参数

表 1

参数名	类型	必选	说明
appId	String	是	云音乐分配给开发者的应用ID ，控制台上有
signType	String	是	应用生成签名字符串所使用的签名算法类型，目前支持RSA_SHA256
sign	String	是	请求参数的签名串，签名生成方式详见 RSA加密
timestamp	Long	是	UNIX时间戳，毫秒级
bizContent	String	是	请求参数的集合，json格式化后需要encode ，最大长度不限，除公共参数外所有业务请求参数都必须放在这个参数中传递，具体参照各Api文档
accessToken	String	否（按接口要求传）	登录令牌，匿名和二维码登录接口不需要，其他接口必传。匿名登录时，每台设备需生成唯一的accessToken
device	String	是	设备信息，json格式化后需要encode

表 2

参数名	类型	必选	说明
channel	String	是	厂商标识，由云音乐分配，需线下联系云音乐同事确认
deviceId	String	是	设备唯一Id（每台设备需保持唯一，可传sn、mac、IMEI、vin、iccid等值）
deviceType	String	是	设备类型，需线下联系云音乐产品确认
appVer	String	是	客户端版本号（自研的云音乐版本号）
os	String	是	操作系统类型，由云音乐分配，需线下联系云音乐同事确认
osVer	String	是	操作系统版本（车机系统，如：8.1.0）
brand	String	是	品牌，需线下联系云音乐同事确认
model	String	是	设备型号（车型、产品型号）
clientIp	String	是	终端IP，设备调用接口时的IP地址
netStatus	String	是	网络状态，wifi/2g/3g/4g/5g
flowFlag	String	否	是否初始化，默认：init，该字段决定本次请求是否被计算成日活

关键响应字段

表 1

参数名	类型	必选	说明
code	String	是	错误码
message	String	是	错误信息
data	Object	是	数据记录

表 2

参数名	类型	必选	说明
recordCount	Int	是	总数
records	List	是	列表数据

新版自定义模块

1 篇

#10

自定义页面

官方 Source

官方分类: 新版自定义模块
docId: 0ddce451a892442098169dd3020b7726
更新时间: 2026-05-19 11:25:04
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/custom/page/list

摘要

自定义页面自定义页面 /openapi/music/basic/custom/page/list - 需申请接口组：云音乐歌曲能力 - 整理分发内容接口能力并抽象成标准模板（如歌单/专辑/艺人等），可根据需求灵活组合拼接，源头上规范接入方的页面实现，同时支持后期分发策略调整和运营配置，减少OTA 升级的依赖 - 联系云音乐同事配置请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名 ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
pageCode	是	string	页面code
extJson	否	string	扩展JSON参数
cursor	否	string	分页游标（可选）

表 2

moduleType	含义	使用页面	出现数量
banner	Banner 轮播	发现页 / HiFi页	3
common_album	专辑推荐	HiFi页	1
common_artist	艺人推荐	发现页	1
common_playlist	歌单列表	发现页 / 推荐页 / HiFi页	16
common_songlist	歌曲列表	发现页 / 推荐页 / HiFi页	7
daily_rcmd	每日推荐	推荐页	1
djradio	电台	推荐页	1
greeting	问候区	推荐页	1
header_tab	页面顶部分类标签	HiFi页	1
recent_play	最近常听	推荐页	1
scene_fm	场景电台	推荐页	1
voice	播客/声音	推荐页	2

表 3

参数名	类型	描述
resourceType	String	资源类型
resource	Object	资源明细

表 4

resourceType	Mapper	输出 Model	出现场景
playlist	playlistResourceMapper	BasePlaylistModel	歌单模块的资源项
toplist	playlistResourceMapper	BasePlaylistModel	排行榜资源项
song	songResourceMapper	BaseSongModel	歌曲模块的资源项
card	cardResourceMapper	BaseCardModel	每日推荐 / 最近常听 / 雷达歌单 / 播客 / 电台
dailySongs	cardResourceMapper	BaseCardModel	每日推荐歌曲
fm	cardResourceMapper	BaseCardModel	FM 电台
star	cardResourceMapper	BaseCardModel	明星 / 艺人
playList	cardResourceMapper	BaseCardModel	歌单卡片（大小写变体）
similarSong	cardResourceMapper	BaseCardModel	相似歌曲
similarArtist	cardResourceMapper	BaseCardModel	相似艺人
activity	cardResourceMapper	BaseCardModel	活动 / 场景电台入口
voice	voiceResourceMapper	—	播客
djradio	voiceResourceMapper	—	电台节目
artist	artistResourceMapper	BaseArtistModel	艺人
banner	bannerResourceMapper	BaseBannerModel	Banner 项
album	albumResourceMapper	BaseAlbumModel	专辑（HiFi页新增）

关键响应字段

表 1

参数名	类型	描述
modules	List<CustomPageModuleDetailVO>	模块列表
cursor	String	分页游标，为空表示已到末页或未启用分页
hasMore	Boolean	是否还有更多数据

表 2

参数名	类型	描述
moduleCode	String	模块唯一标识（用于区分模块）
moduleName	String	模块名
moduleType	String	模块类型
resources	List<CustomPageModuleResourceDetailVO>	资源列表

用户登录API

8 篇

#11

获取登录二维码

官方 Source

官方分类: 用户登录API
docId: 2bb12a93e71a4be0842243b930c2f33c
更新时间: 2026-01-23 11:49:54
Method: GET/POST
accessToken: 不需要 accessToken

Endpoint

/openapi/music/basic/user/oauth2/qrcodekey/get/v2

摘要

获取登录二维码获取登录二维码 /openapi/music/basic/user/oauth2/qrcodekey/get/v2 实时展示二维码，使用云音乐app进行登录（或第三方app扫码）请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 type 是 int 设备类型, 固定传入type = 2 expiredKey 是 string 二维码过期时间（单位s...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
type	是	int	设备类型, 固定传入type = 2
expiredKey	是	string	二维码过期时间（单位s，固定传300）

关键响应字段

表 1

参数名	类型	说明
qrCodeUrl	String	登录二维码url
uniKey	String	二维码key

#12

轮询二维码状态

官方 Source

官方分类: 用户登录API
docId: 4d0301c68c5d45d8811d7787ee37d2f6
更新时间: 2026-01-23 12:04:43
Method: GET/POST
accessToken: 使用匿名 accessToken 轮询

Endpoint

/openapi/music/basic/oauth2/device/login/qrcode/get

摘要

轮询二维码状态轮询二维码状态 /openapi/music/basic/oauth2/device/login/qrcode/get 1、有效期5min，只能扫一次 2、要用一个匿名token去轮询 3、accessToken、refreshToken至少要保留512个字符空间，且支持base64 字符集(数字、大小写字母、+、/、=) 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
key	是	String	二维码的unikey
clientId	是	String	对应appId

表 2

参数名	类型	说明
accessToken	String	下发的token
refreshToken	String	用于刷新的refresh token
expireTime	Long	token过期时间（秒）

关键响应字段

表 1

参数名	类型	说明
accessToken	AccessToken	token相关数据
status	Int	二维码状态(800:不存在或过期, 801:等待扫码, 802:授权中, 803:授权登录成功, 804:未知错误)
msg	Int	二维码状态说明

#13

回调code换取accessToken

官方 Source

官方分类: 用户登录API
docId: 2fa5a885d2644910a4b823dba0c5acf5
更新时间: 2026-01-23 14:34:24
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/user/oauth2/token/get/v2

摘要

回调code换取accessToken 回调code换取accessToken /openapi/music/basic/user/oauth2/token/get/v2 用于接入H5/唤端授权登录后，拿到的临时code，来换取用户accessToken 最好服务端调用请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 grantCode 是 string 登录co...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
grantCode	是	string	登录code，就是回调的code

关键响应字段

表 1

参数名	类型	说明
accessToken	String	用户token
refreshToken	String	刷新token
openId	String	对于同一个接入方客户端来讲, 同一用户返回的openId是一致的（已失效）
unionId	String	对于同一个接入方来讲, 同一用户返回的unionId是一致的（已失效）
expireIn	String	有效期（秒）

#14

查询用户是否实名

官方 Source

官方分类: 用户登录API
docId: dffbc59f96d147d49e1bb41a157daaea
更新时间: 2026-01-23 14:35:17
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/user/id/info

摘要

查询用户是否实名查询用户是否实名 /openapi/music/basic/user/id/info 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无公共参数accessToken必须传入请求示例：返回参数说明参数名类型说明 userId String 明文用户id anonymous Boolean 是否匿名用户返回示例 { "code": 200, "subCode"...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
userId	String	明文用户id
anonymous	Boolean	是否匿名用户

#15

H5登录&唤端登录

官方 Source

官方分类: 用户登录API
docId: 78eb8f6bec12427d90b120e21b569b16
更新时间: 2026-05-09 17:33:57
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

H5登录&唤端登录一、背景移动端app等可以通过直接打开h5授权页登录或者拉起云音乐app授权登录 h5：进入【控制台】>【应用详情】，填写授权回调域名(接收授权后的临时code) 后续使用的redirectUrl必须与该地址一致或以该地址为前缀有多个地址时，用英文;分隔，只需和其中一个地址保持一致，即为指定该回调地址回调地址必须是公网地址唤端：需提供安卓和ios的schemaurl给云音乐同事进行配置后才能跳转一旦走唤端...

bizContent / 请求参数

表 1

参数名	类型	必选	描述	备注
clientId	String	是	应用id	AppId
state	String	是	自定义随机字符串，会在oauth的回跳步骤带回给接入方	长度30以内，数字或字母（不允许传入=、；、空格、+、
clientType	String	是	接入方端类型	和当前应用创建时选择的类型保持一致，大多数固定传web（会和控制台上的应用类型做校验）
redirectUrl	String	是	接入方重定向地址	重定向的http地址，控制台上填的授权回调域名为前缀或者保持一致，申请时为原始地址，传参时需要进行encode()
schemaUrl	String	否	打开接入方App的schema协议 (唤端必传)	示例：iSchema://openurl?url=，授权完成后如果需要唤起接入方app，需接入方传入打开已方的schema协议，该字段需要进行encode()，目前仅在云音乐App内有效

关键响应字段

表 1

code	类型	msg
400	integer	grantCode参数错误

表 2

code	类型	msg
1406	integer	accessToken过期，请重新授权登录
1407	integer	accessToken非法
1408	integer	账户已封禁或注销
400	integer	accessToken参数错误

表 3

code	类型	msg
1406	integer	accessToken过期，请重新授权登录
1407	integer	accessToken非法
1408	integer	账户已封禁或注销
400	integer	refreshToken参数错误

#16

刷新AccessToken

官方 Source

官方分类: 用户登录API
docId: 2066d57bbed2445baeb18429e44b8689
更新时间: 2026-05-15 17:55:28
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/user/oauth2/token/refresh/v2

摘要

刷新AccessToken 通过RefreshToken来刷新AccessToken /openapi/music/basic/user/oauth2/token/refresh/v2 给用户accessToken续期，AT默认7天，RT默认20天，需要调用该接口续期有特殊需要可延长最好服务端调用刷新逻辑：7天内可用token，7-20天可用refresh token刷新，20天后不活跃可引导用户重新登录注意：任意接口提示to...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
clientId	是	String	控制台上的appId
clientSecret	是	String	控制台上的appSecret
refreshToken	是	String	token对应的refreshToken

关键响应字段

表 1

参数名	类型	说明
accessToken	String	下发的token
refreshToken	String	用于刷新的refresh token
expiresTime	Long	token过期时间（秒）

表 2

code	说明
1406	accessToken过期，或者refresh Token过期
1407	对应账号不存在或者账号被封禁，grantcode(授权码错误或者已过期)
1408	accesstoken 无效

#17

获取用户基本信息

官方 Source

官方分类: 用户登录API
docId: 8ed9b2f123e44923979596a277733421
更新时间: 2026-05-21 14:30:43
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/user/profile/get/v2

摘要

获取用户基本信息获取用户基本信息车端、手表等iot场景： 1、优先判断15，如果有15则显示黑胶SVIP有效期至：** ** ** ，打svip标和等级 2、如果有6，显示黑胶会员有效期至：** ** **，打vip标和等级 3、如果只有13等单端，则显示单端会员有效期至：** ** **，不打标，只展示信息 /openapi/music/basic/user/profile/get/v2 请求方式： GET/POST 公共参数：...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	用户Id
nickname	String	用户昵称
avatarUrl	String	头像
gender	String	性别, 未知： 0; 男：1; 女：2;
signature	String	签名
redVipLevel	int	黑胶会员等级
vipDetail	List<VipOpenDetailDto>	当前生效的vip类型
fullVipDetail	List<FullVipOpenDetailDto>	所有vip类型（包含已过期的会员类型）

#18

匿名登录

官方 Source

官方分类: 用户登录API
docId: 1a5fb2c7b30b44609fa81129a8e1908d
更新时间: 2026-06-04 17:50:40
Method: GET/POST
accessToken: 不需要 accessToken

Endpoint

/openapi/music/basic/oauth2/login/anonymous

摘要

匿名登录匿名登录 /openapi/music/basic/oauth2/login/anonymous 获取设备的匿名token 游客模式：不需要用户完成云音乐登录即可使用部分功能，如获取内容、播放等。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
clientId	是	string	就是appId，填一样的

关键响应字段

表 1

参数名	类型	说明
accessToken	String	下发的token（永不过期）
refreshToken	String	下发的refreshToken（不用管）
expireTime	String	有效期（不用管）

参数名	必选	类型	说明
playlistId	是	String	红心歌单id
songId	是	String	当前正在播放歌曲（也是fromPlayOne场景下，进行单曲推荐的歌曲）
type	否	String	fromPlayAll(播放全部的推荐) 或者 fromPlayOne（单曲推荐模式），默认fromPlayAll
count	否	Int	数量，默认20，最多150首，播完了也只能在150首内循环

官方 Source

官方分类: 日推MIX
docId: b5419158b92d4310b0d4c02c696d7841
更新时间: 2025-12-26 17:18:35
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/daily/style/get /openapi/music/basic/recommend/daily/mix

摘要

获取风格日推-歌曲列表（日推mix）获取风格日推-歌曲列表（日推mix） /openapi/music/basic/song/daily/style/get 返回的第一首歌是日推mix中的resourceId，每天固定30首请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 categoryId 是 Long 分类id ，/openapi/music/basic/...

bizContent / 请求参数

表 1

参数名	类型	说明
start	Int	试听开始时间
end	Int	试听结束时间

表 2

参数名	类型	说明
dolbyMusic	String	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

表 3

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 4

值	音质	比特率
dobly	杜比	无
hires	hires	1999
lossless	无损	999
exhigh	极高	320
higher	较高	192
standard	标准	128
none	不能播放/下载	0

关键响应字段

表 1

参数名	必选	类型	说明
categoryId	是	Long	分类id ，/openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中categoryId
tagId	是	String	标签id /openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中tagId
songId	是	String	歌曲id，/openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中resourceId
limit	否	Int	请求的数据量，默认30
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	完整艺人列表（包含已下线艺人）
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
其余 5 行见官方文档

#35

获取相似艺人-歌曲列表（日推mix）

官方 Source

官方分类: 日推MIX
docId: 183e1200829b46869ef1674881a90d8a
更新时间: 2026-04-07 18:27:25
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/private/fm/roaming/song/list /openapi/music/basic/recommend/daily/mix

摘要

获取相似艺人-歌曲列表（日推mix）获取相似艺人-歌曲列表（日推mix） /openapi/music/basic/private/fm/roaming/song/list 请求方式： POST/GET 公共参数： IOT公共参数业务参数（bizContent）：参数名类型必填说明 type String 是 mode code String 是 SIMILAR sourceType String 是 artist sou...

bizContent / 请求参数

表 1

参数名	类型	必填	说明
type	String	是	mode
code	String	是	SIMILAR
sourceType	String	是	artist
sourceIds	String	是	艺人id，/openapi/music/basic/recommend/daily/mix返回的artist_fm中艺人id
limit	int	否	获取推荐歌曲数量，需<10，默认3

关键响应字段

官方文档未给完整结构化字段表。

私人漫游API

3 篇

#36

获取私人漫游场景模式

官方 Source

官方分类: 私人漫游API
docId: 999a99898fa44785baf4cbda2d8d58af
更新时间: 2026-01-22 16:38:18
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/private/fm/roaming/category /openapi/music/basic/private/fm/roaming/song/list

摘要

获取私人漫游场景模式获取私人漫游场景模式 /openapi/music/basic/private/fm/roaming/category 请求方式： POST/GET 公共参数： IOT公共参数业务参数（bizContent）：无业务参数请求示例：返回参数说明参数名类型说明 categoryList List<PrivateRoamingCategory> 目录列表 PrivateRoamingCategory 参数...

bizContent / 请求参数

表 1

参数名	类型	说明
code	String	code，接口（/openapi/music/basic/private/fm/roaming/song/list）入参
title	String	标题，eg：默认模式
subTitle	String	副标题/描述，eg：沿着目前喜好继续聆听

关键响应字段

表 1

参数名	类型	说明
categoryList	List<PrivateRoamingCategory>	目录列表

表 2

参数名	类型	说明
type	String	type，接口（/openapi/music/basic/private/fm/roaming/song/list）入参
detailList	List<PrivateRoamingTypeDetail>	可选模块详情

#37

获取私人漫游场景歌曲

官方 Source

官方分类: 私人漫游API
docId: 65df691d1b284d92b29038b34daca95b
更新时间: 2026-03-06 10:22:28
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/private/fm/roaming/song/list /openapi/music/basic/private/fm/roaming/category

摘要

获取私人漫游场景歌曲获取私人漫游场景歌曲 /openapi/music/basic/private/fm/roaming/song/list 请求方式： POST/GET 公共参数： IOT公共参数业务参数（bizContent）：参数名类型必填说明 type String 是 type，来自/openapi/music/basic/private/fm/roaming/category code String 是 cod...

bizContent / 请求参数

表 1

参数名	类型	必填	说明
type	String	是	type，来自/openapi/music/basic/private/fm/roaming/category
code	String	是	code，来自/openapi/music/basic/private/fm/roaming/category
limit	int	是	获取推荐歌曲数量，固定每次取3
withPlayUrl	boolean	否（默认false）	是否一并获取播放链接（可能获取失败）
unplaySongIds	JSON String	否	推荐但未播放的歌曲列表，例如：["445A8B860CC9CEA34A2A6082AACE1595"]

关键响应字段

官方文档未给完整结构化字段表。

#38

获取私人漫游(不建议使用)

官方 Source

官方分类: 私人漫游API
docId: bb07d0cea0ab4cc2bda2e26fa0e5337e
更新时间: 2026-05-09 17:18:06
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/radio/fm/get/v2

摘要

获取私人漫游(不建议使用) 获取私人漫游(不建议使用) /openapi/music/basic/radio/fm/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 请求数据量，固定3 filterSongDurationMinute 否 Long 过滤歌曲的时长（大于等于该时长的歌曲将不会返回） scene 否 String ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	请求数据量，固定3
filterSongDurationMinute	否	Long	过滤歌曲的时长（大于等于该时长的歌曲将不会返回）
scene	否	String	漫游场景，游戏必传，固定值：unisdk
qualityFlag	否	Boolean	是否下发音质
withPlayUrl	否	Boolean	是否下发播放地址

表 2

参数名	类型	说明
dolbyMusic	String	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
playUrl	String	播放url
br	int	返回的歌曲码率
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
mvId	String	mvId
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
songMaxBr	int	歌曲原本的最大码率
userMaxBr	int	用户能播放的最大码率
songSize	int	歌曲的大小
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
liked	boolean	是否喜欢
songFee	int	歌曲付费类型
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
alg	String	算法推荐使用，播放数据上报接口需透传该字段
qualities	List<String>	支持的音质列表
其余 1 行见官方文档

歌单广场API

3 篇

#39

获取歌单标签

官方 Source

官方分类: 歌单广场API
docId: ab958b2dacea49c1a56d7c40f5f3359a
更新时间: 2026-01-22 15:25:00
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/tag/get/v2

摘要

获取歌单标签获取歌单标签 /openapi/music/basic/playlist/tag/get/v2 获取全量的歌单标签列表，大概70个请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无请求示例：返回参数说明 Records参数（列表）参数名类型说明 id String 标签Id name String 标签名称 category int 标签种类 category的值...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	标签Id
name	String	标签名称
category	int	标签种类

#40

根据标签获取歌单

官方 Source

官方分类: 歌单广场API
docId: 8e1dff94c63141e7883b477639ef87f2
更新时间: 2026-01-22 15:27:06
Method: GET/POST
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/playlist/oftag/get/v2

摘要

根据标签获取歌单根据标签获取歌单 /openapi/music/basic/playlist/oftag/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数明文格式（bizContent）：参数名必选类型说明 tag 是 String 标签名称 limit 否 Integer 请求个数，默认值10，建议30 offset 否 Integer 请求偏移，默认值0 单个标签获取到的歌单总数不要超过3...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
tag	是	String	标签名称
limit	否	Integer	请求个数，默认值10，建议30
offset	否	Integer	请求偏移，默认值0

关键响应字段

表 1

参数名	类型	说明
hasMore	Boolean	是否有更多
records	List<PlaylistVo>	歌单列表

#41

获取歌单指定标签（新版）

官方 Source

官方分类: 歌单广场API
docId: 360f5abab9c449b8a83ed85883816c47
更新时间: 2026-01-22 15:23:23
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/square/tag/get

摘要

获取歌单指定标签（新版）获取歌单指定标签（新版） /openapi/music/basic/playlist/square/tag/get 支持渠道配置标签种类，默认8个请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无请求示例：返回参数说明参数名类型说明 id String 标签Id name String 标签名称 category int 标签种类 category的值...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	标签Id
name	String	标签名称
category	int	标签种类

查询歌单及歌曲API

3 篇

#42

获取歌单详情

官方 Source

官方分类: 查询歌单及歌曲API
docId: 730b0a8b80e745dea3b9f354eddb467e
更新时间: 2026-01-22 15:29:51
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/detail/get/v2

摘要

获取歌单详情获取歌单详情 /openapi/music/basic/playlist/detail/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistId 是 string 歌单Id originalCoverFlag 否 Boolean 是否使用原始封面（无水印，华语私人雷达第一首歌封面），默认：false newCoverFlag...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistId	是	string	歌单Id
originalCoverFlag	否	Boolean	是否使用原始封面（无水印，华语私人雷达第一首歌封面），默认：false
newCoverFlag	否	Boolean	是否获取原始新封面（左下角文字和右上角logo），默认：false

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
coverImgUrl	String	歌单封面url
describe	String	歌单描述
creatorNickName	String	创建者昵称
creatorAvatarUrl	String	创建者头像
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型
trackUpdateTime	long	最近更新时间

表 2

code	说明
200	请求正常
404	获取资源不存在
500	系统错误

#43

批量查询歌单详情

官方 Source

官方分类: 查询歌单及歌曲API
docId: cc0c3b1000eb4c969b5e5393ea83a9a0
更新时间: 2026-01-22 15:32:34
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/detail/list

摘要

批量查询歌单详情批量查询歌单详情 /openapi/music/basic/playlist/detail/list 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistIds 是 List<String> 歌曲Id列表，序列化成json String；限制为500个Id及以下最佳实践： {"playlistIds":["7747FEA04606F...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistIds	是	List<String>	歌曲Id列表，序列化成json String；限制为500个Id及以下

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 2

code	说明
200	请求正常
404	获取资源不存在
500	系统错误

#44

获取歌单里的歌曲列表

官方 Source

官方分类: 查询歌单及歌曲API
docId: 1d0537d7facc4c398834810d2955123c
更新时间: 2026-01-22 15:51:03
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/song/list/get/v3

摘要

获取歌单里的歌曲列表获取歌单里的歌曲列表 /openapi/music/basic/playlist/song/list/get/v3 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistId 是 String 歌单Id limit 是 Int 获取数据量（最多500条），建议每次取30条 offset 是 Int 偏移量 qualityFlag 否...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistId	是	String	歌单Id
limit	是	Int	获取数据量（最多500条），建议每次取30条
offset	是	Int	偏移量
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
dolbyMusic	long	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

表 3

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
coverImgUrl	String	封面url
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	int	支持的音质列表
visible	Boolean	是否有版权（true，false）

表 2

code	说明
200	请求正常
400	参数错误
500	系统错误

表 3

subcode	说明
200	有返回数据
10007	资源不存在

查询歌曲API

8 篇

#45

获取歌曲音质

官方 Source

官方分类: 查询歌曲API
docId: 4e6a21da27a64becb778484ce2068fd0
更新时间: 2026-01-22 15:59:18
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/music/quality/sound/get

摘要

获取歌曲音质获取歌曲音质 /openapi/music/basic/song/music/quality/sound/get 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 String 歌曲Id 请求示例：返回参数说明参数名类型说明 vividMusic String Audio Vivid dolbyMusic String 杜比全...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲Id

表 2

参数名	类型	说明
size	Long	歌曲大小
extension	String	音频格式
bitrate	Long	比特率
playTime	Long	歌曲时长
vipTypes	List	需要的会员类型

表 3

参数名	类型	说明
vip	Long	车端会员（之前的各端会员）
blackvip	Long	黑胶vip
svip	Long	黑胶svip

关键响应字段

表 1

参数名	类型	说明
vividMusic	String	Audio Vivid
dolbyMusic	String	杜比全景声
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

#46

全曲试听

官方 Source

官方分类: 查询歌曲API
docId: 1549413ffa5548b8a646a1eb2ea4da5b
更新时间: 2026-01-22 15:59:52
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/recommend/songlist/get/v2 /openapi/music/basic/song/detail/get/v2 /openapi/music/basic/song/playurl/get/v2 /openapi/music/basic/playlist/detail/get/v2 /openapi/music/basic/playlist/song/list/get/v3

摘要

全曲试听全曲试听功能介绍 - 支持全曲试听：可配置歌单、用户人群、场景（日推，私人漫游，场景音乐等） - 需联系云音乐同事进行配置 - 需要做数据回传，isAudition=2 配置范围说明歌单指定任意歌单，包括排行榜、官方歌单接口指定任意接口进行分发，包括每日推荐、私人漫游、场景音乐用户人群指定任意人群包（必须实名登录），比如所有普通用户，或者指定uid 举例：可以指定xx渠道的普通用户免费全曲试听每日推荐中的歌曲...

bizContent / 请求参数

表 1

场景	说明
每日推荐	daily_trial
私人漫游	fm_trial
红心歌单	star_playlist_trial
歌单	playlist_trial
场景音乐	scene_trial

表 2

参数名	类型	说明
cannotListenReason	int	是否支持试听，0：支持，null：不支持
resConsumable	boolean	该场景是否支持试听
userConsumable	boolean	该用户是否支持试听

表 3

参数名	类型	说明
sourceType	string	资源类型（歌单固定传playlist）
sourceId	string	资源ID（对应上游的playlistid）

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
freeTrialPrivilege	List<String>	是否支持全曲试听
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
其余 3 行见官方文档

#47

批量获取歌曲信息

官方 Source

官方分类: 查询歌曲API
docId: b8bdaa8e40b946ecbc1d08978f3f12b0
更新时间: 2026-01-22 16:00:19
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/list/get/v2

摘要

批量获取歌曲信息批量获取歌曲信息 /openapi/music/basic/song/list/get/v2 该接口拿不到播放地址，需要单独查请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songIdList 是 List<String> 歌曲Id列表，序列化成json String；限制为500个Id及以下 qualityFlag 否 Boolean 是否...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songIdList	是	List<String>	歌曲Id列表，序列化成json String；限制为500个Id及以下
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

表 4

值	音质	比特率
dobly	杜比	无
hires	hires	1999
lossless	无损	999
exhigh	极高	320
higher	较高	192
standard	标准	128
none	不能播放/下载	0

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
visible	Boolean	是否有版权（true，false）
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
coverImgUrl	String	封面url
artists	List<Artist>	艺人列表
album	Album	专辑信息
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
privateCloudSong	boolean	是否云盘歌曲
songFee	int	歌曲付费类型
liked	boolean	是否喜欢
audioFlag	int	是否有杜比：1

表 2

code	说明
200	请求正常
400	参数错误
500	系统错误

表 3

subcode	说明
200	有返回数据
10007	资源不存在

#48

获取歌词

官方 Source

官方分类: 查询歌曲API
docId: 803202bd65bc469587d05b507dcd31e7
更新时间: 2026-01-22 16:01:29
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/lyric/get/v2

摘要

获取歌词获取歌词 /openapi/music/basic/song/lyric/get/v2 逐行歌词请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 string 歌曲Id 请求示例：返回参数说明参数名类型说明 songId String 歌曲id lyric String 原版歌词内容（逐行歌词） noLyric Boolean ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	string	歌曲Id

关键响应字段

表 1

参数名	类型	说明
songId	String	歌曲id
lyric	String	原版歌词内容（逐行歌词）
noLyric	Boolean	歌曲是否本身无歌词，true无歌词（纯音乐）、false有歌词
transLyric	String	翻译歌词
txtLyric	String	非滚动歌词

#49

全曲试听改版

官方 Source

官方分类: 查询歌曲API
docId: 2863fdc2ce2047c2bfcee49f1b6c65e6
更新时间: 2026-01-30 16:08:08
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/song/detail/get/v2 /openapi/music/basic/song/playurl/get/v2 /openapi/music/basic/batch/song/playurl/get /openapi/music/basic/song/list/get/v2 /openapi/music/basic/play/data/record /openapi/music/basic/batch/play/data/record

摘要

全曲试听改版历史接入会员可针对channel和uid配置加白名单，也可全量全曲试听播放逻辑 playflag = false 不可播放 visible = true 有版权 resConsumable=true userConsumable= true 新流程：开放平台针对appid管控playflag的值 playflag试听情况下，支持默认设置为true，试听歌曲默认可播，也可保留历史判断逻辑 playflag=fals...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

接口名	接口
获取歌曲详情	/openapi/music/basic/song/detail/get/v2
获取歌曲播放url	/openapi/music/basic/song/playurl/get/v2
批量获取歌曲播放url，不对入参做过滤且无播放链接时直接返回null	/openapi/music/basic/batch/song/playurl/get
批量获取歌曲信息列表	/openapi/music/basic/song/list/get/v2

表 2

接口名	接口
第三方播放数据回传的埋点	/openapi/music/basic/play/data/record
批量回传用户播放数据	/openapi/music/basic/batch/play/data/record

#50

获取歌曲音质（新版）

官方 Source

官方分类: 查询歌曲API
docId: 548179f7ecbc417d8acd35d604aea3c9
更新时间: 2026-02-25 15:25:19
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/music/quality/sound/sp/get

摘要

获取歌曲音质（新版）获取歌曲音质（新版） /openapi/music/basic/song/music/quality/sound/sp/get sdk：com.

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲Id

表 2

参数名	类型	说明
size	Long	歌曲大小
extension	String	音频格式
bitrate	Long	比特率
playTime	Long	歌曲时长
md5	String	文件md5
level	String	音质
iconList	List<QualityIconDetailVO>	音质图标列表
sqPrivilege	SongQualitySpVO	音质权限信息

表 3

参数名	类型	说明
iconUrl	String	icon地址
iconType	String	icon类型
iconType	Integer	宽
height	Integer	高

表 4

参数名	类型	说明
playFlag	Boolean	该音质用户是否可播
canPlayVips	List<String>	可播放的会员身份，该字段主要用于展示icon，客户端可挑选当前端支持的会员身份展示icon

关键响应字段

表 1

参数名	类型	说明
vividMusic	MusicQualityDataVO	Audio Vivid
dolbyMusic	MusicQualityDataVO	杜比全景声
skMusic	MusicQualityDataVO	沉浸环绕声
jyMasterMusic	MusicQualityDataVO	超清母带
jyEffectMusic	MusicQualityDataVO	高清臻音
hrMusic	MusicQualityDataVO	hi-res
sqMusic	MusicQualityDataVO	无损
hmusic	MusicQualityDataVO	极高
mmusic	MusicQualityDataVO	较高
lmusic	MusicQualityDataVO	标准

#51

获取逐字歌词

官方 Source

官方分类: 查询歌曲API
docId: ac69c8c9c1b04a7f8704d6ccb78580dc
更新时间: 2026-03-04 13:58:26
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/lyric/word/by/word/get

摘要

获取逐字歌词获取逐字歌词 /openapi/music/basic/song/lyric/word/by/word/get 并非所有歌曲都有逐字歌词(大约头部几百万歌曲有)，逐字词库会逐渐丰富请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）参数名必选类型说明 songId 是 String 歌曲id 请求示例：返回参数说明参数名类型说明 lyrics List<WordBy...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲id

表 2

参数名	类型	说明
start	Long	逐行开始时间，单位：ms
duration	Long	持续时间，单位：ms
words	List<YrcWordVO>>	歌词信息

表 3

参数名	类型	说明
suspend	Long	逐字开始时间，单位：ms
duration	Long	持续时间，单位：ms
words	String	歌词

关键响应字段

表 1

参数名	类型	说明
lyrics	List<WordByWordLyricVO>	逐字歌词
ytlrcs	String	翻译歌词lrc格式，时间轴对齐yrc
lrc	String	逐行歌词
tlyric	String	逐行翻译歌词

#52

获取歌曲详情

官方 Source

官方分类: 查询歌曲API
docId: 2f583c5e2d764bbabaa221865f62dbc4
更新时间: 2026-04-22 14:58:37
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/detail/get/v2

摘要

获取歌曲详情获取歌曲详情 /openapi/music/basic/song/detail/get/v2 1、该接口可以拿到播放地址 2、默认最高到hires，如果需要高品质有两种开启方式：第一种是针对appid全量开始高品质，之后下发的level、maxlevel都是变成jymaster（超清母带），check是否会有影响第二种是通过extFlags={"hqScene":"normal"}来决定本次请求下发高品质，由接入方决...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲Id
withUrl	是	Boolean	是否需要播放url
bitrate	否	Int	播放ur的l码率：128（标准）、320（极高）、999（无损）、1999（Hi-Res）。默认获取用户可收听的最大码率（目前默认值最大无损）
effects	否	String	支持杜比的音效：eac3（车载用这个）、ac4
qualityFlag	否	Boolean	是否下发音质
level	否	String	高品质(都需要配置)：vivid（臻音全景声，该音质需要单独配置）、sky（沉浸环绕声）、jymaster（超清母带）、jyeffect（高清臻音），拿不到会自动降级
immerseType	否	String	sky必传，支持的沉浸声环绕声类型：c51（c51类型）、ste（环绕立体声类型）、aac（aac类型）
languageFlag	否	Boolean	是否返回语种，默认false
extFlags	否	String	是否获取高品质音源，固定值：{"hqScene":"normal"}；是否获取副歌起止点固定值：{"chorusFlag":true}

表 2

参数名	类型	说明
startTime	Long	副歌开始时间，单位：毫秒
endTime	Long	副歌结束时间，单位：毫秒

表 3

参数名	类型	说明
start	Int	试听开始时间
end	Int	试听结束时间

表 4

参数名	类型	说明
cannotListenReason	Integer	不可试听原因
resConsumable	Boolean	资源维度是否支持全曲试听，全曲试听标记大于0为支持
userConsumable	Boolean	用户维度是否支持全曲试听

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
playUrl	String	播放url
playUrlExpireTime	String	播放url到期时间
br	int	返回的歌曲码率
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
vipFlag	boolean	是否vip歌曲
freeTrailFlag	boolean	是否支持片段试听
freeTrail	FreeTrail	片段试听起止时间，单位：s
freeTrialPrivilege	FreeTrialPrivilegeVO	全曲试听
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
gain	Float	音频增益
peak	Float	音频peak
type	String	文件类型
level	String	当前返回的歌曲码率对应的level
songSize	long	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<SongArtistVo>	艺人集合
fullArtists	List<SongArtistVo>	艺人Id
songFee	int	歌曲付费类型
其余 11 行见官方文档

表 2

subcode	说明
200	有返回数据
10007	资源不存在

获取播放地址API

3 篇

#53

获取歌曲播放url

官方 Source

官方分类: 获取播放地址API
docId: 3d2c9f695ff24f4ea37611614b7f7856
更新时间: 2026-01-22 14:31:32
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/playurl/get/v2

摘要

获取歌曲播放url 获取歌曲播放url /openapi/music/basic/song/playurl/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 string 歌曲Id bitrate 否 Int 比特率：128（标准）、192（较高）、320（极高）、999（无损）、1999（Hi-Res）。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	string	歌曲Id
bitrate	否	Int	比特率：128（标准）、192（较高）、320（极高）、999（无损）、1999（Hi-Res）。默认320，若不能返回指定比特率则会返回较低的一个
effects	否	string	支持杜比的音效：eac3、ac4
level	否	String	高品质：vivid（臻音全景声，该音质需要单独配置）、sky（沉浸环绕声）、jymaster（超清母带）、jyeffect（高清臻音），拿不到会自动降级
immerseType	否	String	支持的沉浸声环绕声类型：c51（c51类型）、ste（环绕立体声类型）、aac（aac类型）

表 2

参数名	类型	说明
start	Int	试听开始时间
end	Int	试听结束时间

关键响应字段

表 1

参数名	类型	说明
url	String	歌曲播放url
size	Int	歌曲大小
md5	String	歌曲的MD5
br	Int	返回的歌曲码率
effects	String	音效（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
level	String	当前返回的歌曲码率对应的level
freeTrail	FreeTrail	试听起止时间，单位：s

表 2

subcode	提示语	说明
200	有返回播放url数据	正常获取
10002	获取版权错误，请稍后重试	服务异常
10003	因合作方要求，请前往手机端收听	当前端无版权
10004	该歌曲为付费歌曲，请前往手机端购买后收听	需要vip或者单独购买
10005	未知错误，请稍后重试	未知错误

#54

批量获取歌曲播放url

官方 Source

官方分类: 获取播放地址API
docId: 70ada04216d64b0d88e80740dee23a77
更新时间: 2026-01-22 14:36:52
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/batch/song/playurl/get

摘要

批量获取歌曲播放url 批量获取歌曲播放url /openapi/music/basic/batch/song/playurl/get 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songIds 是 List<String> 歌曲Id列表,序列化成json String；限制为500个Id及以下 bitrate 否 Int 比特率：128（标准）、320（极高...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songIds	是	List<String>	歌曲Id列表,序列化成json String；限制为500个Id及以下
bitrate	否	Int	比特率：128（标准）、320（极高）、999（无损）、1999（Hi-Res）。默认320，若不能返回指定比特率则会返回较低的一个
effects	否	string	支持杜比的音效：eac3、ac4

表 2

参数名	类型	说明
start	Int	试听开始时间
end	Int	试听结束时间

关键响应字段

表 1

参数名	类型	说明
url	String	歌曲播放url
size	Int	歌曲大小
md5	String	歌曲的MD5
br	Int	返回的歌曲码率
effects	String	音效（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
level	String	当前返回的歌曲码率对应的level
freeTrail	FreeTrail	试听起止时间，单位：s

表 2

值	音质	比特率
vivid	Audio Vivid	无
dobly	杜比	无
sky	沉浸环绕声	无
jymaster	超清母带	待定
jyeffect	高清臻音	无
hires	hires	1999
lossless	无损	999
exhigh	极高	320
standard	标准	128
none	不能播放/下载	0

表 3

code	说明
200	请求正常

表 4

subcode	说明
200	有返回播放url数据
10002	获取版权错误，请稍后重试
10003	因合作方要求，请前往手机端收听
10004	该歌曲为付费歌曲，请前往手机端购买后收听
10005	未知错误，请稍后重试

#55

获取歌曲无法播放toast文案

官方 Source

官方分类: 获取播放地址API
docId: 7261533300a645ea99aaf0f860f19dd5
更新时间: 2026-01-22 14:38:56
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/text/play/get/v2

摘要

获取歌曲无法播放toast文案获取歌曲无法播放toast文案 /openapi/music/basic/song/text/play/get/v2 获取的是歌曲的无法播放的兜底提示文案，尽量不用请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 String 歌曲id 请求示例：返回参数说明参数名类型说明 message String 歌...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲id

关键响应字段

表 1

参数名	类型	说明
message	String	歌曲无法获取toast文案

表 2

文案	说明
因合作方要求，暂不支持收听，请前往手机端	当前端上无版权
VIP歌曲，请开通会员；数字专辑，请前往手机端购买	数字专辑
VIP歌曲，请开通会员；数字专辑，请前往手机端购买	vip歌曲
因合作方要求，暂不支持收听，请前往手机端	无版权

获取下载地址API

3 篇

#56

获取用户下载总数

官方 Source

官方分类: 获取下载地址API
docId: 7608a3c295ae4b189ff8ab1e1f837b3e
更新时间: 2026-01-22 14:25:21
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/download/count/get

摘要

获取用户下载总数获取用户下载总数 /openapi/music/basic/song/download/count/get - 付费歌曲下载，限300首/月（每31天更新，逾期作废，有效天数<31天下载限额为有效天数*10） - 版权加密：仅限会员有效期内当前客户端内使用 - 和移动端共用额度，非单曲付费，非云盘，非数专购买，非免费可下载才算消耗额度请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizCont...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
needSum	否	Boolean	是否需要总数

关键响应字段

表 1

参数名	类型	说明
downSum	Long	已下载总数
downCount	Long	当前周期内已下载数量
downLimit	Long	下载额度上限，如果要计算剩余额度，可以用 downLimit- downCount
startTime	Long	当前周期-生效开始时间
endTime	Long	当前周期-生效结束时间

#57

获取歌曲无法下载toast文案

官方 Source

官方分类: 获取下载地址API
docId: 63c12e5f019e4f5fbb7b152a91b30f5e
更新时间: 2026-01-22 14:28:26
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/text/download/get/v2

摘要

获取歌曲无法下载toast文案获取歌曲无法下载toast文案 /openapi/music/basic/song/text/download/get/v2 获取的是歌曲的无法下载的兜底提示文案，尽量不用请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 String 歌曲id 请求示例：返回参数说明参数名类型说明 message Stri...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲id

关键响应字段

表 1

参数名	类型	说明
message	String	toast文案

#58

获取歌曲下载url

官方 Source

官方分类: 获取下载地址API
docId: a16d12e021584cb8b3655c8fe85d739a
更新时间: 2026-04-24 16:54:13
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/downloadurl/get/v2

摘要

获取歌曲下载url 获取歌曲下载url /openapi/music/basic/song/downloadurl/get/v2 - 付费歌曲下载，限300首/月（每31天更新，逾期作废，有效天数<31天下载限额为有效天数*10） - 付费歌曲定义：列表里带“vip下载”的歌曲 - 版权加密：仅限会员有效期内当前客户端内使用请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲Id
bitrate	是	Int	比特率：128（标准）、320（极高）、999（无损）、1999（Hi-Res）

关键响应字段

表 1

参数名	类型	说明
url	String	歌曲下载url
playUrlExpireTime	Long	url失效时间
size	String	歌曲大小
md5	String	歌曲的MD5
br	int	比特率
effects	String	音效（目前仅杜比才有）
privateCloudSong	Boolean	是否为云盘歌曲
level	String	播放链接实际档位
freeTrail	FreeTrail	试听起止时间，单位：s
duration	Long	歌曲时长

表 2

code	提示	说明
200	请求正常	正常
400	下载失败	当前账号无权限，需要vip或svip
500	系统错误	服务异常
3100	下载次数超限	当前周期超过下载数量上限

表 3

subcode	说明
200	有返回数据
10007	资源不存在

文字搜索API

12 篇

#59

获取热搜榜

官方 Source

官方分类: 文字搜索API
docId: ece9c6aa05544190ad840b2acc2e438e
更新时间: 2026-01-22 17:55:09
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/charts/list/get

摘要

获取热搜榜获取热搜榜 /openapi/music/basic/search/charts/list/get 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 chartCode 否 String 榜单code limit 否 Int 获取数据量（最多20条）热搜榜：HOT_SEARCH_SONG#@# 最佳实践： {"limit":"20","chartId"...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
chartCode	否	String	榜单code
limit	否	Int	获取数据量（最多20条）

关键响应字段

表 1

参数名	类型	说明
iconType	int	icon类型
rank	int	排行
searchWord	String	搜索词

表 2

类型	说明
0	不显示
1	热
2	新
3	荐
4	爆
5	升

#60

获取搜索热词

官方 Source

官方分类: 文字搜索API
docId: 11dc8523a53a4e288d8bb056d224878d
更新时间: 2026-01-22 17:42:46
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/hot/keyword/get/v2

摘要

获取搜索热词获取搜索热词 /openapi/music/basic/search/hot/keyword/get/v2 获取到搜索热词请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 获取数据量最佳实践： {"limit":10} 请求示例：返回参数说明 Records参数（列表）参数名类型说明 keyword String 热...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	获取数据量

关键响应字段

表 1

参数名	类型	说明
keyword	String	热词

#61

获取搜索提示词

官方 Source

官方分类: 文字搜索API
docId: 45c71d401d6c4eb5bd17d1775f1b8b5e
更新时间: 2026-01-22 17:48:13
Method: GET/POST
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/search/suggest/keyword/get/v2

摘要

获取搜索提示词获取搜索提示词 /openapi/music/basic/search/suggest/keyword/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索词最佳实践： {"keyword":"邓"} 返回参数说明参数名类型说明 suggests List<SuggestKeyword> 提示...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索词

关键响应字段

表 1

参数名	类型	说明
suggests	List<SuggestKeyword>	提示词列表
recs	List<SuggestKeyword>	推荐词列表

表 2

参数名	类型	说明
keyword	String	提示词
highLightInfo	String	高亮信息
iconUrl	String	提示词前 icon 图片地址
tagUrl	String	提示词后标签图片地址
resourceType	String	提示词对应资源类型
resourceId	String	提示词对应资源 id
resourceName	String	提示词对应实际资源名称
showText	String	提示词对应资源展示名称

#62

根据关键字综合搜索

官方 Source

官方分类: 文字搜索API
docId: ffd83c003331452d9d0bdb45e8ab1261
更新时间: 2026-01-22 17:40:54
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/complex/search

摘要

根据关键字综合搜索根据关键字综合搜索 /openapi/music/basic/complex/search 根据关键字返回歌单、歌曲、专辑、艺人、播客等综合结果请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 qualityFlag 否 Boolean 是否下发音质 identityFlag 否 Boolean 是...

bizContent / 请求参数

表 1

参数名	类型	说明
resourceType	String	资源类型
resource	object	资源详情

表 2

枚举值	资源类型
bestmatch	最佳匹配
song	歌曲
playlist	歌单
voicelist	播单
album	专辑
artist	艺人

表 3

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	全部艺人列表（包含已下线）
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	歌曲封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	List<String>	支持的音质列表
originCoverType	Int	原唱字段
visible	Boolean	是否有版权（true，false）

表 4

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
coverImgUrl	String	歌单封面url
describe	String	歌单描述
creatorNickName	String	创建者昵称
creatorAvatarUrl	String	创建者头像
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型
trackUpdateTime	long	最近更新时间

关键响应字段

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
qualityFlag	否	Boolean	是否下发音质
identityFlag	否	Boolean	是否组装艺人身份标签，默认false
subCountFlag	否	Boolean	是否组装粉丝数，默认false

表 2

参数名	类型	说明
bestMatchResources	List<MixResourceVO>	最佳匹配资源
bestMatchResourceTypes	List<String>	最佳匹配资源类型
songs	List<SongListVo>	歌曲列表
artists	List<ArtistVo>	艺人列表
albums	List<AlbumDetailVo>	专辑列表
playlists	List<PlaylistVo>	歌单列表
voicelist	List<PodcastDetailDTO>	播单列表

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
genre	String	风格流派
artists	List<Artist>	歌手信息
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

#63

根据关键字搜索歌曲

官方 Source

官方分类: 文字搜索API
docId: b175e0d52550427cbb7cd4735a9de765
更新时间: 2026-01-29 15:54:06
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/song/get/v3 /openapi/music/basic/search/song/get/v2

摘要

根据关键字搜索歌曲根据关键字搜索歌曲 /openapi/music/basic/search/song/get/v3 老接口：/openapi/music/basic/search/song/get/v2 根据关键字搜索出匹配度最高的歌曲请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 limit 是 Int 获取数...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
limit	是	Int	获取数据量
offset	是	Int	偏移量
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
0	Int	状态未知
1	Int	原唱
2	Int	翻唱

表 3

参数名	类型	说明
dolbyMusic	String	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

表 4

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	全部艺人列表（包含已下线）
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	歌曲封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	List<String>	支持的音质列表
originCoverType	Int	原唱字段
visible	Boolean	是否有版权（true，false）

#64

根据关键字搜索专辑

官方 Source

官方分类: 文字搜索API
docId: ca7eda92ab634c0fbc1436c99fdaad5d
更新时间: 2026-01-29 15:55:00
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/album/get/v2

摘要

根据关键字搜索专辑根据关键字搜索专辑 /openapi/music/basic/search/album/get/v2 根据关键字搜索到指定的专辑请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 limit 是 Int 获取数据量(最多300，建议100以内) offset 是 Int 偏移量最佳实践： {"key...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
limit	是	Int	获取数据量(最多300，建议100以内)
offset	是	Int	偏移量

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
genre	String	风格流派
artists	List<Artist>	歌手信息
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

#65

根据关键字搜索歌手

官方 Source

官方分类: 文字搜索API
docId: a1c2bcb0e9b44c09a45b614c3d4f1784
更新时间: 2026-01-29 15:54:36
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/artists/get/v2

摘要

根据关键字搜索歌手根据关键字搜索歌手 /openapi/music/basic/search/artists/get/v2 根据艺人名称搜索到艺人信息请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 limit 是 Int 获取数据量 offset 是 Int 偏移量 identityFlag 否 Boolean 是...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
limit	是	Int	获取数据量
offset	是	Int	偏移量
identityFlag	否	Boolean	是否组装艺人身份标签，默认false
subCountFlag	否	Boolean	是否组装粉丝数，默认false

表 2

参数名	类型	说明
userType	Int	身份type
showName	String	身份名

表 3

参数名	类型	说明
roleId	Long	身份id
roleName	String	身份名称

关键响应字段

表 1

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
nationality	String	国家/地区
musicSize	Int	歌曲数量

#66

根据标签搜索歌单

官方 Source

官方分类: 文字搜索API
docId: 60d52ebe087b45218dedca1afdcaf49c
更新时间: 2026-01-22 18:24:06
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/playlist/bytag/get/v2

摘要

根据标签搜索歌单根据标签搜索歌单 /openapi/music/basic/search/playlist/bytag/get/v2 使用指定的标签，按热度搜索歌单请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 tag 是 String 标签 limit 是 Int 一页数据量（最多500条），别拿太多 offset 是 Int 偏移量最佳实践： {"tag...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
tag	是	String	标签
limit	是	Int	一页数据量（最多500条），别拿太多
offset	是	Int	偏移量

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
coverImgUrl	String	歌单封面url
describe	String	歌单描述
creatorNickName	String	创建者昵称
creatorAvatarUrl	String	创建者头像
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型
trackUpdateTime	long	最近更新时间

#67

根据艺人关键字搜索歌曲（不建议使用）

官方 Source

官方分类: 文字搜索API
docId: 4eabf69b081548499d0d3e57f255bcf4
更新时间: 2026-01-22 18:27:09
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/song/byartist/get/v2

摘要

根据艺人关键字搜索歌曲（不建议使用）根据艺人关键字搜索歌曲（不建议使用） /openapi/music/basic/search/song/byartist/get/v2 根据艺人名称获取到相关歌曲请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 limit 是 Int 获取数据量 offset 是 Int 偏移量 ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
limit	是	Int	获取数据量
offset	是	Int	偏移量

表 2

参数名	类型	说明
0	Int	状态未知
1	Int	原唱
2	Int	翻唱

表 3

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
originCoverType	Int	原唱字段
visible	Boolean	是否有版权（true，false）

#68

根据艺人名、歌曲名搜索歌曲信息（不建议使用）

官方 Source

官方分类: 文字搜索API
docId: 4a4a9ef7d6ce4c39ad2685b321cc7d22
更新时间: 2026-01-22 18:28:25
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/song/by/artist/song/get/v2

摘要

根据艺人名、歌曲名搜索歌曲信息（不建议使用）根据艺人名、歌曲名搜索歌曲信息（不建议使用） /openapi/music/basic/search/song/by/artist/song/get/v2 根据根据艺人名、歌曲名搜索匹配度从高到低的歌曲列表请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songName 是 String 歌曲名称 artistNam...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songName	是	String	歌曲名称
artistName	是	String	艺人名称
limit	是	int	一页数据量（最多500条）
offset	是	int	偏移量

表 2

参数名	类型	说明
0	Int	状态未知
1	Int	原唱
2	Int	翻唱

表 3

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
originCoverType	Int	原唱字段
visible	Boolean	是否有版权（true，false）

#69

根据艺人、专辑关键字搜索专辑列表(不建议使用)

官方 Source

官方分类: 文字搜索API
docId: 44a151d8c432445984d8dbaf06467f7c
更新时间: 2026-01-22 18:29:43
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/song/by/album/artist/get/v2

摘要

根据艺人、专辑关键字搜索专辑列表(不建议使用) 根据艺人、专辑关键字搜索专辑列表(不建议使用) /openapi/music/basic/search/song/by/album/artist/get/v2 结合艺人名称、专辑名称搜索匹配度从高到低的专辑信息请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumName 是 String 专辑名 artist...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumName	是	String	专辑名
artistName	是	String	艺人名
limit	是	Int	获取数据量（不要超过300，建议100以内）
offset	是	Int	偏移量

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
genre	String	风格流派
artists	List<Artist>	歌手信息
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述

#70

根据关键字搜索歌单

官方 Source

官方分类: 文字搜索API
docId: 7aae16d1be194e628666dd4ced17f283
更新时间: 2026-05-13 10:39:08
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/search/playlist/get/v2

摘要

根据关键字搜索歌单根据关键字搜索歌单 /openapi/music/basic/search/playlist/get/v2 根据歌单名称搜索到匹配度从高到低的歌单请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 keyword 是 String 搜索关键字 limit 是 Int 获取数据量 offset 是 Int 偏移量最佳实践： {"keyword":...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
keyword	是	String	搜索关键字
limit	是	Int	获取数据量
offset	是	Int	偏移量

关键响应字段

表 1

参数名	类型	说明
recordCount	Int	歌单数量
records	List<record>	歌单列表

表 2

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
coverImgUrl	String	歌单封面url
describe	String	歌单描述
creatorNickName	String	创建者昵称
creatorAvatarUrl	String	创建者头像
playCount	String	播放量
subscribedCount	Int	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型
trackUpdateTime	long	最近更新时间

语音搜索API

2 篇

#71

根据多槽位搜索歌曲

官方 Source

官方分类: 语音搜索API
docId: 1a4135540f104dd8adee3a501649b917
更新时间: 2026-01-30 14:00:03
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/voice/assistant/multi/search

摘要

根据多槽位搜索歌曲根据多槽位搜索歌曲 /openapi/music/basic/voice/assistant/multi/search 具有精准搜和模糊泛搜的能力，可通过车企解析后的NLU槽位信息进行歌曲检索。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
mediaName	是	String	搜索内容（只能是槽值），eg:刘德华忘情水、快乐，不能是“快乐的”
mediaType	否	String	用mediaType区分资源类型，枚举如下
artistName	否	String	艺人（不知道不传）
albumName	否	String	专辑（不知道不传）
sortOrder	否	String	资源按时间排序，比如新歌、新专辑用1

表 2

参数名	类型	说明
id	String	歌曲Id
originalId	Long	原始id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	歌曲封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	List<String>	支持的音质列表
visible	Boolean	是否有版权（true，false）

表 3

参数名	类型	说明
id	String	声音Id
originalId	long	原始声音id
radioId	String	播单id
originalRadioId	long	原始播单id
createTime	long	创建时间（时间戳）
coverUrl	String	声音封面url
name	String	声音名称
description	String	描述
trackId	String	音频Id，用来获取播放地址（已废弃，最好别用）
duration	long	声音时长，单位：毫秒
playCount	long	播放次数
fees	List<FeeVO>	付费信息，详见播客付费功能
feeActivity	VoiceFeeActivityVO	付费活动，详见播客付费功能
djName	String	播单作者

表 4

参数名	类型	说明
id	String	歌单Id
originalId	Long	原始歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
trackUpdateTime	Long	歌曲变更时间
creatorAvatarUrl	String	头像
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

关键响应字段

表 1

参数名	类型	说明
0	String	开放泛词（默认）
1	String	歌曲
2	String	专辑
3	String	艺人
5	String	歌单

表 2

参数名	类型	说明
albums	List<AlbumDetailVo>	专辑列表
songs	List<SongListVo>	歌曲列表
voices	List<VoiceDetailVO>	声音列表
playlists	List<PlaylistVo>	歌单列表
resTypes	List<String>	返回类型列表
tips	List<SiriTipsVO>	提示

表 3

参数名	类型	说明
id	String	专辑Id
originalId	Long	原始id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
genre	String	风格流派
artists	List<Artist>	歌手信息
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间

#72

AI原文搜索（不拆槽）

官方 Source

官方分类: 语音搜索API
docId: eeb8c93d255b46a18d8dca749888fa57
更新时间: 2026-04-02 11:21:48
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/miyue/song/list/get /openapi/music/basic/search/song/get/v2

摘要

AI原文搜索（不拆槽） AI原文搜索（不拆槽） /openapi/music/basic/recommend/miyue/song/list/get 需申请：云音乐推荐能力根据用户原文搜索出匹配度最高的歌曲请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 content 是 String 语音原文最佳实践： {"content":"来点王力宏的歌"} 请求示例...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
content	是	String	语音原文

关键响应字段

表 1

参数名	类型	说明
response	String	推荐语
songs	List<SongVo>	歌曲列表

表 2

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	全部艺人列表（包含已下线）
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
coverImgUrl	String	歌曲封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	List<String>	支持的音质列表
originCoverType	Int	原唱字段
visible	Boolean	是否有版权（true，false）

获取播放记录API

5 篇

#73

获取最近播放歌单列表

官方 Source

官方分类: 获取播放记录API
docId: e185b8877e144eba82d8eefd7a7f1081
更新时间: 2026-01-23 14:55:09
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/play/record/list

摘要

获取最近播放歌单列表获取最近播放歌单列表 /openapi/music/basic/playlist/play/record/list 网易云端->iot设备端：实时同步，秒级传输 iot设备端->网易云端：需要在回传接口新增sourceId和sourceType 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 否 Int 查询条数，默认100条请...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	否	Int	查询条数，默认100条

表 2

参数名	类型	说明
os	String	来源

关键响应字段

表 1

参数名	类型	说明
records	List<record>	歌单列表
playTime	String	最近一次播放时间

表 2

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
coverImgUrl	String	歌单封面url
describe	String	歌单描述
creatorNickName	String	创建者昵称
creatorAvatarUrl	String	创建者头像
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型
trackUpdateTime	long	最近更新时间
extMap	extMapVo	补充信息

#74

获取最近播放专辑列表

官方 Source

官方分类: 获取播放记录API
docId: d90400e28fab4fbb834959650ec8d93d
更新时间: 2026-01-23 14:56:29
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/play/record/list

摘要

获取最近播放专辑列表获取最近播放专辑列表 /openapi/music/basic/album/play/record/list 网易云端->iot设备端：实时同步，秒级传输 iot设备端->网易云端，需要在回传接口新增sourceId和sourceType 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 否 Int 查询条数，默认100条请求示例...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	否	Int	查询条数，默认100条

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 3

参数名	类型	说明
os	String	来源

关键响应字段

表 1

参数名	类型	说明
records	List<record>	歌单列表
playTime	String	最近一次播放时间

表 2

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	歌手信息
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏
extMap	extMapVo	补充信息

#75

获取听歌排行数据

官方 Source

官方分类: 获取播放记录API
docId: bc35878b52134cfbb6739fcff7de5f9e
更新时间: 2026-01-23 14:58:44
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/query/song/record/get

摘要

获取听歌排行数据获取听歌排行数据 /openapi/music/basic/query/song/record/get - 需申请接口组：云音乐歌曲能力 - 获取用户最近听歌排行（同步移动端的）请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 type 是 Int 0:查总排行，1:查周排行 offset 是 Int 偏移量 limit 是 Int 获取的数据量...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
type	是	Int	0:查总排行，1:查周排行
offset	是	Int	偏移量
limit	是	Int	获取的数据量
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	vip标识，需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放（不要用）
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
gain	Float	音频增益
peak	Float	音频peak
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	完整艺人列表（包含已下线艺人）
songFee	int	歌曲付费类型
其余 10 行见官方文档

关键响应字段

表 1

参数名	类型	说明
playCount	String	播放次数
score	String	分数
song	songVo	歌曲

#76

获取近期内容推荐

官方 Source

官方分类: 获取播放记录API
docId: e878b43948834b47b93b0025cf947fce
更新时间: 2026-01-23 14:59:45
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/mix/recent/get

摘要

获取近期内容推荐获取近期内容推荐 /openapi/music/basic/mix/recent/get - 需申请接口组：云音乐歌曲能力 - 音乐增加近期模块，根据消费行为综合推荐最近播放、创建歌单、收藏歌单、听歌排行等 - 同步的是移动端的数据请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 否 Int 获取数量，默认10 请求示例：返回参数说...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	否	Int	获取数量，默认10

表 2

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
genre	String	风格流派
artists	List<Artist>	歌手信息
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

表 4

参数名	类型	说明
name	String	名称
playCount	String	播放数量
coverImgUrl	String	封面

关键响应字段

表 1

参数名	类型	说明
playlist	String	歌单
album	String	专辑
songRank	String	听歌排行

#77

获取最近播放歌曲列表

官方 Source

官方分类: 获取播放记录API
docId: 1811d8f3db124c65a66edddcef7e70fc
更新时间: 2026-03-30 17:17:53
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/play/record/list

摘要

获取最近播放歌曲列表获取最近播放歌曲列表 /openapi/music/basic/song/play/record/list 网易云端->iot设备端：实时同步，秒级传输 iot设备端->网易云端：需要做播放数据回传注意： 1、appver不能超过15个字符，不然会被丢弃，数据无法同步 2、应用需要做数据审核流程，控制台点请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	否	Int	查询条数，默认300条
qualityFlag	否	Boolean	是否下发音质

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
其余 2 行见官方文档

用户资产API

3 篇

#78

获取用户已购歌曲

官方 Source

官方分类: 用户资产API
docId: 393b4acad0f0443094e42b27340a71ad
更新时间: 2025-12-25 18:31:07
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/paid/get

摘要

获取用户已购歌曲获取用户已购歌曲 /openapi/music/basic/song/paid/get 请求方式： POST 公共参数： IOT公共参数 SDK公共参数 WEB公共参数移动端公共参数业务参数（bizContent）：参数名必选类型说明 offset 否 Int 偏移量，默认0 limit 否 Int 数据量，默认10 qualityFlag 否 Boolean 是否下发音质，默认false 请求示例：返...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
offset	否	Int	偏移量，默认0
limit	否	Int	数据量，默认10
qualityFlag	否	Boolean	是否下发音质，默认false

表 2

参数名	类型	说明
start	Int	试听开始时间
end	Int	试听结束时间

表 3

参数名	类型	说明
dolbyMusic	String	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

表 4

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	完整艺人列表（包含已下线艺人）
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
其余 5 行见官方文档

#79

获取用户已购专辑

官方 Source

官方分类: 用户资产API
docId: 99900726c96d4c0c8b3724d939b7e0f3
更新时间: 2025-12-25 18:32:32
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/paid/get/v2

摘要

获取用户已购专辑获取用户已购专辑 /openapi/music/basic/album/paid/get/v2 请求方式： POST 公共参数： IOT公共参数 SDK公共参数 WEB公共参数移动端公共参数业务参数（bizContent）：参数名必选类型说明 offset 是 int 偏移量 limit 是 int 数据量请求示例：返回参数说明参数名类型说明 id String 专辑Id name String...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
offset	是	int	偏移量
limit	是	int	数据量

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	歌手信息
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

#80

获取用户网盘歌曲

官方 Source

官方分类: 用户资产API
docId: 4a3a24a059894e2bbded639b891d44a1
更新时间: 2026-01-21 10:49:12
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/private/cloud/song/list/get /openapi/music/basic/song/text/play/get/v2 /openapi/music/basic/song/text/download/get/v2

摘要

获取用户网盘歌曲获取用户网盘歌曲 /openapi/music/basic/private/cloud/song/list/get - 必须要登录，匿名用户无网盘歌曲 - 歌单、艺人、最近播放等有网盘歌曲出现的列表，要展示网盘标志请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 offset 是 Int 偏移量 limit 是 Int 一页数据量（最多500条）...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
offset	是	Int	偏移量
limit	是	Int	一页数据量（最多500条）

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
liked	boolean	是否喜欢
coverImgUrl	String	歌曲封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
privateCloudSong	Boolean	是否云盘歌曲
songTag	List<String>	歌曲的曲风标签
alg	String	算法推荐使用，播放数据上报接口需透传该字段
songFee	int	歌曲付费类型
qualities	int	支持的音质列表
visible	Boolean	是否有版权（true，false）

播放数据回传API

1 篇

#81

音乐/长音频播放数据回传

官方 Source

官方分类: 播放数据回传API
docId: eb0ddaf2efc649e99dffe0677472466a
更新时间: 2026-05-15 17:51:35
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/play/data/record

摘要

音乐/长音频播放数据回传播放数据回传 /openapi/music/basic/play/data/record 要求所有接入方必做，指当用户产生播放行为时，合作方调用回传接口将用户的播放数据回传给云音乐。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
id	是	Sting	当前资源id, 例如：歌曲的id，声音的id或者encVoiceId
action	是	String	行为，startplay:开始播放
bitrate	是	Int	码率，单位/kbps。song传实际播放码率，128：标准，320：极高，999：无损，1999：hires，高清臻音：3999，超清母带：4999，沉浸环绕声：4099，杜比全景声：2999，臻音全景声（vivid）：5999，播客固定传128
file	是	Int	文件类型回传枚举值：0：下载文件， 1：本地文件， 2：缓存文件， 3：云盘文件， 4：线上文件。不清楚填4
type	是	Sting	类型，song：歌曲, dj：播客
startLogTime	是	Long	开始播放时的时间戳，单位：毫秒
alg	是	Sting	算法使用，私人漫游、每日推荐和场景音乐已返回该字段，产生播放时需透传alg（其余场景可参考下方，也可不传）
isAudition	否	Int	试听类型，1：片段试听（固定传1），2：全曲试听
auditionStart	否	Int	试听片段开始时间点（从上游接口取，不同用户不一样），单位/s
auditionEnd	否	Int	试听片段结束时间点（从上游接口取，不同用户不一样），单位/s
sourceId	是	Sting	播放来源资源ID（最近常听必传）
sourceType	是	Sting	播放来源资源类型（最近常听必传）
categoryId	否	Long	播客categoryId
openApiTraceInfo	否	String	全曲试听播放时需透传该字段（播放地址相关接口会下发）
ext	否	String	设备唯一识别码，游戏必传，ios传idfa，android传oaid，eg：{"idfa":"abc"}或{"oaid":"def"}

表 2

参数名	必选	类型	说明
id	是	Sting	当前资源id, 例如：歌曲的id，声音的id或者encVoiceId
action	是	String	行为，play：结束播放
bitrate	是	Int	码率，单位/kbps。song传实际播放码率，128：标准，320：极高，999：无损，1999：hires，高清臻音：3999，超清母带：4999，沉浸环绕声：4099，杜比全景声：2999，臻音全景声（vivid）：5999，播客固定传128
file	是	Int	文件类型回传枚举值：0：下载文件， 1：本地文件， 2：缓存文件， 3：云盘文件， 4：线上文件。不清楚填4
type	是	Sting	类型，song：歌曲, dj：播客
startLogTime	是	long	开始播放时的时间戳，单位：毫秒
time	是	double	播放时长，单位：秒，播放完成或者中止播放时的时长，按照实际播放时长统计，不包含暂停，不能超过歌曲总时长
end	是	Sting	结束方式回传枚举值：playend：正常结束（歌曲播放到结尾自然结束；系统自动触发上报）；interrupt：第三方APP打断（第三方应用抢占音频焦点；系统通知或电话等打断播放）； exception：错误（网络错误导致播放失败；歌曲文件损坏；其他技术异常）； ui: 用户切歌（用户主动切换到下一首/上一首；用户切换播放列表；用户点击指定歌曲播放；用户暂停播放）。不清楚填playend
alg	是	Sting	算法使用，私人漫游、每日推荐和场景音乐已返回该字段，产生播放时需透传alg（其余场景可参考下方，也可不传）
isAudition	否	Int	试听类型，1：片段试听（固定传1），2：全曲试听
auditionStart	否	Int	试听片段开始时间偏移（从上游接口取，不同用户不一样），单位/s
auditionEnd	否	Int	试听片段时间偏移（从上游接口取，不同用户不一样），单位/s
sourceId	是	Sting	播放来源资源ID（最近常听必传）
sourceType	是	Sting	播放来源资源类型（最近常听必传）
categoryId	否	Long	播客categoryId
openApiTraceInfo	否	String	全曲试听播放时需透传该字段（播放地址相关接口会下发）
ext	否	String	设备唯一识别码，游戏必传，ios传idfa，android传oaid，eg：{"idfa":"abc"}或{"oaid":"def"}

关键响应字段

官方文档未给完整结构化字段表。

艺人API

10 篇

#82

查询歌手分类（新版）

官方 Source

官方分类: 艺人API
docId: ebf6c6e2d9bb4422a303c85f638bb8be
更新时间: 2026-01-21 17:37:42
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artist/zone/tab/list

摘要

查询歌手分类（新版）查询歌手分类（新版） /openapi/music/basic/artist/zone/tab/list 在歌手分类页，查询所有分类枚举请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无请求示例：返回参数说明参数名类型说明 areaTabList List<ArtistZoneTabDetailVO> tab信息 bandTabList List<Arti...

bizContent / 请求参数

表 1

参数名	类型	说明
name	String	Tab名
tab	String	tab

关键响应字段

表 1

参数名	类型	说明
areaTabList	List<ArtistZoneTabDetailVO>	tab信息
bandTabList	List<ArtistZoneTabDetailVO>	乐队组合形式，男/女/乐队

表 2

参数名	类型	说明
name	String	Tab名
tab	String	tab

#83

根据tab查询歌手信息（新版）

官方 Source

官方分类: 艺人API
docId: 485a1adb2b514dafad81e125a386401e
更新时间: 2026-01-21 17:49:45
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artist/zone/get/by/tab

摘要

根据tab查询歌手信息（新版）根据tab查询歌手信息（新版） /openapi/music/basic/artist/zone/get/by/tab 在歌手分类页，查询指定分类下的歌手列表请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 areaTab 否 String 艺人tab信息，默认chinese bandTab 否 String 乐队信息，默认fema...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
areaTab	否	String	艺人tab信息，默认chinese
bandTab	否	String	乐队信息，默认female
limit	否	int	获取数量，默认10
offset	否	int	偏移量，默认0

关键响应字段

表 1

参数名	类型	说明
artists	List<ArtistVo>	艺人列表
hasMore	boolean	是否有下一页

表 2

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
musicSize	Int	歌曲数量

#84

获取用户收藏的艺人

官方 Source

官方分类: 艺人API
docId: 65fb6afcc2aa4c4dae535b2677a0a336
更新时间: 2026-01-22 11:26:15
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artist/subed/get/v2

摘要

获取用户收藏的艺人获取用户收藏的艺人 /openapi/music/basic/artist/subed/get/v2 必须实名登录请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 获取数据量 offset 是 Int 偏移量最佳实践： {"limit":"30","offset":"0"} 请求事例：返回参数说明参数名类型说明...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	获取数据量
offset	是	Int	偏移量

关键响应字段

表 1

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）

#85

获取艺人详情

官方 Source

官方分类: 艺人API
docId: 127d16ef3827471f92d615144aff2568
更新时间: 2026-01-21 17:56:37
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artist/detail/get/v2

摘要

获取艺人详情获取艺人详情 /openapi/music/basic/artist/detail/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 artistId 是 String 艺人id extFlag 否 Boolean 艺人简介信息 personalFlag 否 Boolean 艺人信息，地区、年龄之类 creatorRoleFlag 否 B...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
artistId	是	String	艺人id
extFlag	否	Boolean	艺人简介信息
personalFlag	否	Boolean	艺人信息，地区、年龄之类
creatorRoleFlag	否	Boolean	艺人身份
subCountFlag	否	Boolean	是否获取艺人粉丝数
identityFlag	否	Boolean	用户标签需要是入驻艺人才会有，比如林俊杰现在就没这个数据，但查艺人身份就有（该参数可不用）

表 2

参数名	类型	说明
userType	Int	身份type
showName	String	身份名

表 3

参数名	类型	说明
roleId	Long	身份id
roleName	String	身份名称

关键响应字段

表 1

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
nationality	String	国家/地区
musicSize	Int	歌曲数量

#86

批量查询艺人详情

官方 Source

官方分类: 艺人API
docId: ed0aeed638274ecaa1fb5c558dfe700d
更新时间: 2026-01-21 18:28:26
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artist/list/get

摘要

批量查询艺人详情批量查询艺人详情 /openapi/music/basic/artist/list/get 可以拿到艺人封面等补充信息，自行选择是否使用请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 artistIds 是 String 艺人list identityFlag 否 Boolean 是否需要身份信息，默认false 最佳实践： {"artistI...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
artistIds	是	String	艺人list
identityFlag	否	Boolean	是否需要身份信息，默认false

关键响应字段

表 1

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称
transName	String	艺人别名
coverImgUrl	String	艺人封面
type	Int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
nationality	String	国家/地区
musicSize	Int	歌曲数量

#87

分页获取艺人下的热门歌曲列表

官方 Source

官方分类: 艺人API
docId: 588187b5ba044177b007f930e5589cd5
更新时间: 2026-01-22 12:38:23
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artists/song/list/get

摘要

分页获取艺人下的热门歌曲列表分页获取艺人下的热门歌曲列表 /openapi/music/basic/artists/song/list/get 歌曲列表的热度是从高到低请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 artistId 是 String 艺人id type 否 Int 1 热门作品 2 作词作品 3 作曲作品，默认1 limit 否 Int 一页...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
artistId	是	String	艺人id
type	否	Int	1 热门作品 2 作词作品 3 作曲作品，默认1
limit	否	Int	一页数据量（最多获取前500首），默认10
offset	否	Int	偏移量，默认0
qualityFlag	否	Boolean	是否下发音质

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false），已失效
payDownloadFlag	Boolean	是否需要付费才能下载（true、false），已失效
vipFlag	boolean	vip标识，需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放（不要用）
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
gain	Float	音频增益
peak	Float	音频峰值
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	完整艺人列表（包含已下线艺人）
songFee	int	歌曲付费类型
其余 10 行见官方文档

#88

获取艺人下的热门歌曲列表

官方 Source

官方分类: 艺人API
docId: 74ed84f605954836a81795dba1e18308
更新时间: 2026-01-22 12:39:43
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artists/hotsong/list/get/v2

摘要

获取艺人下的热门歌曲列表获取艺人下的热门歌曲列表 /openapi/music/basic/artists/hotsong/list/get/v2 歌曲列表的热度是从高到低，只返回前60首请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 artistsId 是 String 艺人id top 是 Int 前N首歌（最多获取前60首） qualityFlag 否 ...

bizContent / 请求参数

表 1

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 2

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

表 3

参数名	类型	说明
dolbyMusic	long	杜比
skMusic	String	沉浸环绕声
jyMasterMusic	String	超清母带
jyEffectMusic	String	高清臻音
hrMusic	String	hi-res
sqMusic	String	无损
hmusic	String	极高
mmusic	String	较高
lmusic	String	标准

关键响应字段

表 1

参数名	必选	类型	说明
artistsId	是	String	艺人id
top	是	Int	前N首歌（最多获取前60首）
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
coverImgUrl	String	封面url
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率
userMaxBr	int	用户能播放的最大码率
maxBrLevel	String	歌曲码率对应的level
plLevel	String	用户播放歌曲码率对应的level
dlLevel	String	用户下载歌曲码率对应的level
songTag	List<String>	歌曲的曲风标签
visible	Boolean	是否有版权（true，false）

#89

获取艺人下的专辑列表

官方 Source

官方分类: 艺人API
docId: ba84444321a94ffea19f592e2f92b70a
更新时间: 2026-01-21 18:15:49
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artists/album/list/bytype/get/v3

摘要

获取艺人下的专辑列表获取艺人下的专辑列表 /openapi/music/basic/artists/album/list/bytype/get/v3 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 artistId 是 String 艺人id sortType 是 String 排序依据:"pubTime":发行时间,"score":热度 limit 否 Int...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
artistId	是	String	艺人id
sortType	是	String	排序依据:"pubTime":发行时间,"score":热度
limit	否	Int	获取数据量
offset	否	Int	偏移量

表 2

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	歌手信息
briefDesc	String	简要描述
description	String	详细描述
publishTime	Long	发行时间
subed	Boolean	是否收藏

表 3

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
page	String	分页信息
records	List<Album>	专辑列表

表 2

参数名	类型	说明
current	Int	当前页码
size	Int	获取的记录数
recordCount	Int	总的记录数
total	Int	总页码数

#90

根据分类获取艺人列表v2（不建议使用）

官方 Source

官方分类: 艺人API
docId: 7a9df9a04f6b43f885871a0950bd8215
更新时间: 2026-01-22 11:33:57
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artists/list/bytype/get/v2

摘要

根据分类获取艺人列表v2（不建议使用）根据分类获取艺人列表v2（不建议使用） /openapi/music/basic/artists/list/bytype/get/v2 默认按热度返回前100个请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 type 是 Int 艺人类型（1华语、欧美、3韩国、4日本）最佳实践： {"type":1} 请求示例：返回参...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	必选	类型	说明
type	是	Int	艺人类型（1华语、欧美、3韩国、4日本）

表 2

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
nationality	String	国家/地区
musicSize	Int	歌曲数量

#91

根据分类获取艺人列表v3（不建议使用）

官方 Source

官方分类: 艺人API
docId: c95518cb251a4646a5276954c050742c
更新时间: 2026-01-22 11:38:54
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/artists/list/bytype/get/v3

摘要

根据分类获取艺人列表v3（不建议使用）根据分类获取艺人列表v3（不建议使用） /openapi/music/basic/artists/list/bytype/get/v3 1、默认按热度返回前200个 2、比v2多了个性别组合请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 areaId 是 Int 艺人类型（0:其它, 7:华语, 24:日韩, 96:欧美,...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	必选	类型	说明
areaId	是	Int	艺人类型（0:其它, 7:华语, 24:日韩, 96:欧美, -1:全部）
gender	是	Int	1:男, 2:女, 3:组合, -1全部

表 2

参数名	类型	说明
id	String	艺人id
name	String	艺人名称
transName	String	别名
coverImgUrl	String	封面
type	int	艺人类型（3:乐队组合, 1:男歌手, 2:女歌手）
authMusicianV	Boolean	大V认证
identity	List<IdentityVO>	身份
roles	List<ExpertIdentityTypeVO>	艺人角色信息
subCount	Long	粉丝数
briefDesc	String	简要描述
nationality	String	国家/地区
musicSize	Int	歌曲数量

专辑API

6 篇

#92

收藏专辑

官方 Source

官方分类: 专辑API
docId: 93d94f82dc6a47bf9bd16ccbe4a58774
更新时间: 2026-01-22 12:43:34
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/sub

摘要

收藏专辑收藏专辑 /openapi/music/basic/album/sub 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumId 是 String 专辑id 最佳实践 {"albumId":"76D648FF9392D3C277E389EECE07A64B"} 请求示例：返回示例 { "code":200, "subCode":null, "me...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumId	是	String	专辑id

关键响应字段

官方文档未给完整结构化字段表。

#93

取消收藏专辑

官方 Source

官方分类: 专辑API
docId: 889f67faf2d04e8290a7666281e8dfc3
更新时间: 2026-01-22 12:44:02
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/unsub

摘要

取消收藏专辑取消收藏专辑 /openapi/music/basic/album/unsub 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumId 是 String 专辑id 最佳实践 {"albumId":"76D648FF9392D3C277E389EECE07A64B"} 请求示例：返回示例 { "code":200, "subCode":nul...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumId	是	String	专辑id

关键响应字段

官方文档未给完整结构化字段表。

#94

获取专辑详情

官方 Source

官方分类: 专辑API
docId: ba97c43952ff48febccd7d4efbd013e5
更新时间: 2026-01-22 12:59:00
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/detail/get/v2

摘要

获取专辑详情获取专辑详情 /openapi/music/basic/album/detail/get/v2 请求方式： POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumId 是 String 专辑id descFlag 否 Boolean 是否需要专辑介绍最佳实践： {"albumId":"7C11AA5E8AFA27CDE291C1F48C0FB288"} 请求示例：...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumId	是	String	专辑id
descFlag	否	Boolean	是否需要专辑介绍

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
genre	String	风格流派
artists	List<Artist>	歌手信息
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

#95

分页获取专辑下的歌曲列表

官方 Source

官方分类: 专辑API
docId: cb472584884c4662a0ef97488c7ac651
更新时间: 2026-01-22 12:54:55
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/song/list/get/v3 /openapi/music/basic/song/text/play/get/v2 /openapi/music/basic/song/text/download/get/v2

摘要

分页获取专辑下的歌曲列表分页获取专辑下的歌曲列表 /openapi/music/basic/album/song/list/get/v3 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumId 是 String 专辑id limit 否 Int 获取数据量 offset 否 Int 偏移量 qualityFlag 否 Boolean 是否下发音质最佳实...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumId	是	String	专辑id
limit	否	Int	获取数据量
offset	否	Int	偏移量
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
page	Page	分页信息
records	List<SongVO>	歌曲信息

表 2

参数名	类型	说明
current	Integer	当前页面
size	Integer	每页数量
recordCount	Integer	记录总条数
total	Integer	每页数量
cursor	String	游标，默认返回本页列表最后一条数据的游标值，举例：用户列表分页查询场景，使用userId作为游标；假设本次查询结果中返回的userId列表按顺序分别为：[1001,1002,1003,1004,1005] 则游标可以为为1005

表 3

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
freeTrailFlag	boolean	是否支持试听
coverImgUrl	String	封面url
artists	List<Artist>	艺人列表
album	Album	专辑信息
visible	Boolean	是否有版权（true，false）

#96

获取专辑下的歌曲列表

官方 Source

官方分类: 专辑API
docId: a6d0565f06c54439b7c75c145b216995
更新时间: 2026-01-22 12:55:14
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/song/list/get/v2

摘要

获取专辑下的歌曲列表获取专辑下的歌曲列表v2 /openapi/music/basic/album/song/list/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 albumId 是 String 专辑id qualityFlag 否 Boolean 是否下发音质最佳实践： {"albumId":"76D648FF9392D3C277E389...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
albumId	是	String	专辑id
qualityFlag	否	Boolean	是否下发音质

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

表 3

参数名	类型	说明
id	String	专辑Id
name	String	专辑名称

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
name	String	歌曲名称
duration	long	时长
artists	List<Artist>	艺人列表
album	Album	专辑信息
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
liked	boolean	是否喜欢
coverImgUrl	String	封面url
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songTag	List<String>	歌曲的曲风标签
privateCloudSong	boolean	是否云盘歌曲
visible	Boolean	是否有版权（true，false）

#97

获取用户收藏的专辑列表

官方 Source

官方分类: 专辑API
docId: 82d6d4418f9349ec92465755e11562ff
更新时间: 2026-01-22 12:57:27
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/album/subed/get/v2

摘要

获取用户收藏的专辑列表获取用户收藏的专辑列表 /openapi/music/basic/album/subed/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 offset 是 int 偏移量 limit 是 int 一页数据量（最多500条）最佳实践： {"limit":"30","offset":"0"} 请求示例：返回参数说明参数名类...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
offset	是	int	偏移量
limit	是	int	一页数据量（最多500条）

表 2

参数名	类型	说明
id	String	艺人Id
name	String	艺人名称

关键响应字段

表 1

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	封面
company	String	发行公司
genre	String	风格流派
artists	List<Artist>	歌手信息
transName	String	中文翻译名
aliaName	String	别名
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间
subed	Boolean	是否收藏

高品质专区

8 篇

#98

获取Vivid歌单

官方 Source

官方分类: 高品质专区
docId: 9892a316cfae45ba8c06e056ef87877c
更新时间: 2025-12-25 18:00:37
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/yida/page/get

摘要

获取Vivid歌单获取Vivid歌单 /openapi/music/basic/yida/page/get - 提供的高品质vivid歌曲、歌单、专辑等内容请求方式： POST 公共参数： IOT公共参数 SDK公共参数 WEB公共参数移动端公共参数业务参数（bizContent）：参数名必选类型说明 pageCode 是 string 页面code pageCode：02810a927eb64f0e9dd4591b4...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
pageCode	是	string	页面code

表 2

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

关键响应字段

表 1

参数名	类型	说明
pageCode	String	页面code
style	String	模块展示样式
positionCode	String	位置信息
title	String	模块标题
resources	List<OpenApiZoneResourceDetailVO>	vivid单个资源合集

#99

获取Suno Ai内容

官方 Source

官方分类: 高品质专区
docId: 8cc54550eaf94865acf1b51988059b5b
更新时间: 2025-12-25 18:01:19
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/yida/page/get

摘要

获取Suno Ai内容获取Suno Ai内容 /openapi/music/basic/yida/page/get - Suno AI 是一款人工智能音乐生成器，能够根据用户输入的简单文本描述，生成完整的歌曲作品，包括歌词、人声和配器等所有内容。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
pageCode	是	string	页面code

表 2

参数名	类型	说明
resourceType	String	资源类型
res	List<BANNER/PLAYLIST/SONG>	资源内容

表 3

参数名	类型	说明
BANNER	String	banner
PLAYLIST	String	歌单
SONG	String	歌曲

表 4

参数名	类型	说明
id	String	资源id（对应的跳转类型及资源）
resourceType	String	/
background	String	背景图

关键响应字段

表 1

参数名	类型	说明
style	String	模块展示样式
positionCode	String	位置信息
title	String	模块标题
resources	List<OpenApiZoneResourceDetailVO>	Suno Ai单个资源合集

#100

获取HiFi专区指定模块

官方 Source

官方分类: 高品质专区
docId: 9229b5ccd81348668c3ae4f417f3d5f3
更新时间: 2025-12-25 18:01:51
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/yida/hifi/module/get

摘要

获取HiFi专区指定模块获取HiFi专区指定模块 /openapi/music/basic/yida/hifi/module/get - 需申请接口组：开放平台专区能力 - 提供的高保真音乐服务，用户可以通过该专区订阅高品质音乐流，享受更高保真度的音频体验。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
code	是	string	页面code
supportVivid	否	Boolean	是否获取vivid内容，需要单独配置

表 2

参数名	类型	说明
resourceType	String	资源类型
res	List<BANNER/PLAYLIST/SONG>	资源内容

表 3

参数名	类型	说明
BANNER	String	banner
PLAYLIST	String	歌单
SONG	String	歌曲

表 4

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

关键响应字段

表 1

参数名	类型	说明
pageCode	String	父位置
relationId	String	关系id
style	String	模块展示样式
positionCode	String	子位置
title	String	模块标题
resources	List<OpenApiZoneResourceDetailVO>	HiFi单个资源合集

#101

获取杜比内容v3

官方 Source

官方分类: 高品质专区
docId: 8a1adcb4dd1c4b3ab96eab789675d55b
更新时间: 2025-12-25 18:04:04
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/dolby/list/get/v3

摘要

获取杜比内容v3 获取杜比内容v3 /openapi/music/basic/dolby/list/get/v3 请求方式： Get/POST 公共参数： IOT公共参数业务参数（bizContent）：无需联系云音乐提前配置请求示例：返回参数说明 moduleBaseInfos 参数名类型说明 style String 模块展示样式 positionCode String 位置信息 title String 模块标题 ...

bizContent / 请求参数

表 1

参数名	类型	说明
resourceType	String	资源类型，歌单/歌曲/专辑
res	String	对应资源信息

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
songFee	int	歌曲付费类型
visible	Boolean	是否有版权（true，false）

表 3

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	专辑封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	艺人列表
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间

关键响应字段

表 1

参数名	类型	说明
style	String	模块展示样式
positionCode	String	位置信息
title	String	模块标题
resources	List<OpenApiZoneResourceDetailVO>	杜比专区单个资源合集

#102

获取杜比内容v2

官方 Source

官方分类: 高品质专区
docId: 4f3b75e97fdf471e8bd8f4e32eafbbc6
更新时间: 2025-12-25 18:04:49
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/dolby/list/get/v2

摘要

获取杜比内容v2 获取杜比内容v2 /openapi/music/basic/dolby/list/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 resourceTypes 是 List<String> 枚举类型：song、playlist、album withUrl 否 Boolean 是否需要播放url（默认为true） bitrate 否 I...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
resourceTypes	是	List<String>	枚举类型：song、playlist、album
withUrl	否	Boolean	是否需要播放url（默认为true）
bitrate	否	Int	播放ur的l码率（默认320）
effects	否	String	支持杜比的音效：eac3、ac4（默认ac4）

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
songFee	int	歌曲付费类型
visible	Boolean	是否有版权（true，false）

表 3

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	专辑封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	艺人列表
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间

关键响应字段

表 1

参数名	类型	说明
category	String	分类标题
songDetailVoList	List<songDetailVo>	歌曲
playlistDetailVoList	List<playlistDetailVo>	歌单
albumDetailVoList	List<albumDetailVo>	专辑

#103

获取hires内容

官方 Source

官方分类: 高品质专区
docId: de6f884f089d4c9085ea793046907c99
更新时间: 2025-12-25 18:05:21
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/hi/res/get

摘要

获取hires内容获取hires内容 /openapi/music/basic/hi/res/get 请求方式： POST 公共参数： IOT公共参数 SDK公共参数 WEB公共参数移动端公共参数业务参数（bizContent）：参数名必选类型说明 resourceTypes 是 List<String> 枚举类型：song、playlist、album withUrl 否 Boolean 是否需要播放url（默认为tr...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
resourceTypes	是	List<String>	枚举类型：song、playlist、album
withUrl	否	Boolean	是否需要播放url（默认为true）
bitrate	否	Int	播放ur的l码率：固定传1999（默认320）

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
songFee	int	歌曲付费类型
visible	Boolean	是否有版权（true，false）

表 3

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 4

参数名	类型	说明
id	String	专辑Id
name	String	专辑名
language	String	专辑语种
coverImgUrl	String	专辑封面
company	String	发行公司
transName	String	中文翻译名
aliaName	String	别名
genre	String	风格流派
artists	List<Artist>	艺人列表
briefDesc	String	简要描述
description	String	详细描述
publishTime	String	发行时间

关键响应字段

表 1

参数名	类型	说明
category	String	分类标题
songDetailVoList	List<songDetailVo>	歌曲
playlistDetailVoList	List<playlistDetailVo>	歌单
albumDetailVoList	List<albumDetailVo>	专辑

#104

获取首页混搭页面

官方 Source

官方分类: 高品质专区
docId: 6f7187c873b14562b3aa787eb066be8c
更新时间: 2025-12-25 18:09:00
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/link/page/rcmd/resource/show

摘要

获取首页混搭页面获取首页混搭页面 /openapi/music/basic/link/page/rcmd/resource/show - 提供车载新首页混搭容器页面 - 申请接口组：云音乐搭建能力请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 pageCode 是 string 页面code cursor 是 string 游标（首次传空,下一次的cursor...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
pageCode	是	string	页面code
cursor	是	string	游标（首次传空,下一次的cursor是上次请求结果中返回的cursor）
blockCodeOrderList	否	string	子页面code列表（首次传空,下一次的blockCodeOrderList是上次请求结果中返回的blockCodeOrderList）
closeRcmd	否	string	拒绝推荐code
extJson	否	string	额外信息

表 2

参数名	类型	说明
positionCode	String	位置code
channelCode	String	通道code
resourceType	String	资源类型
resource	resource	资源

表 3

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	String	播放量
subscribedCount	String	收藏量
tags	List<String>	标签
creatorId	String	歌单创建人Id
createTime	String	创建时间
subed	boolean	是否收藏
trackCount	int	歌单下歌曲总数
specialType	int	歌单类型

表 4

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
其余 2 行见官方文档

关键响应字段

表 1

参数名	类型	说明
blocks	List<BlockDTO>	模块展示样式
guideToast	String	提示
cursor	String	游标
blockCodeOrderList	String	子页面code列表
callbackParameters	String	回带字段
hasMore	Boolean	是否还有更多
demote	Boolean	是否降级
dinformation	String	模块标题

#105

获取HiFi专区

官方 Source

官方分类: 高品质专区
docId: 8d330773bc1d47ffbdb6d150bf00ea1a
更新时间: 2026-05-13 11:43:39
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/yida/hifi/get

摘要

获取HiFi专区获取HiFi专区 /openapi/music/basic/yida/hifi/get - 需申请接口组：开放平台专区能力 - 提供的高保真音乐服务，用户可以通过该专区订阅高品质音乐流，享受更高保真度的音频体验。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
code	是	string	页面code
supportVivid	否	Boolean	是否获取vivid内容，需要单独配置

表 2

参数名	类型	说明
resourceType	String	资源类型
res	List<resourceType>	资源内容

表 3

参数名	类型	说明
BANNER	String	banner
PLAYLIST	String	歌单
SONG	String	歌曲
ALBUM	String	专辑
LINK	String	链接

表 4

参数名	类型	说明
id	String	资源id（对应的跳转类型及资源）
resourceType	String	/
background	String	背景图

关键响应字段

表 1

参数名	类型	说明
style	String	模块展示样式
positionCode	String	位置信息
title	String	模块标题
resources	List<OpenApiZoneResourceDetailVO>	HiFi单个资源合集

收藏&创建API

8 篇

#106

用户取消收藏歌单

官方 Source

官方分类: 收藏&创建API
docId: 5f2aa23db2aa411b8ccec5fa40ad501a
更新时间: 2026-01-19 18:12:48
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/unsub/v2

摘要

用户取消收藏歌单用户取消收藏歌单 /openapi/music/basic/playlist/unsub/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 id 是 string 歌单Id 请求示例：返回示例正常情况 { "code":200, "subCode":null, "message":null, "data":true } 不能收藏/取消收藏...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
id	是	string	歌单Id

关键响应字段

官方文档未给完整结构化字段表。

#107

添加或删除红心歌曲

官方 Source

官方分类: 收藏&创建API
docId: f9a2353b14de42cd925c61de66095e0e
更新时间: 2026-01-19 18:14:02
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/song/like/v2

摘要

添加或删除红心歌曲添加或删除红心歌曲 /openapi/music/basic/playlist/song/like/v2 匿名用户暂不支持添加付费歌曲请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 String 歌曲id isLike 是 Boolean 添加/删除 plagflag=false&songfee=4，就提示需要在手机端完成购...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	String	歌曲id
isLike	是	Boolean	添加/删除

关键响应字段

官方文档未给完整结构化字段表。

#108

获取用户收藏的歌单列表

官方 Source

官方分类: 收藏&创建API
docId: 1b3d86a47f2e45c7bd631bcd26052382
更新时间: 2026-01-19 18:15:23
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/subed/get/v2

摘要

获取用户收藏的歌单列表获取用户收藏的歌单列表 /openapi/music/basic/playlist/subed/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 一页数据量（最多500条） offset 是 Int 偏移量 originalCoverFlag 否 Boolean 是否使用原始封面（无水印），默认：fals...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	一页数据量（最多500条）
offset	是	Int	偏移量
originalCoverFlag	否	Boolean	是否使用原始封面（无水印），默认：false

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	Int	播放量
trackCount	Int	歌单下歌曲总数
subscribedCount	Int	收藏量
tags	List<String>	标签
createTime	long	创建时间（时间戳）
subed	boolean	是否收藏

#109

批量删除歌单内歌曲

官方 Source

官方分类: 收藏&创建API
docId: 19b352625a9843f9b86521f49b856542
更新时间: 2026-01-19 18:16:40
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/song/batch/delete

摘要

批量删除歌单内歌曲批量删除歌单内歌曲 /openapi/music/basic/playlist/song/batch/delete 批量删除指定歌单内的歌曲，需是自己的歌单请求方式： GETPOST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistId 是 string 歌单Id songIdList 是 List<String> 待删除歌曲Id列表，上限500 请求示例...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistId	是	string	歌单Id
songIdList	是	List<String>	待删除歌曲Id列表，上限500

关键响应字段

官方文档未给完整结构化字段表。

#110

获取用户红心歌单

官方 Source

官方分类: 收藏&创建API
docId: f0b639bf1494424188a8360d4a22fdd4
更新时间: 2026-01-19 18:19:11
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/star/get/v2

摘要

获取用户红心歌单获取用户红心歌单 /openapi/music/basic/playlist/star/get/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：请求示例：返回参数说明参数名类型说明 id String 歌单Id name String 歌单名称 describe String 歌单描述 coverImgUrl String 歌单封面url creatorNi...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	Int	播放量
subscribedCount	Int	收藏量
tags	List<String>	标签
createTime	long	创建时间（时间戳）
trackCount	Int	歌单下歌曲总数
subed	boolean	是否收藏
specialType	Int	歌单类型

#111

获取用户创建的歌单列表

官方 Source

官方分类: 收藏&创建API
docId: e4fef4e5cc564fc1adbcfcf02140f0d5
更新时间: 2026-01-19 18:23:51
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/created/get/v2

摘要

获取用户创建的歌单列表获取用户创建的歌单列表 /openapi/music/basic/playlist/created/get/v2 历史原因，该接口最后一个歌单是红心歌单（不要可自行删除）请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 一页数据量（最多500条） offset 是 Int 偏移量会默认增加一个红心歌单在末尾，不需要...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	一页数据量（最多500条）
offset	是	Int	偏移量

关键响应字段

表 1

参数名	类型	说明
id	String	歌单Id
name	String	歌单名称
describe	String	歌单描述
coverImgUrl	String	歌单封面url
creatorNickName	String	创建者昵称
playCount	Int	播放量
subscribedCount	Int	收藏量
trackCount	Int	歌单下歌曲总数
tags	List<String>	标签
createTime	long	创建时间（时间戳）
subed	boolean	是否收藏

#112

批量添加歌曲到歌单

官方 Source

官方分类: 收藏&创建API
docId: 81deeef0f74147dba249531b5e08042d
更新时间: 2026-04-14 11:09:26
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/song/batch/like

摘要

批量添加歌曲到歌单批量添加歌曲到歌单 /openapi/music/basic/playlist/song/batch/like 批量添加歌曲到指定歌单，需是自己的请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistId 是 string 歌单Id songIdList 是 List<String> 待收藏歌曲Id列表请求示例：返回示例 { "...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistId	是	string	歌单Id
songIdList	是	List<String>	待收藏歌曲Id列表

关键响应字段

官方文档未给完整结构化字段表。

#113

用户收藏歌单

官方 Source

官方分类: 收藏&创建API
docId: eb8bef1f8603489f8c31b4b9720eda24
更新时间: 2026-04-23 15:38:54
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/sub/v2

摘要

用户收藏歌单用户收藏歌单 /openapi/music/basic/playlist/sub/v2 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 id 是 string 歌单Id 请求示例：返回示例 { "code":200, "subCode":null, "message":null, "data":true } 异常：不可收藏自己创建的歌单、收藏数量...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
id	是	string	歌单Id

关键响应字段

官方文档未给完整结构化字段表。

会员API

5 篇

#114

二维码弹窗收银台

官方 Source

官方分类: 会员API
docId: 691a694aeb5148089eaa48711b59e0e3
更新时间: 2026-06-02 16:46:54
Method: GET
accessToken: 不需要 accessToken

Endpoint

/openapi/music/basic/common/middle/short/url /api/middle/shorturl/gen /openapi/music/basic/sound/effect/list

摘要

二维码弹窗收银台二维码弹窗收银台 /prime/m/iot-cashier 不需要传accessToken 线上环境：请求方式： GET 公共参数：无 iot端会员会员类型说明黑胶vip 拥有对应时长的黑胶vip，现有会员周期同步延长黑胶svip 拥有对应时长的黑胶svip，现有会员周期同步延长黑胶vip+故事会员拥有对应时长的黑胶vip和故事会员，现有会员周期同步延长测试可以申请退款，提供用户昵称+付款方式（微信...

bizContent / 请求参数

表 1

会员类型	说明
黑胶vip	拥有对应时长的黑胶vip，现有会员周期同步延长
黑胶svip	拥有对应时长的黑胶svip，现有会员周期同步延长
黑胶vip+故事会员	拥有对应时长的黑胶vip和故事会员，现有会员周期同步延长

表 2

参数名	必选	类型	说明
appId	是	String	云音乐开放平台分配的appId
cashierId	是	Int	收银台id，由云音乐分配
encryptUserId	是	String	合作方调用云音乐开放平台获取的加密用户id
cashierSign	是	String	签名
tab	是	String	指定商品sku，可排序,eg:"6,15"
extInfo	是	String	扩展信息（可以传车型、手表型号等自定义信息，方便数据分析）

关键响应字段

官方文档未给完整结构化字段表。

#115

H5收银台

官方 Source

官方分类: 会员API
docId: 82b465f6b01c4e9d9e2c8224c24dcfba
更新时间: 2026-05-27 10:06:26
Method: GET
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

H5收银台 H5收银台 /st/vipcashier-v4/iot/ 测试环境：正式环境：请求方式： GET 业务参数（bizContent）：参数名默认值备注 tab redvip,vipplus 1.

bizContent / 请求参数

表 1

参数名	默认值	备注
tab	redvip,vipplus	1. 传入会员权益名称，通过英文的","拼接。2. 第一个元素为进入页面后高亮的产品，建议根据业务需求灵活控制。3. 权益映射：redvip: 黑胶VIP vipplus: 黑胶SVIP
theme	light	1. 主题色，浅色为 light，深色为 dark 。 2. 只支持打开页面时设置，不支持在页面使用过程中响应变化
zoom	1	可以自定义任意正数，带小数也可以，长宽同比例缩放；eg：1（用于适配不同屏幕尺寸，要求宽高比例固定为600:372；2：容器展示大小为 1200*744）
cashierId	必填	在开放平台注册后获得的 cashierId
encryptUserId	必填	当前登录用户的加密id
appId	必填	在开放平台注册后获得的 appId
sign	必填	按照开放平台的加密要求对appId, cashierId, encryptUserId 进行加密后获得的值
extInfo	可不填	厂商自行处理的扩展信息，会在支付成功时回调

关键响应字段

官方文档未给完整结构化字段表。

#116

获取短链地址

官方 Source

官方分类: 会员API
docId: bb502088d4834663a1bce60e5045b917
更新时间: 2026-05-29 18:15:27
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/common/middle/short/url

摘要

获取短链地址获取短链地址 /openapi/music/basic/common/middle/short/url 需申请：资源分享能力请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名类型是否必填说明 sourceUrl String 是长链 expireTimeSeconds Long 否过期时间，默认：1296000 最佳实践 {"sourceUrl":"xxx",...

bizContent / 请求参数

表 1

参数名	类型	是否必填	说明
sourceUrl	String	是	长链
expireTimeSeconds	Long	否	过期时间，默认：1296000

关键响应字段

表 1

参数名	类型	说明
shortUrl	String	短链

#117

直充订单回传

官方 Source

官方分类: 会员API
docId: 933dfa57d7f6479d801e5c70959ec0f1
更新时间: 2026-04-22 15:53:03
Method: GET/POST
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/basic/order/data/record /api/order/report

摘要

直充订单回传直充订单回传用于合作方收银的场景，需要把用户的订单信息回传给云音乐 /openapi/music/basic/order/data/record 请求方式： GET/POST 业务参数（bizContent）：参数名是否必填类型说明 action 是 String 上报动作标识 orderTime 是 Long 订单时间戳（毫秒） outTradeNo 是 String 外部交易号 orderStatus 是 ...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	是否必填	类型	说明
action	是	String	上报动作标识
orderTime	是	Long	订单时间戳（毫秒）
outTradeNo	是	String	外部交易号
orderStatus	是	Integer	订单状态：1=成功，2=取消
paymentMethod	是	Integer	支付方式：1=IOS，2=非IOS
chargeType	是	String	付费类型（如：单本付费、联合会员、儿童故事会员、单曲付费、会员付费、其他）
id	是	String	资源ID
type	是	String	资源类型歌曲，播客
creatorId	是	String	创作者ID
creatorName	是	String	创作者名称
orderAmount	是	Long	订单金额（单位：分），含退款扣减
productName	是	String	商品名称（如月卡、年卡等）

#118

三方通知接口

官方 Source

官方分类: 会员API
docId: 9e8c4e2e44de413fbab8fe0f299199f1
更新时间: 2026-01-28 15:03:52
Method: POST
accessToken: 官方未明确；按公共参数文档和接口实际要求处理

Endpoint

无 endpoint（说明类文档或官方未给出）

摘要

三方通知接口三方通知接口支持用户从云音乐收银台购买的订单信息同步到接入方回调地址相关配置：请求url（由接入方提供）请求方式： POST 公共参数：无请求参数参数名类型描述 encryptUserId long 加密的uid encryptOrderId long 加密的云音乐订单号 vipType String 会员类型：黑胶、音乐包、车机会员、svip.

bizContent / 请求参数

表 1

参数名	类型	描述
encryptUserId	long	加密的uid
encryptOrderId	long	加密的云音乐订单号
vipType	String	会员类型：黑胶、音乐包、车机会员、svip.
duration	long	开通时长，单位：天
payTime	long	下单时间戳
amount	String	金额
notifyType	int	通知类型
cashierToken	String	收银台token
Autopay	int	是否自动续费，1-是，0-否
extInfo	String	端上携带扩展信息
sign	String	签名（已使用云音乐私钥签名，接入方可以使用下方的的云音乐公钥验签）

关键响应字段

表 1

参数名	类型	描述
code	string	返回值（code=200代表成功，其余代表失败，返回非200云音乐会重复发送订单回调信息）
message	string	返回信息
sign	string	返回结果签名（接入方使用持有的私钥签名，云音乐使用接入方控制台上的公钥验签）

AI互动

2 篇

#119

开放平台智能搜推

官方 Source

官方分类: AI互动
docId: a4ecffe525504a77904084c3064f407e
更新时间: 2026-01-23 15:18:33
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/stream/common/ai/search

摘要

开放平台智能搜推开放平台智能搜推 /openapi/stream/common/ai/search 需申请接口组：云音乐智能搜推能力智能搜推是一种结合搜索和推荐技术的系统，旨在根据用户的行为和偏好提供个性化的内容或服务。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
sessionId	否	String	会话id，含义为包含当前一次上下文内所有对话
query	是	String	一页数据量（最多500条）

表 2

参数名	类型	说明
resourceType	String	资源类型，当前只有"song"
resourceId	String	资源id，可用于查询歌曲详情等内容
contentExt	String	（SongModel JSON化）歌曲模型

表 3

参数名	类型	说明
encId	String	资源id
name	String	资源名
duration	Integer	歌曲时长
artists	List<ArtistModel>	艺人
albumModel	List<AlbumModel>	专辑
privilegeModel	List<PrivilegeModel>	权限

表 4

参数名	类型	说明
encId	String	资源id
name	String	资源名

关键响应字段

表 1

参数名	类型	说明
contentDone		是否单类资源完结（单类资源完结可以带content）
totalDone		是否整体完结（整体完结后服务端会断开SSE连接，整体完结不会带content）
totalException		整体超时或异常
bizCode		业务标识符（可忽略）
sessionId		本次会话id
dialogueId		本次对话id
msgIndex		单条消息序号，从0开始
responseContent	ResponseContent	响应内容
specialMeasures		响应特殊处理措施可以组合。在反垃圾、服务端异常且需要特殊处理方式时使用
respFixedText		响应覆盖内容
reqFixedText		请求覆盖内容

表 2

参数名	类型	说明
contentType	String	通用内容类型，如text/promptList/logger/resourceList，仅关注text/resourceList，其余内容客户端可自行忽略
bizType	String	业务定义内容类型，一般不使用
content	Object	格式见契约

#120

开放平台一句话歌单

官方 Source

官方分类: AI互动
docId: 12dd920d51c14dd08c2147af3be5c8d8
更新时间: 2026-04-02 16:43:29
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/stream/common/ai/playlist/create

摘要

开放平台一句话歌单开放平台一句话歌单 /openapi/stream/common/ai/playlist/create 需申请接口组：云音乐智能搜推能力移动端入口：搜索框-搜“ai歌单” 一句话歌单：用具体场景/情绪/兴趣+细节描述（如“带点沙哑烟嗓”“吉他声像揉碎星光”）替代模糊需求，触发AI对“风格、氛围、记忆点”的精准捕捉，让歌单不仅是“推荐”，更是“懂你此刻心境的私人BGM”。

bizContent / 请求参数

表 1

参数名	必选	类型	说明
sessionId	否	String	会话id，含义为包含当前一次上下文内所有对话
query	是	String	一页数据量（最多500条）

表 2

参数名	类型	说明
resourceType	String	资源类型，当前只有"song"
resourceId	String	资源id，可用于查询歌曲详情等内容
contentExt	String	（SongModel JSON化）歌曲模型

表 3

参数名	类型	说明
encId	String	资源id
name	String	资源名
duration	Integer	歌曲时长
artists	List<ArtistModel>	艺人
albumModel	List<AlbumModel>	专辑
privilegeModel	List<PrivilegeModel>	权限

表 4

参数名	类型	说明
encId	String	资源id
name	String	资源名

关键响应字段

表 1

参数名	类型	说明
contentDone		是否单类资源完结（单类资源完结可以带content）
totalDone		是否整体完结（整体完结后服务端会断开SSE连接，整体完结不会带content）
totalException		整体超时或异常
bizCode		业务标识符（可忽略）
sessionId		本次会话id
dialogueId		本次对话id
msgIndex		单条消息序号，从0开始
responseContent	ResponseContent	响应内容
specialMeasures		响应特殊处理措施可以组合。在反垃圾、服务端异常且需要特殊处理方式时使用
respFixedText		响应覆盖内容
reqFixedText		请求覆盖内容

表 2

参数名	类型	说明
contentType	String	通用内容类型，如text/promptList/logger/resourceList，仅关注text/resourceList，其余内容客户端可自行忽略
bizType	String	业务定义内容类型，一般不使用
content	Object	格式见契约

跨端续播API

3 篇

#121

获取歌单里的歌曲列表v4

官方 Source

官方分类: 跨端续播API
docId: 781b8d60178f428695e8ff3b464a3736
更新时间: 2026-01-23 15:23:31
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/song/list/get/v4

摘要

获取歌单里的歌曲列表v4 获取歌单里的歌曲列表v4 /openapi/music/basic/playlist/song/list/get/v4 有上报的时间戳，用于快速恢复播放列表顺序请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 playlistId 是 String 歌单Id 上限11000首歌曲请求示例：返回参数说明参数名类型说明 id Str...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
playlistId	是	String	歌单Id

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲Id
addTime	String	添加时间

#122

跨端续播-上报

官方 Source

官方分类: 跨端续播API
docId: 0c5f0f57a068438cbfb6d33d9583f263
更新时间: 2026-06-05 18:08:33
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/multi/reconnect/play/report

摘要

跨端续播-上报跨端续播-上报 /openapi/music/multi/reconnect/play/report 需申请接口组：资源分享能力跨端续播能力要求 1：app端打开跨端能力：移动端设置-》播放与下载-》跨端续播开启 2：两个端及以上近7天内有登录，并且其中有一端播放了歌曲 3：只支持续播1天内其他端播放的歌曲，同类型设备之间不支持跨端（比如两辆车之间不行） 4：移动端不支持心动模式、私人漫游、相似歌曲场景下的歌曲上报 ...

bizContent / 请求参数

表 1

参数名	类型	必选	说明
sourceType	String	否	播放列表来源类型： playlist 歌单 / podcast 播客 / album 专辑
initResId	String	否	初始的默认资源 id
sourceId	String	否	播放列表来源 id（如歌单 id、播客 id 等）
podcastAsc	Boolean	否	播客升序标志： true 升序 / false 降序，不传走播客默认排序
resources	String	否	播放列表具体资源列表，示例 {"id":"12234","type":"voice"} （参 Resource ）
resource	String	否	当前播放资源，示例 {"id":"22344","type":"voice"} （参 Resource ）
progress	Long	否	播放进度（毫秒，播客必填）
sessionId	String	是	标识某轮播放 id，企业自定义；播放列表变化时变化，其他情况保持不变（如下一首）
state	Integer	是	1 ：播放列表变化上报； 2 ：播放列表不变，只是切歌
playMode	String	否	播放模式： random / order / list_loop （默认）/ single_loop
playlistId	String	否	歌单 id
songIds	String	否	歌曲列表，示例 ["dasdasd","addasd"]
currentSongId	String	否	当前播放的歌曲 id

表 2

参数名	类型	必选	说明
id	String	否	声音节目id
type	String	否	播客类型，固定voice

关键响应字段

官方文档未给完整结构化字段表。

#123

跨端续播-查询

官方 Source

官方分类: 跨端续播API
docId: b8b94936a02241328cdc23a1b572bae7
更新时间: 2026-06-05 18:16:37
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/multi/reconnect/play/info/get /openapi/music/basic/playlist/song/list/get/v4

摘要

跨端续播-查询跨端续播-查询 /openapi/music/multi/reconnect/play/info/get 需申请接口组：资源分享能力跨端续播能力要求 1：app端打开跨端能力：移动端设置-》播放与下载-》跨端续播开启 2：两个端及以上近7天内有登录，并且其中有一端播放了歌曲 3：只支持续播1天内其他端播放的歌曲，同类型设备之间不支持跨端（比如两辆车之间不行） 4：移动端不支持心动模式、私人漫游、相似歌曲场景下的歌曲上...

bizContent / 请求参数

表 1

参数名	类型	说明
id	String	资源id
type	String	资源类型
originalId	String	明文id

表 2

参数名	类型	说明
resourceId	String	资源id
resourceType	String	资源类型
progress	Long	播放进度毫秒
originalId	String	明文id

表 3

参数名	说明
pc	来自你的电脑
tv	来自你的电视
andrcar	来自你的汽车
ios	来自你的iPhone
android	来自你的手机
default	来自你的其他设备

关键响应字段

表 1

参数名	类型	说明
deviceId	String	从哪台设备过来
sessionId	String	哪个播放列表会话
relayMode	String	跨端数据模式
sourceId	String	播放列表来源id (歌单id、播客id)
sourceType	String	来源类型，歌单还是播单
resources	List<OpenApiRelayResourceVO>	播放列表资源详情
currentPlayState	OpenApiPlayStateVO	当前播放状态情况
playMode	String	播放模式：random随机播放, order顺序播放, list_loop列表循环, single_loop单曲循环
reportTime	Long	上报时间，单位：ms
deviceName	String	跨端设备名
os	String	端信息

随心唱API

3 篇

#124

随心唱-歌曲是否支持干声（人声）

官方 Source

官方分类: 随心唱API
docId: b2f090f562b740be8fbf9a014c054bfb
更新时间: 2026-01-23 15:27:54
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/freely/sing/get

摘要

随心唱-歌曲是否支持干声（人声）随心唱-歌曲是否支持干声（人声） /openapi/music/basic/song/freely/sing/get 请求方式： POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songIds 是 List<String> 歌曲Id列表请求示例：返回参数说明参数名类型说明 songId String 歌曲id hasVocal Boolea...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songIds	是	List<String>	歌曲Id列表

关键响应字段

表 1

参数名	类型	说明
songId	String	歌曲id
hasVocal	Boolean	是否支持干声（人声）
hasMultiTrack	Boolean	是否有合并声（多轨音频）

#125

随心唱-歌曲获取音频详情

官方 Source

官方分类: 随心唱API
docId: 0e0cd6b2a6d449e98dd0f483d12241b6
更新时间: 2026-01-23 15:28:16
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/freely/sing/detail

摘要

随心唱-歌曲获取音频详情随心唱-歌曲获取音频详情 /openapi/music/basic/song/freely/sing/detail 请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songIds 是 List<String> 歌曲Id列表请求示例：返回参数说明参数名类型说明 songId String 歌曲id origin AudioVO 原...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songIds	是	List<String>	歌曲Id列表

表 2

参数名	类型	说明
type	int	音频类型
url	String	音频地址
duration	int	音频时长，单位ms
size	int	音频大小
md5	int	音频加密
audioQuality	int	音质
time	int	音频时长，单位s
level	String	级别
br	int	码率

关键响应字段

表 1

参数名	类型	说明
songId	String	歌曲id
origin	AudioVO	原唱音频
accompany	AudioVO	伴奏音频
vocal	AudioVO	干声音频（人声）
multiTrack	AudioVO	多轨音频

#126

补充文档

官方 Source

官方分类: 随心唱API
docId: 06f45c069ad540d693967516b2c87c12
更新时间: 2024-12-17 10:33:49
Method: 官方未明确；无特殊说明按 GET 处理
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/detail/get/v2 /openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/recommend/songlist/get/v2 /openapi/music/basic/search/song/get/v3 /openapi/music/basic/album/song/list/get/v2 /openapi/music/basic/search/song/by/artist/song/get/v2 /openapi/music/basic/search/song/byartist/get/v2 /openapi/music/basic/search/song/get/v2 /openapi/music/basic/song/list/get/v2

摘要

补充文档歌曲详情接口歌曲列表接口目前大概100w热歌支持涉及以下接口，都已增加查询干声出入参： /openapi/music/basic/song/detail/get/v2 /openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/recommend/songlist/get/v2 /openapi/music/basic/search/song/...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
artists	List<Artist>	艺人列表
fullArtists	List<Artist>	完整艺人列表（包含已下线艺人）
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
其余 6 行见官方文档

AIDJ

3 篇

#127

获取行为口播信息（暂不支持）

官方 Source

官方分类: AIDJ
docId: 23515286a8b14ddaa2438eed712f4128
更新时间: 2026-01-23 15:26:25
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/action/aidj/audio/get

摘要

获取行为口播信息（暂不支持）获取行为口播信息（暂不支持） /openapi/music/basic/action/aidj/audio/get 请求方式： POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 actionKeys 是 String 场景 timbreKey 是 String 音色两个入参有枚举列表，都需要提前和云音乐同事约定好请求示例：返回参数说明参数名类型 ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
actionKeys	是	String	场景
timbreKey	是	String	音色

关键响应字段

表 1

参数名	类型	说明
audioUrl	String	音频地址
audioId	String	音频id
conversation	String	口播文案
duration	Float	音频时长单位秒
size	Long	语音文件大小，单位字节
gain	Float	语音文件 gain 值
peak	Float	语音文件 peak 值
poolCode	String	不同类型的音频对应不同的code
validTime	Long	有效时间单位秒即多久之后过期
fadeInOut	Boolean	是否支持淡入淡出(指和歌曲资源的重叠播放)
timbreKey	String	音色key

#128

获取音色列表

官方 Source

官方分类: AIDJ
docId: 4db4e338fe524c6b91017996b5ed9197
更新时间: 2026-04-17 17:16:39
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/aidj/audio/timbre/get /api/openapi/score/queryMonthReporPic

摘要

获取音色列表获取音色列表 /openapi/music/basic/aidj/audio/timbre/get - 需申请接口组：AIDJ能力请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无请求示例：返回参数说明参数名类型说明 avatar String 头像 userDetailUrl String 用户详情地址 name String 用户名称 timbreKey St...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
avatar	String	头像
userDetailUrl	String	用户详情地址
name	String	用户名称
timbreKey	String	音色key
timbreDesc	String	音色描述
playUrl	String	播放地址
defaultAudio	String	是否为默认音色
gain	String	语音文件 gain 值
peak	String	语音文件 peak 值
bindingMode	String	绑定的漫游模式

#129

获取歌曲口播信息

官方 Source

官方分类: AIDJ
docId: 5bfd65db8f1d4290908269884c7a81a4
更新时间: 2026-05-08 11:13:40
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/aidj/audio/get

摘要

获取歌曲口播信息获取歌曲口播信息 /openapi/music/basic/song/aidj/audio/get 需申请接口组：AIDJ能力请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songIds 是 String 歌曲列表JSON字符串，eg: "["4FF2AEFFA12B91F8B36FC7A7A191946F"]" timbreKey 是 St...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songIds	是	String	歌曲列表JSON字符串，eg: "["4FF2AEFFA12B91F8B36FC7A7A191946F"]"
timbreKey	是	String	音色，测试可以传F793-C2
lastReqTimestamp	否	Long	上一次请求口播的时间戳（ms），默认为0，0认为是第一次请求,用于判断是否为首次请求，出首次请求欢迎语

关键响应字段

表 1

参数名	类型	说明
audioUrl	String	音频地址
audioId	String	音频id
conversation	String	口播文案
duration	Float	音频时长单位秒
size	Long	语音文件大小，单位字节
gain	Float	语音文件 gain 值
peak	Float	语音文件 peak 值
poolCode	String	不同类型的音频对应不同的code
validTime	Long	有效时间单位秒即多久之后过期
fadeInOut	Boolean	是否支持淡入淡出(指和歌曲资源的重叠播放)
timbreKey	String	音色key

评论API

4 篇

#130

精选乐评

官方 Source

官方分类: 评论API
docId: 66c28d12c8714b1f9e50e7c4b73279ad
更新时间: 2026-01-21 16:28:36
Method: GET
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/heart/beat/widget/get

摘要

精选乐评精选乐评 /openapi/music/heart/beat/widget/get 每次请求随机出三首歌的精选评论请求方式： GET 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 limit 是 Int 获取乐评数量，非必传默认1 请求示例：返回参数说明参数名类型说明 songListVoList List<songListVo> 歌曲信息 image String 封...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
limit	是	Int	获取乐评数量，非必传默认1

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
其余 1 行见官方文档

关键响应字段

表 1

参数名	类型	说明
songListVoList	List<songListVo>	歌曲信息
image	String	封面url
background	String	背景
contents	List<String>	评论列表
subContent	String	评论作者
icon	String	乐评logo
festivalData	WidgetVO	节假日信息

表 2

#131

乐评日历(旧版)

官方 Source

官方分类: 评论API
docId: d8517df2c3594307baff5ecbe50f238d
更新时间: 2026-01-21 16:30:52
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/heart/beat/widget/get

摘要

乐评日历(旧版) 乐评日历(旧版) /openapi/music/heart/beat/widget/get - 需申请接口组：开放平台专区能力 - 车载场景，每天会出一个乐评，打开云音乐可以触发乐评封面请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 contentType 是 String 固定传：CALENDAR 请求示例：返回参数说明参数名类型说明...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
contentType	是	String	固定传：CALENDAR

表 2

参数名	类型	说明
id	String	歌曲id
name	String	歌曲名称
duration	long	歌曲时长
albumName	String	专辑名
albumId	String	专辑Id
albumArtistId	String	专辑艺人Id
albumArtistName	String	专辑艺人名
artistId	String	艺人Id
artistName	String	艺人名
coverImgUrl	String	封面Url
mvId	String	mvId
playUrl	String	播放url
playFlag	Boolean	是否可以播放（true，false）
downloadFlag	Boolean	是否可以下载歌曲（true，false）
payPlayFlag	Boolean	是否需要付费才能播放（true、false）
payDownloadFlag	Boolean	是否需要付费才能下载（true、false）
vipFlag	boolean	需要VIP才能播放和下载
vipPlayFlag	boolean	需要VIP才能播放
freeTrailFlag	boolean	是否支持试听
freeTrail	FreeTrail	试听起止时间，单位：s
liked	boolean	是否喜欢
songMaxBr	int	歌曲原本的最大码率（已失效）
userMaxBr	int	用户能播放的最大码率（已失效）
maxBrLevel	String	歌曲拥有最大码率对应的level
plLevel	String	用户可播放歌曲最大码率对应的level
dlLevel	String	用户可下载歌曲最大码率对应的level
level	String	当前返回的歌曲码率对应的level
songSize	int	歌曲的大小
songMd5	String	歌曲的MD5
songTag	List<String>	歌曲的曲风标签
songFee	int	歌曲付费类型
br	int	返回的歌曲码率
audioFlag	int	是否有杜比：1
effects	String	音效信息（目前仅杜比才有）
privateCloudSong	boolean	是否云盘歌曲
其余 1 行见官方文档

关键响应字段

表 1

参数名	类型	说明
songListVoList	List<songListVo>	歌曲信息
image	String	封面url
background	String	背景
contents	List<String>	评论内容
subContent	String	评论作者
icon	String	乐评logo
festivalData	WidgetVO	节假日信息

#132

获取歌曲热门评论

官方 Source

官方分类: 评论API
docId: c7ab2954a5a04fdd86d01c88d811786c
更新时间: 2026-02-27 14:50:59
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/comment/get-best-comments-by-song

摘要

获取歌曲热门评论获取歌曲热门评论 /openapi/music/comment/get-best-comments-by-song 需申请接口组：云音乐评论能力获取指定歌曲的最热评论（按照最热排序，默认取50条）请求方式： GET /POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 songId 是 Strin 歌曲ID（加密）请求示例：返回参数说明参数名类型说明 so...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
songId	是	Strin	歌曲ID（加密）

关键响应字段

表 1

参数名	类型	说明
songId	String	歌曲ID（加密）
comments	List<OpenCommentVO>	评论列表）

表 2

参数名	类型	说明
content	String	乐评内容
nickName	String	乐评用户昵称
likedCount	Long	点赞数量
likedRank	Integer	点赞排名

#133

乐评日历(新版)

官方 Source

官方分类: 评论API
docId: 1852858fcd544c85aa66d6f831b0e78c
更新时间: 2026-05-11 13:56:12
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/comment/calendar/get /openapi/music/heart/beat/widget/get

摘要

乐评日历(新版) 乐评日历(新版) /openapi/music/basic/comment/calendar/get - 需申请接口组：开放平台专区能力 - 车载场景，每天会出一个乐评，不超过30个字，打开云音乐可以触发乐评封面（频率可以自动） - 这个接口带样式设计，但是没有歌曲详情，需要二次查询 - 偶尔有会员歌曲出现，每条评论最长140个字(一般不会这么长) 请求方式： GET/POST 公共参数： IOT公共参数业务参数（...

bizContent / 请求参数

表 1

参数名	类型	说明
fontColor	String	字体颜色
year	Integer	年，eg 2022
month	Integer	月，eg 11
day	Integer	日，eg 10
dayImg	String	日期图
dayOfWeek	Integer	星期几
festival	String	节日
horizontalBackground	String	横版图片
verticalBackground	String	竖版图片
backgroundColor	String	节假日背景颜色

表 2

参数名	类型	说明
originArtistName	String	歌手名

关键响应字段

表 1

参数名	类型	说明
texts	List<String>	评论列表
origin	String	评论者
songId	String	歌曲ID
songName	String	歌曲名称
coverUrl	String	封面
singerName	String	歌手名
commentCalendar	OpenApiCommentCalendarDateDetailVO	评论日期信息
ext	Map<String, Object>	附加信息

音质体验卡API

2 篇

#134

获取体验卡

官方 Source

官方分类: 音质体验卡API
docId: e6491ef0b76f453a81f28c20e5063b3f
更新时间: 2026-05-07 17:36:50
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/interest/trial/card/get

摘要

获取体验卡获取体验卡 /openapi/music/interest/trial/card/get 需申请接口组：权益相关功能联系云音乐运营配置请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：无请求示例：返回参数说明参数名类型说明 id String 权益包id name String 权益包名称 state int 是否可以领取：（0不可以，1可以） refInteres...

bizContent / 请求参数

官方文档未给完整结构化字段表。

关键响应字段

表 1

参数名	类型	说明
id	String	权益包id
name	String	权益包名称
state	int	是否可以领取：（0不可以，1可以）
refInterests	List<RefInterestVO>	权益明细

#135

领取和使用体验卡

官方 Source

官方分类: 音质体验卡API
docId: 883ca2a5faa44e74b139485b3886a9a0
更新时间: 2026-05-07 17:37:37
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/interest/trial/card/obtained

摘要

领取和使用体验卡领取和使用体验卡 /openapi/music/interest/trial/card/obtained 需申请接口组：权益相关功能联系云音乐运营配置请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名类型说明 composeId String 权益包id 请求示例：返回参数说明参数名类型说明 msg String 提示信息 obtained Boole...

bizContent / 请求参数

表 1

参数名	类型	说明
composeId	String	权益包id

关键响应字段

表 1

参数名	类型	说明
msg	String	提示信息
obtained	Boolean	true：领取成功，false：领取失败
errorCode	int	领取错误码

音质限免API

2 篇

#136

音质限免开启

官方 Source

官方分类: 音质限免API
docId: 4f9c4d4a901c4d2fabf25c3c8a092f4f
更新时间: 2026-01-21 16:13:04
Method: POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/quality/interests/start

摘要

音质限免开启音质限免开启 /openapi/music/basic/song/quality/interests/start 需申请接口组：云音乐音质能力请求方式： POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 level 是 String 音质只能一个个的开 level枚举参数名说明 vivid Audio Vivid全景声 dolby 杜比全景声 sky 沉浸环绕声 ...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
level	是	String	音质

表 2

参数名	说明
vivid	Audio Vivid全景声
dolby	杜比全景声
sky	沉浸环绕声
jyMaster	超清母带
jyEffect	高清臻音

关键响应字段

表 1

参数名	类型	说明
useSuc	Boolean	是否开启成功
trialStatus	Integer	限免状态（不用管）
trialType	Integer	限免类型（不用管）
expireTime	Long	限免到期时间（不用管）

#137

音质限免查询

官方 Source

官方分类: 音质限免API
docId: 0e5dfa2dfe5a48a6843b18ee1abeefcc
更新时间: 2026-04-24 17:23:51
Method: GET/POST
accessToken: 按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/quality/interests/get

摘要

音质限免查询音质限免查询 /openapi/music/basic/song/quality/interests/get 需申请接口组：云音乐音质能力请求方式： GET/POST 公共参数： IOT公共参数业务参数（bizContent）：参数名必选类型说明 levels 是 List<String> 音质列表，eg:["jymaster"] 联系云音乐同事进行渠道、人群包、限免时效等配置最佳实践 {"levels":...

bizContent / 请求参数

表 1

参数名	必选	类型	说明
levels	是	List<String>	音质列表，eg:["jymaster"]

表 2

参数名	说明
vivid	Audio Vivid全景声
dolby	杜比全景声
sky	沉浸环绕声
jyMaster	超清母带
jyEffect	高清臻音

表 3

参数名	类型	说明
useSuc	Boolean	是否开启成功（不用管）
trialStatus	Integer	限免状态，1：有权限开没开，2：已开
trialType	Integer	限免类型
expireTime	Long	限免到期时间

关键响应字段

表 1

参数名	类型	说明
canUse	Boolean	是否能使用
canUseType	Integer	可使用的类型
canNotUseReasonCode	Integer	无法使用的code码
trialInfo	trialInfo	限免相关信息

参数名	类型	是否必填	说明
songIds	String	是	上次推荐的歌曲列表
source	String	是	来源，算法字段，私人定制：CAR_PAGE_RECOMMEND_PRIVATE_RCMD_SONG
currentPlaySongId	String	否	当前播放的歌曲列表
limit	int	否	请求数量，默认12
qualityFlag	Boolean	否	是否获取音质列表
extFlags	String	否	保留字段

参数名	必选	类型	说明
scene	是	String	场景标签
limit	否	Int	获取数据量（建议3，最多10）
withPlayUrl	否	Boolean	是否返回播放URL
qualityFlag	否	Boolean	是否下发音质

参数名	必选	类型	说明
limit	否	Int	请求资源数，默认5，最多12首
trialScene	否	String	全曲试听相关，默认null
qualityFlag	否	Boolean	是否下发音质，默认false

参数名	必选	类型	说明
limit	是	Int	请求数据量（建议30首），最大40
qualityFlag	否	Boolean	是否下发音质

参数名	类型	说明
image	String	banner图片地址
resourceId	String	资源id（加密后的）
resourceType	String	资源类型
targetUrl	String	跳转地址

参数名	类型	说明
userfm	String	私人漫游
toplist	String	榜单
list	String	歌单
dailySongs	String	每日推荐
virtualPlaylist	String	私人推荐
voice	String	有声书（暂不支持）
voicelist	String	播客（暂不支持）

类型	入参	对应接口
userfm	resourceId	私人漫游 /openapi/music/basic/private/fm/roaming/song/list
toplist	resourceId	榜单 /openapi/music/basic/playlist/song/list/get/v3
list	resourceId	歌单 /openapi/music/basic/playlist/song/list/get/v3
dailySongs	/	每日推荐 /openapi/music/basic/recommend/songlist/get/v2
virtualPlaylist	/	私人定制 /openapi/music/basic/recommend/style/songlist/get

参数名	类型	说明
resourceId	String	资源Id（歌曲id、歌单id等）
resourceType	String	资源类型
title	String	标题
tag	String	封面角标
coverUrlList	String	封面

参数名	类型	说明
url	String	图片地址
onImageIconUrl	String	附加在图上的图标

资源类型	模块	对应接口
daily_song_rec	每日推荐	/openapi/music/basic/recommend/songlist/get/v2
fm	私人漫游	/openapi/music/basic/private/fm/roaming/song/list
radar	私人雷达	/openapi/music/basic/playlist/song/list/get/v3
another_radar	其他雷达	/openapi/music/basic/playlist/song/list/get/v3
song_fm	相似歌曲	/openapi/music/basic/private/fm/roaming/song/list
artist_fm	相似艺人	/openapi/music/basic/private/fm/roaming/song/list
tag_daily_rec	风格日推	/openapi/music/basic/song/daily/style/get
hot_song_board	热歌榜	/openapi/music/basic/playlist/song/list/get/v3
soar_board	飙升榜	/openapi/music/basic/playlist/song/list/get/v3
new_song_board	新歌榜	/openapi/music/basic/playlist/song/list/get/v3
user_like	心动模式	/openapi/music/basic/song/play/intelligence/get
mood	心情氛围	/openapi/music/basic/playlist/song/list/get/v3
once_hear	曾经爱听	/openapi/music/basic/playlist/song/list/get/v3

网易云开放平台 Music API 文档镜像

接入前置参考

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

动态与公告

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

公共

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

新版自定义模块

Endpoint

摘要

bizContent / 请求参数

关键响应字段

用户登录API

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

Endpoint

摘要

bizContent / 请求参数

关键响应字段

推荐-歌曲类API

Endpoint