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

这是“音乐API文档”的本地可读版本。它只记录官方接口事实,不包含 CodeNocturne 的开发优先级判断。 官方页面为动态渲染,后续开发可用此 HTML 作为基准文档,并通过每个接口的 Source 链接回到官方页面核对。

保密规则:不得在代码、文档、日志或测试夹具中写入真实 appId、private key、accessToken、 refreshToken、deviceId 或用户隐私数据。本文件已对官方示例中的敏感形态字段做占位脱敏。

音乐 API 文档项135
基准文档项133
异常保护阈值100
目录数量变化
接入前置参考2
检测到 endpoint129
官方分类31
没有匹配的接口。

接入前置参考

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
参数名类型必选说明
appIdString云音乐分配给开发者的应用ID,控制台上
appSecretString云音乐分配给开发者的应用Secret,控制台上
signTypeString应用生成签名字符串所使用的签名算法类型,目前支持:RSA_SHA256
signString请求参数的签名串,签名生成方式详见 RSA加密
timestampLong请求发出的UNIX时间戳,毫秒级,服务端会校验是否在5分钟内,超时拒绝
bizContentString业务请求参数的集合,json格式化,最大长度不限,除公共参数外所有业务请求参数都必须放在这个参数中传递,具体参照各Api文档
accessTokenString登录令牌 ,匿名接口不需要,其他接口必传。匿名登录时,每台设备需生成唯一的accessToken
deviceString设备信息,json格式化
表 2
参数名类型必选说明
channelString厂商标识, 由云音乐分配,需线下联系云音乐同事确认
deviceIdString设备唯一Id (每台设备需保持唯一,可传sn、mac、IMEI、vin、iccid等值)
deviceTypeString设备类型, 需线下联系云音乐同事确认
appVerString客户端版本号(自研的云音乐版本号,可自定义,如1.1.1)
osString端类型, 由云音乐分配,需线下联系云音乐同事确认
osVerString系统版本( 车机系统,可自定义,如:8.1.0)
brandString品牌, 需线下联系云音乐同事确认
modelString设备型号 (车型,可自定义)
clientIpString终端IP,设备调用接口时的出口IP地址
netStatusString网络状态,wifi/2g/3g/4g/5g
表 3
参数名必选类型说明
idSting当前资源id, 例如:歌曲的id,声音的id或者encVoiceId
actionString行为,startplay:开始播放
bitrateInt码率,单位/kbps。song传实际播放码率,128:标准,320:极高,999:无损,1999:hires,高清臻音:3999,超清母带:4999,沉浸环绕声:4099,杜比全景声:2999,臻音全景声(vivid):5999,播客固定传128
fileInt文件类型回传枚举值:0:下载文件, 1:本地文件, 2:缓存文件, 3:云盘文件, 4:线上文件。不清楚填4
typeSting类型,song:歌曲, dj:播客
startLogTimeLong开始播放时的时间戳,单位:毫秒
algSting算法使用,私人漫游、每日推荐和场景音乐已返回该字段,产生播放时需透传alg(其余场景可参考下方,也可不传)
isAuditionInt试听类型,1:片段试听(固定传1),2:全曲试听
auditionStartInt试听片段开始时间点(从上游接口取,不同用户不一样),单位/s
auditionEndInt试听片段结束时间点(从上游接口取,不同用户不一样),单位/s
sourceIdSting播放来源资源ID(最近常听必传)
sourceTypeSting播放来源资源类型(最近常听必传)
categoryIdLong播客categoryId
openApiTraceInfoString全曲试听播放时需透传该字段(播放地址相关接口会下发)
extString设备唯一识别码,游戏必传,ios传idfa,android传oaid,eg:{"idfa":"abc"}或{"oaid":"def"}
表 4
参数名必选类型说明
idSting当前资源id, 例如:歌曲的id,声音的id或者encVoiceId
actionString行为,play:结束播放
bitrateInt码率,单位/kbps。song传实际播放码率,128:标准,320:极高,999:无损,1999:hires,高清臻音:3999,超清母带:4999,沉浸环绕声:4099,杜比全景声:2999,臻音全景声(vivid):5999,播客固定传128
fileInt文件类型回传枚举值:0:下载文件, 1:本地文件, 2:缓存文件, 3:云盘文件, 4:线上文件。不清楚填4
typeSting类型,song:歌曲, dj:播客
startLogTimelong开始播放时的时间戳,单位:毫秒
timedouble播放时长,单位:秒, 播放完成或者中止播放时的时长,按照实际播放时长统计,不包含暂停,不能超过歌曲总时长
endSting结束方式回传枚举值:playend:正常结束(歌曲播放到结尾自然结束;系统自动触发上报);interrupt:第三方APP打断(第三方应用抢占音频焦点;系统通知或电话等打断播放); exception:错误(网络错误导致播放失败;歌曲文件损坏;其他技术异常); ui: 用户切歌(用户主动切换到下一首/上一首;用户切换播放列表;用户点击指定歌曲播放;用户暂停播放)。不清楚填playend
algSting算法使用,私人漫游、每日推荐和场景音乐已返回该字段,产生播放时需透传alg(其余场景可参考下方,也可不传)
isAuditionInt试听类型,1:片段试听(固定传1),2:全曲试听
auditionStartInt试听片段开始时间偏移(从上游接口取,不同用户不一样),单位/s
auditionEndInt试听片段时间偏移(从上游接口取,不同用户不一样),单位/s
sourceIdSting播放来源资源ID(最近常听必传)
sourceTypeSting播放来源资源类型(最近常听必传)
categoryIdLong播客categoryId
openApiTraceInfoString全曲试听播放时需透传该字段(播放地址相关接口会下发)
extString设备唯一识别码,游戏必传,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
vipPlayFlagvipPlayFlag字段正确赋值优化/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
参数名必选类型说明
domainString云音乐相关域名
ipInt若未填会尝试获取请求发起的ip

关键响应字段

表 1
参数名类型说明
ipStringipv4列表
ipv6Stringipv6列表
preferString推荐ipv4或ipv6
ttlString过期时间
#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
codemessage
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参数
1406accessToken过期
1407对应账号不存在或者账号被封禁,grantcode(授权码错误或者已过期);
1408accesstoken 无效
-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
参数名类型必选说明
appIdString云音乐分配给开发者的应用ID ,控制台上有
signTypeString应用生成签名字符串所使用的签名算法类型,目前支持RSA_SHA256
signString请求参数的签名串,签名生成方式详见 RSA加密
timestampLongUNIX时间戳,毫秒级
bizContentString请求参数的集合,json格式化后** 需要encode **,最大长度不限,除公共参数外所有业务请求参数都必须放在这个参数中传递,具体参照各Api文档
accessTokenString否(按接口要求传)登录令牌 ,匿名和二维码登录接口不需要,其他接口必传。匿名登录时,每台设备需生成唯一的accessToken
deviceString设备信息,json格式化后** 需要encode **
表 2
参数名类型必选说明
channelString厂商标识, 由云音乐分配,需线下联系云音乐同事确认
deviceIdString设备唯一Id(每台设备需保持唯一,可传sn、mac、IMEI、vin、iccid等值)
deviceTypeString设备类型, 需线下联系云音乐产品确认
appVerString客户端版本号(自研的云音乐版本号)
osString操作系统类型, 由云音乐分配,需线下联系云音乐同事确认
osVerString操作系统版本( 车机系统,如:8.1.0)
brandString品牌, 需线下联系云音乐同事确认
modelString设备型号(车型、产品型号)
clientIpString终端IP,设备调用接口时的IP地址
netStatusString网络状态,wifi/2g/3g/4g/5g
flowFlagString是否初始化,默认:init,该字段决定本次请求是否被计算成日活

关键响应字段

表 1
参数名类型必选说明
codeString错误码
messageString错误信息
dataObject数据记录
表 2
参数名类型必选说明
recordCountInt总数
recordsList列表数据

新版自定义模块

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
参数名必选类型说明
pageCodestring页面code
extJsonstring扩展JSON参数
cursorstring分页游标(可选)
表 2
moduleType含义使用页面出现数量
bannerBanner 轮播发现页 / 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
参数名类型描述
resourceTypeString资源类型
resourceObject资源明细
表 4
resourceTypeMapper输出 Model出现场景
playlistplaylistResourceMapperBasePlaylistModel歌单模块的资源项
toplistplaylistResourceMapperBasePlaylistModel排行榜资源项
songsongResourceMapperBaseSongModel歌曲模块的资源项
cardcardResourceMapperBaseCardModel每日推荐 / 最近常听 / 雷达歌单 / 播客 / 电台
dailySongscardResourceMapperBaseCardModel每日推荐歌曲
fmcardResourceMapperBaseCardModelFM 电台
starcardResourceMapperBaseCardModel明星 / 艺人
playListcardResourceMapperBaseCardModel歌单卡片(大小写变体)
similarSongcardResourceMapperBaseCardModel相似歌曲
similarArtistcardResourceMapperBaseCardModel相似艺人
activitycardResourceMapperBaseCardModel活动 / 场景电台入口
voicevoiceResourceMapper播客
djradiovoiceResourceMapper电台节目
artistartistResourceMapperBaseArtistModel艺人
bannerbannerResourceMapperBaseBannerModelBanner 项
albumalbumResourceMapperBaseAlbumModel专辑(HiFi页新增)

关键响应字段

表 1
参数名类型描述
modulesList<CustomPageModuleDetailVO>模块列表
cursorString分页游标,为空表示已到末页或未启用分页
hasMoreBoolean是否还有更多数据
表 2
参数名类型描述
moduleCodeString模块唯一标识(用于区分模块)
moduleNameString模块名
moduleTypeString模块类型
resourcesList<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
参数名必选类型说明
typeint设备类型, 固定传入type = 2
expiredKeystring二维码过期时间(单位s,固定传300)

关键响应字段

表 1
参数名类型说明
qrCodeUrlString登录二维码url
uniKeyString二维码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
参数名必选类型说明
keyString二维码的unikey
clientIdString对应appId
表 2
参数名类型说明
accessTokenString下发的token
refreshTokenString用于刷新的refresh token
expireTimeLongtoken过期时间(秒)

关键响应字段

表 1
参数名类型说明
accessTokenAccessTokentoken相关数据
statusInt二维码状态(800:不存在或过期, 801:等待扫码, 802:授权中, 803:授权登录成功, 804:未知错误)
msgInt二维码状态说明
#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
参数名必选类型说明
grantCodestring登录code,就是回调的code

关键响应字段

表 1
参数名类型说明
accessTokenString用户token
refreshTokenString刷新token
openIdString对于同一个接入方客户端来讲, 同一用户返回的openId是一致的(已失效)
unionIdString对于同一个接入方来讲, 同一用户返回的unionId是一致的(已失效)
expireInString有效期(秒)
#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
参数名类型说明
userIdString明文用户id
anonymousBoolean是否匿名用户
#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
参数名类型必选描述备注
clientIdString应用idAppId
stateString自定义随机字符串,会在oauth的回跳步骤带回给接入方长度30以内,数字或字母(不允许传入=、;、空格、+、
clientTypeString接入方端类型和当前应用创建时选择的类型保持一致,大多数固定传web(会和控制台上的应用类型做校验)
redirectUrlString接入方重定向地址重定向的http地址, 控制台上填的授权回调域名为前缀或者保持一致,申请时为原始地址,传参时需要进行encode()
schemaUrlString打开接入方App的schema协议 (唤端必传)示例:iSchema://openurl?url=,授权完成后如果需要唤起接入方app,需接入方传入打开已方的schema协议,该字段需要进行encode(), 目前仅在云音乐App内有效

关键响应字段

表 1
code类型msg
400integergrantCode参数错误
表 2
code类型msg
1406integeraccessToken过期,请重新授权登录
1407integeraccessToken非法
1408integer账户已封禁或注销
400integeraccessToken参数错误
表 3
code类型msg
1406integeraccessToken过期,请重新授权登录
1407integeraccessToken非法
1408integer账户已封禁或注销
400integerrefreshToken参数错误
#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
参数名必选类型说明
clientIdString控制台上的appId
clientSecretString控制台上的appSecret
refreshTokenStringtoken对应的refreshToken

关键响应字段

表 1
参数名类型说明
accessTokenString下发的token
refreshTokenString用于刷新的refresh token
expiresTimeLongtoken过期时间(秒)
表 2
code说明
1406accessToken过期,或者refresh Token过期
1407对应账号不存在或者账号被封禁,grantcode(授权码错误或者已过期)
1408accesstoken 无效
#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
参数名类型说明
idString用户Id
nicknameString用户昵称
avatarUrlString头像
genderString性别, 未知: 0; 男:1; 女:2;
signatureString签名
redVipLevelint黑胶会员等级
vipDetailList<VipOpenDetailDto>当前生效的vip类型
fullVipDetailList<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
参数名必选类型说明
clientIdstring就是appId,填一样的

关键响应字段

表 1
参数名类型说明
accessTokenString下发的token(永不过期)
refreshTokenString下发的refreshToken(不用管)
expireTimeString有效期(不用管)

推荐-歌曲类API

8 篇
#19

每日推荐封面

官方 Source
官方分类
推荐-歌曲类API
docId
b23243d8debf4333ad7f3cb15b071900
更新时间
2026-01-21 15:01:23
Method
GET
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/daily/image

摘要

每日推荐封面 每日推荐封面 /openapi/music/basic/recommend/daily/image 获取每日推荐封面 请求方式: GET 公共参数: IOT公共参数 业务参数(bizContent): 无 请求示例: 返回参数说明 ImageVO 参数名 类型 说明 name String 名称 ImgUrl String 封面 返回示例 { "code":200, "subCode":null, "message":n...

bizContent / 请求参数

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

关键响应字段

表 1
参数名类型说明
nameString名称
ImgUrlString封面
#20

获取相似歌曲(新)

官方 Source
官方分类
推荐-歌曲类API
docId
afd1a27abcda4d36b464b7871a44159b
更新时间
2026-01-21 15:02:13
Method
GET/POST
accessToken
官方未明确;按公共参数文档和接口实际要求处理

Endpoint

/openapi/music/song/simulation/get

摘要

获取相似歌曲(新) 获取相似歌曲(新) /openapi/music/song/simulation/get 需申请接口组:开放平台专区能力 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 参数名 必选 类型 说明 songId 是 String 歌曲id limit 否 Int 数量,非必传 默认1,不要超过30 请求示例: 返回参数说明 Records参数(列表) 参数名 类型 说明 ...

bizContent / 请求参数

表 1
参数名必选类型说明
songIdString歌曲id
limitInt数量,非必传 默认1,不要超过30
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 2 行见官方文档
#21

心动模式

官方 Source
官方分类
推荐-歌曲类API
docId
6e99f4d7cc68445cbbda72ef0c22b528
更新时间
2026-01-21 15:06:10
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/song/play/intelligence/get

摘要

心动模式 心动模式 /openapi/music/basic/song/play/intelligence/get 1.

bizContent / 请求参数

表 1
参数名必选类型说明
playlistIdString红心歌单id
songIdString当前正在播放歌曲(也是fromPlayOne场景下,进行单曲推荐的歌曲)
typeStringfromPlayAll(播放全部的推荐) 或者 fromPlayOne(单曲推荐模式),默认fromPlayAll
countInt数量,默认20,最多150首,播完了也只能在150首内循环
表 2
参数名类型说明
startInt试听开始时间
endInt试听结束时间
表 3
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 4
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
其余 5 行见官方文档
#22

推荐更多歌曲

官方 Source
官方分类
推荐-歌曲类API
docId
c1b71075ac0f42d2bbd9704f23f1f8de
更新时间
2026-04-01 17:38:30
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/more/song

摘要

推荐更多歌曲 推荐更多歌曲 /openapi/music/basic/recommend/more/song 需申请:云音乐推荐能力 根据不同的场景,为用户推送更多的歌曲 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 参数名 类型 是否必填 说明 songIds String 是 上次推荐的歌曲列表 source String 是 来源,算法字段,私人定制:CAR_PAGE_RECOMM...

bizContent / 请求参数

表 1
参数名类型是否必填说明
songIdsString上次推荐的歌曲列表
sourceString来源,算法字段,私人定制:CAR_PAGE_RECOMMEND_PRIVATE_RCMD_SONG
currentPlaySongIdString当前播放的歌曲列表
limitint请求数量,默认12
qualityFlagBoolean是否获取音质列表
extFlagsString保留字段
表 2
参数名类型说明
startInt试听开始时间
endInt试听结束时间
表 3
参数名类型说明
cannotListenReasonInteger不可试听原因
resConsumableBoolean资源维度是否支持全曲试听,全曲试听标记大于0为支持
userConsumableBoolean用户维度是否支持全曲试听
表 4
参数名类型说明
idString艺人Id
nameString艺人名称
coverImgUrlString艺人封面

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
playUrlString播放url
playUrlExpireTimeString播放url到期时间
brint返回的歌曲码率
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
vipFlagboolean是否vip歌曲
freeTrailFlagboolean是否支持片段试听
freeTrailFreeTrail片段试听起止时间,单位:s
freeTrialPrivilegeFreeTrialPrivilegeVO全曲试听
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
gainFloat音频增益
peakFloat音频peak
typeString文件类型
levelString当前返回的歌曲码率对应的level
songSizelong歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<SongArtistVo>艺人集合
fullArtistsList<SongArtistVo>艺人Id
songFeeint歌曲付费类型
其余 8 行见官方文档
#23

获取场景音乐标签

官方 Source
官方分类
推荐-歌曲类API
docId
8e151e88295e46c195c4786ad382cc5f
更新时间
2026-01-23 11:33:14
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/scene/radio/tags/get

摘要

获取场景音乐标签 获取场景音乐标签 /openapi/music/basic/scene/radio/tags/get - 根据特定场景选择音乐,用户可以根据场景或情感类型浏览音乐推荐 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 无 请求示例: 返回参数说明 参数名 类型 说明 tag String 标签 image String 封面 name String 名称 返回示例 { "c...

bizContent / 请求参数

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

关键响应字段

表 1
参数名类型说明
tagString标签
imageString封面
nameString名称
#24

获取场景音乐标签下的歌曲

官方 Source
官方分类
推荐-歌曲类API
docId
4f5e35ad719a46f9bc0b43e81f6e1786
更新时间
2026-01-23 11:33:59
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/scene/radio/get

摘要

获取场景音乐标签下的歌曲 获取场景音乐标签下的歌曲 /openapi/music/basic/scene/radio/get 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 参数名 必选 类型 说明 scene 是 String 场景标签 limit 否 Int 获取数据量(建议3,最多10) withPlayUrl 否 Boolean 是否返回播放URL qualityFlag 否 Bo...

bizContent / 请求参数

表 1
参数名必选类型说明
sceneString场景标签
limitInt获取数据量(建议3,最多10)
withPlayUrlBoolean是否返回播放URL
qualityFlagBoolean是否下发音质

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 2 行见官方文档
#25

私人定制

官方 Source
官方分类
推荐-歌曲类API
docId
a7db4997ab77438cbce63df7a60734e3
更新时间
2026-03-05 14:24:46
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/style/songlist/get

摘要

私人定制 私人定制 /openapi/music/basic/recommend/style/songlist/get 为用户推送更优质的专属歌曲列表 会下发标题,每次请求拿到的列表不一样 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 参数名 必选 类型 说明 limit 否 Int 请求资源数,默认5,最多12首 trialScene 否 String 全曲试听相关,默认null qu...

bizContent / 请求参数

表 1
参数名必选类型说明
limitInt请求资源数,默认5,最多12首
trialSceneString全曲试听相关,默认null
qualityFlagBoolean是否下发音质,默认false
表 2
参数名类型说明
recReasonString推荐理由
表 3
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 4
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
titleString标题
songListVosList< SongListVo>歌曲列表
表 2
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
coverImgUrlString封面url
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
extMapList<String>扩展标签
visibleBoolean是否有版权(true,false)
#26

每日推荐

官方 Source
官方分类
推荐-歌曲类API
docId
6b8a63554d5b4e89a98ee703018c15c2
更新时间
2026-03-20 15:23:24
Method
GET
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/songlist/get/v2

摘要

每日推荐 每日推荐 /openapi/music/basic/recommend/songlist/get/v2 需申请接口组:云音乐推荐能力 需要用户实名登录(匿名也可以,有默认数据) 请求方式: GET 公共参数: IOT公共参数 业务参数(bizContent): 参数名 必选 类型 说明 limit 是 Int 请求数据量(建议30首),最大40 qualityFlag 否 Boolean 是否下发音质 取30到35首歌就行,...

bizContent / 请求参数

表 1
参数名必选类型说明
limitInt请求数据量(建议30首),最大40
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 3
参数名类型说明
idString艺人Id
nameString艺人名称
表 4
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
coverImgUrlString封面url
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
visibleBoolean是否有版权(true,false)

推荐-歌单类API

5 篇
#27

获取推荐歌单列表

官方 Source
官方分类
推荐-歌单类API
docId
9d7ae747fa0246088cdf7ac21cdb7b46
更新时间
2026-01-21 14:55:23
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/playlist/get

摘要

获取推荐歌单列表 获取推荐歌单列表 /openapi/music/basic/recommend/playlist/get 获取到推荐给当前用户的歌单信息,需要用户匿名或实名登录 - 有运营位,可配置指定歌单在推荐页首页位置,联系云音乐同事 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 参数名 必选 类型 说明 limit 是 Int 请求数据量,建议30 offset 是 Int 偏移...

bizContent / 请求参数

表 1
参数名必选类型说明
limitInt请求数据量,建议30
offsetInt偏移量

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
createTimelong创建时间(时间戳)
subedboolean是否收藏
#28

获取雷达歌单

官方 Source
官方分类
推荐-歌单类API
docId
7be7ab491ae04c299584d88ad1ba4e55
更新时间
2026-01-21 14:56:18
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/playlist/radar/get

摘要

获取雷达歌单 获取雷达歌单 /openapi/music/basic/playlist/radar/get 雷达歌单介绍 - 全新的歌曲推荐功能,可以基于历史口味和实时偏好,为每位用户每天生成一份完全个性化的歌单。

bizContent / 请求参数

表 1
参数名必选类型说明
originalCoverFlagBoolean下发无水印封面,默认false

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
categoryString分类
#29

获取榜单列表

官方 Source
官方分类
推荐-歌单类API
docId
662be3936dc84a28957d547755eca385
更新时间
2026-01-21 14:57:29
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/toplist/get/v2

摘要

获取榜单列表 获取榜单列表 /openapi/music/basic/toplist/get/v2 获取到云音乐榜单列表 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 无 请求示例: 返回参数说明 Records参数(列表) 参数名 类型 说明 id String 歌单Id name String 歌单名称 coverImgUrl String 歌单封面url describe Stri...

bizContent / 请求参数

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

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
createTimelong创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
categoryString分类
updateFrequencystring更新周期
表 2
code说明
200请求正常
400参数错误
500系统错误
表 3
subcode说明
200有返回数据
10007资源不存在
#30

获取banner资源

官方 Source
官方分类
推荐-歌单类API
docId
09ce2cf38edd42deabaa8290de8b1ffc
更新时间
2026-01-27 14:15:14
Method
GET
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/banner/get

摘要

获取banner资源 获取banner资源 /openapi/music/banner/get - 需申请:资源分享能力 - 默认尺寸:1080*420px(这个为主) - 实际大小可以自定义,网易数帆裁剪: - 需要联系云音乐提前配置 请求方式: GET 公共参数: IOT公共参数 业务参数(bizContent): 无 请求示例: 返回参数说明 Records参数(列表) 参数名 类型 说明 image String banner...

bizContent / 请求参数

表 1
参数名类型说明
SONGString歌曲
PLAYLISTString歌单
ALBUMString专辑
ARTISTString艺人
H5StringH5
VIP_PURCHASEString会员购买
PODCASTString播客

关键响应字段

表 1
参数名类型说明
imageStringbanner图片地址
resourceIdString资源id(加密后的)
resourceTypeString资源类型
targetUrlString跳转地址
#31

最近常听

官方 Source
官方分类
推荐-歌单类API
docId
1840785a832d4a9e9bd46620927a215f
更新时间
2026-04-24 15:56:51
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/common/recently/heard/get /openapi/music/basic/private/fm/roaming/song/list /openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/recommend/songlist/get/v2 /openapi/music/basic/recommend/style/songlist/get

摘要

最近常听 最近常听 /openapi/music/common/recently/heard/get 需要用户实名登录 功能介绍 - 可配置歌单、榜单、播单、有声书、每日推荐、私人漫游等 - 时间范围是最近3个月 - 移动端->车端:可直接调该接口,注意:移动端需收听有效资源类型>3 - 车端->移动端:如果需要上报车端常听数据,需要云音乐配置,并在数据回传接口:增加sourceId和sourceType 请求方式: GET/POST...

bizContent / 请求参数

表 1
参数名类型说明
userfmString私人漫游
toplistString榜单
listString歌单
dailySongsString每日推荐
virtualPlaylistString私人推荐
voiceString有声书(暂不支持)
voicelistString播客(暂不支持)
表 2
类型入参对应接口
userfmresourceId私人漫游 /openapi/music/basic/private/fm/roaming/song/list
toplistresourceId榜单 /openapi/music/basic/playlist/song/list/get/v3
listresourceId歌单 /openapi/music/basic/playlist/song/list/get/v3
dailySongs/每日推荐 /openapi/music/basic/recommend/songlist/get/v2
virtualPlaylist/私人定制 /openapi/music/basic/recommend/style/songlist/get

关键响应字段

表 1
参数名类型说明
resourceIdString资源Id(歌曲id、歌单id等)
resourceTypeString资源类型
titleString标题
tagString封面角标
coverUrlListString封面

日推MIX

4 篇
#32

日推mix

官方 Source
官方分类
日推MIX
docId
83c94b535264425b9b0788c18f6b7043
更新时间
2026-06-03 11:35:07
Method
GET/POST
accessToken
按接口要求传匿名或实名 accessToken

Endpoint

/openapi/music/basic/recommend/daily/mix /openapi/music/basic/recommend/songlist/get/v2 /openapi/music/basic/private/fm/roaming/song/list /openapi/music/basic/playlist/song/list/get/v3 /openapi/music/basic/song/daily/style/get /openapi/music/basic/song/play/intelligence/get

摘要

日推mix 日推mix /openapi/music/basic/recommend/daily/mix 根据用户听歌喜好,推荐主体场景,默认前两个是日推和私人漫游,兜底6个卡片 请求方式: GET/POST 公共参数: IOT公共参数 业务参数(bizContent): 暂无 请求示例: 返回参数说明 blocks(列表) 参数名 类型 说明 title String 标题 subTitle String 主题模块名 simplif...

bizContent / 请求参数

表 1
参数名类型说明
urlString图片地址
onImageIconUrlString附加在图上的图标
表 2
资源类型模块对应接口
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
表 3
参数名类型说明
playlistString红心歌单
songIdString心动歌曲
tagIdString标签id
categoryIdString分类id

关键响应字段

表 1
参数名类型说明
titleString标题
subTitleString主题模块名
simplifiedTitleString简要描述
imageInfoImageVO封面信息
resourceIdString资源id
resourceTypeString资源类型,见下方枚举
extDataList额外信息
#33

获取相似歌曲-歌曲列表(日推mix)

官方 Source
官方分类
日推MIX
docId
4f7214fbb2534c69aad759095283d108
更新时间
2025-12-26 17:17:49
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...

bizContent / 请求参数

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

关键响应字段

表 1
参数名类型必填说明
typeStringmode
codeStringSIMILAR
sourceTypeStringsong
sourceIdsString歌曲id,/openapi/music/basic/recommend/daily/mix返回的song_fm中歌曲id
limitint获取推荐歌曲数量,需<10 ,默认3
unplaySongIdsJSON String推荐但未播放的歌曲列表,例如:["445A8B860CC9CEA34A2A6082AACE1595"]
#34

获取风格日推-歌曲列表(日推mix)

官方 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
参数名类型说明
startInt试听开始时间
endInt试听结束时间
表 2
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 3
参数名类型说明
idString艺人Id
nameString艺人名称
表 4
音质比特率
dobly杜比
hireshires1999
lossless无损999
exhigh极高320
higher较高192
standard标准128
none不能播放/下载0

关键响应字段

表 1
参数名必选类型说明
categoryIdLong分类id ,/openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中categoryId
tagIdString标签id /openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中tagId
songIdString歌曲id,/openapi/music/basic/recommend/daily/mix返回的tag_daily_rec中resourceId
limitInt请求的数据量,默认30
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比: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
参数名类型必填说明
typeStringmode
codeStringSIMILAR
sourceTypeStringartist
sourceIdsString艺人id,/openapi/music/basic/recommend/daily/mix返回的artist_fm中艺人id
limitint获取推荐歌曲数量,需<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
参数名类型说明
codeStringcode,接口(/openapi/music/basic/private/fm/roaming/song/list)入参
titleString标题,eg:默认模式
subTitleString副标题/描述,eg:沿着目前喜好继续聆听

关键响应字段

表 1
参数名类型说明
categoryListList<PrivateRoamingCategory>目录列表
表 2
参数名类型说明
typeStringtype,接口(/openapi/music/basic/private/fm/roaming/song/list)入参
detailListList<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
参数名类型必填说明
typeStringtype,来自/openapi/music/basic/private/fm/roaming/category
codeStringcode,来自/openapi/music/basic/private/fm/roaming/category
limitint获取推荐歌曲数量,固定每次取3
withPlayUrlboolean否(默认false)是否一并获取播放链接(可能获取失败)
unplaySongIdsJSON 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
参数名必选类型说明
limitInt请求数据量,固定3
filterSongDurationMinuteLong过滤歌曲的时长(大于等于该时长的歌曲将不会返回)
sceneString漫游场景,游戏必传,固定值:unisdk
qualityFlagBoolean是否下发音质
withPlayUrlBoolean是否下发播放地址
表 2
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
playUrlString播放url
brint返回的歌曲码率
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
mvIdStringmvId
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
songMaxBrint歌曲原本的最大码率
userMaxBrint用户能播放的最大码率
songSizeint歌曲的大小
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
likedboolean是否喜欢
songFeeint歌曲付费类型
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
algString算法推荐使用,播放数据上报接口需透传该字段
qualitiesList<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
参数名类型说明
idString标签Id
nameString标签名称
categoryint标签种类
#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
参数名必选类型说明
tagString标签名称
limitInteger请求个数,默认值10,建议30
offsetInteger请求偏移,默认值0

关键响应字段

表 1
参数名类型说明
hasMoreBoolean是否有更多
recordsList<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
参数名类型说明
idString标签Id
nameString标签名称
categoryint标签种类

查询歌单及歌曲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
参数名必选类型说明
playlistIdstring歌单Id
originalCoverFlagBoolean是否使用原始封面(无水印,华语私人雷达第一首歌封面),默认:false
newCoverFlagBoolean是否获取原始新封面(左下角文字和右上角logo),默认:false

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
creatorAvatarUrlString创建者头像
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
trackUpdateTimelong最近更新时间
表 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
参数名必选类型说明
playlistIdsList<String>歌曲Id列表,序列化成json String;限制为500个Id及以下

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 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
参数名必选类型说明
playlistIdString歌单Id
limitInt获取数据量(最多500条),建议每次取30条
offsetInt偏移量
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
dolbyMusiclong杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 3
参数名类型说明
idString艺人Id
nameString艺人名称
表 4
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
coverImgUrlString封面url
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesint支持的音质列表
visibleBoolean是否有版权(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
参数名必选类型说明
songIdString歌曲Id
表 2
参数名类型说明
sizeLong歌曲大小
extensionString音频格式
bitrateLong比特率
playTimeLong歌曲时长
vipTypesList需要的会员类型
表 3
参数名类型说明
vipLong车端会员(之前的各端会员)
blackvipLong黑胶vip
svipLong黑胶svip

关键响应字段

表 1
参数名类型说明
vividMusicStringAudio Vivid
dolbyMusicString杜比全景声
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
#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
参数名类型说明
cannotListenReasonint是否支持试听,0:支持,null:不支持
resConsumableboolean该场景是否支持试听
userConsumableboolean该用户是否支持试听
表 3
参数名类型说明
sourceTypestring资源类型(歌单固定传playlist)
sourceIdstring资源ID(对应上游的playlistid)

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
freeTrialPrivilegeList<String>是否支持全曲试听
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
其余 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
参数名必选类型说明
songIdListList<String>歌曲Id列表,序列化成json String;限制为500个Id及以下
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
idString专辑Id
nameString专辑名称
表 4
音质比特率
dobly杜比
hireshires1999
lossless无损999
exhigh极高320
higher较高192
standard标准128
none不能播放/下载0

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
visibleBoolean是否有版权(true,false)
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
coverImgUrlString封面url
artistsList<Artist>艺人列表
albumAlbum专辑信息
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
privateCloudSongboolean是否云盘歌曲
songFeeint歌曲付费类型
likedboolean是否喜欢
audioFlagint是否有杜比: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
参数名必选类型说明
songIdstring歌曲Id

关键响应字段

表 1
参数名类型说明
songIdString歌曲id
lyricString原版歌词内容(逐行歌词)
noLyricBoolean歌曲是否本身无歌词,true无歌词(纯音乐)、false有歌词
transLyricString翻译歌词
txtLyricString非滚动歌词
#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
参数名必选类型说明
songIdString歌曲Id
表 2
参数名类型说明
sizeLong歌曲大小
extensionString音频格式
bitrateLong比特率
playTimeLong歌曲时长
md5String文件md5
levelString音质
iconListList<QualityIconDetailVO>音质图标列表
sqPrivilegeSongQualitySpVO音质权限信息
表 3
参数名类型说明
iconUrlStringicon地址
iconTypeStringicon类型
iconTypeInteger
heightInteger
表 4
参数名类型说明
playFlagBoolean该音质用户是否可播
canPlayVipsList<String>可播放的会员身份,该字段主要用于展示icon,客户端可挑选当前端支持的会员身份展示icon

关键响应字段

表 1
参数名类型说明
vividMusicMusicQualityDataVOAudio Vivid
dolbyMusicMusicQualityDataVO杜比全景声
skMusicMusicQualityDataVO沉浸环绕声
jyMasterMusicMusicQualityDataVO超清母带
jyEffectMusicMusicQualityDataVO高清臻音
hrMusicMusicQualityDataVOhi-res
sqMusicMusicQualityDataVO无损
hmusicMusicQualityDataVO极高
mmusicMusicQualityDataVO较高
lmusicMusicQualityDataVO标准
#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
参数名必选类型说明
songIdString歌曲id
表 2
参数名类型说明
startLong逐行开始时间,单位:ms
durationLong持续时间,单位:ms
wordsList<YrcWordVO>>歌词信息
表 3
参数名类型说明
suspendLong逐字开始时间,单位:ms
durationLong持续时间,单位:ms
wordsString歌词

关键响应字段

表 1
参数名类型说明
lyricsList<WordByWordLyricVO>逐字歌词
ytlrcsString翻译歌词lrc格式,时间轴对齐yrc
lrcString逐行歌词
tlyricString逐行翻译歌词
#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
参数名必选类型说明
songIdString歌曲Id
withUrlBoolean是否需要播放url
bitrateInt播放ur的l码率:128(标准)、320(极高)、999(无损)、1999(Hi-Res)。默认获取用户可收听的最大码率(目前默认值最大无损)
effectsString支持杜比的音效:eac3(车载用这个)、ac4
qualityFlagBoolean是否下发音质
levelString高品质(都需要配置):vivid(臻音全景声,该音质需要单独配置)、sky(沉浸环绕声)、jymaster(超清母带)、jyeffect(高清臻音),拿不到会自动降级
immerseTypeStringsky必传,支持的沉浸声环绕声类型:c51(c51类型)、ste(环绕立体声类型)、aac(aac类型)
languageFlagBoolean是否返回语种,默认false
extFlagsString是否获取高品质音源,固定值:{"hqScene":"normal"};是否获取副歌起止点固定值:{"chorusFlag":true}
表 2
参数名类型说明
startTimeLong副歌开始时间,单位:毫秒
endTimeLong副歌结束时间,单位:毫秒
表 3
参数名类型说明
startInt试听开始时间
endInt试听结束时间
表 4
参数名类型说明
cannotListenReasonInteger不可试听原因
resConsumableBoolean资源维度是否支持全曲试听,全曲试听标记大于0为支持
userConsumableBoolean用户维度是否支持全曲试听

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
playUrlString播放url
playUrlExpireTimeString播放url到期时间
brint返回的歌曲码率
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
vipFlagboolean是否vip歌曲
freeTrailFlagboolean是否支持片段试听
freeTrailFreeTrail片段试听起止时间,单位:s
freeTrialPrivilegeFreeTrialPrivilegeVO全曲试听
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
gainFloat音频增益
peakFloat音频peak
typeString文件类型
levelString当前返回的歌曲码率对应的level
songSizelong歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<SongArtistVo>艺人集合
fullArtistsList<SongArtistVo>艺人Id
songFeeint歌曲付费类型
其余 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
参数名必选类型说明
songIdstring歌曲Id
bitrateInt比特率:128(标准)、192(较高)、320(极高)、999(无损)、1999(Hi-Res)。默认320,若不能返回指定比特率则会返回较低的一个
effectsstring支持杜比的音效:eac3、ac4
levelString高品质:vivid(臻音全景声,该音质需要单独配置)、sky(沉浸环绕声)、jymaster(超清母带)、jyeffect(高清臻音),拿不到会自动降级
immerseTypeString支持的沉浸声环绕声类型:c51(c51类型)、ste(环绕立体声类型)、aac(aac类型)
表 2
参数名类型说明
startInt试听开始时间
endInt试听结束时间

关键响应字段

表 1
参数名类型说明
urlString歌曲播放url
sizeInt歌曲大小
md5String歌曲的MD5
brInt返回的歌曲码率
effectsString音效(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
levelString当前返回的歌曲码率对应的level
freeTrailFreeTrail试听起止时间,单位: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
参数名必选类型说明
songIdsList<String>歌曲Id列表,序列化成json String;限制为500个Id及以下
bitrateInt比特率:128(标准)、320(极高)、999(无损)、1999(Hi-Res)。默认320,若不能返回指定比特率则会返回较低的一个
effectsstring支持杜比的音效:eac3、ac4
表 2
参数名类型说明
startInt试听开始时间
endInt试听结束时间

关键响应字段

表 1
参数名类型说明
urlString歌曲播放url
sizeInt歌曲大小
md5String歌曲的MD5
brInt返回的歌曲码率
effectsString音效(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
levelString当前返回的歌曲码率对应的level
freeTrailFreeTrail试听起止时间,单位:s
表 2
音质比特率
vividAudio Vivid
dobly杜比
sky沉浸环绕声
jymaster超清母带待定
jyeffect高清臻音
hireshires1999
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
参数名必选类型说明
songIdString歌曲id

关键响应字段

表 1
参数名类型说明
messageString歌曲无法获取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
参数名必选类型说明
needSumBoolean是否需要总数

关键响应字段

表 1
参数名类型说明
downSumLong已下载总数
downCountLong当前周期内已下载数量
downLimitLong下载额度上限,如果要计算剩余额度,可以用 downLimit- downCount
startTimeLong当前周期-生效开始时间
endTimeLong当前周期-生效结束时间
#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
参数名必选类型说明
songIdString歌曲id

关键响应字段

表 1
参数名类型说明
messageStringtoast文案
#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
参数名必选类型说明
songIdString歌曲Id
bitrateInt比特率:128(标准)、320(极高)、999(无损)、1999(Hi-Res)

关键响应字段

表 1
参数名类型说明
urlString歌曲下载url
playUrlExpireTimeLongurl失效时间
sizeString歌曲大小
md5String歌曲的MD5
brint比特率
effectsString音效(目前仅杜比才有)
privateCloudSongBoolean是否为云盘歌曲
levelString播放链接实际档位
freeTrailFreeTrail试听起止时间,单位:s
durationLong歌曲时长
表 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
参数名必选类型说明
chartCodeString榜单code
limitInt获取数据量(最多20条)

关键响应字段

表 1
参数名类型说明
iconTypeinticon类型
rankint排行
searchWordString搜索词
表 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
参数名必选类型说明
limitInt获取数据量

关键响应字段

表 1
参数名类型说明
keywordString热词
#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
参数名必选类型说明
keywordString搜索词

关键响应字段

表 1
参数名类型说明
suggestsList<SuggestKeyword>提示词列表
recsList<SuggestKeyword>推荐词列表
表 2
参数名类型说明
keywordString提示词
highLightInfoString高亮信息
iconUrlString提示词前 icon 图片地址
tagUrlString提示词后标签图片地址
resourceTypeString提示词对应资源类型
resourceIdString提示词对应资源 id
resourceNameString提示词对应实际资源名称
showTextString提示词对应资源展示名称
#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
参数名类型说明
resourceTypeString资源类型
resourceobject资源详情
表 2
枚举值资源类型
bestmatch最佳匹配
song歌曲
playlist歌单
voicelist播单
album专辑
artist艺人
表 3
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
fullArtistsList<Artist>全部艺人列表(包含已下线)
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString歌曲封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
originCoverTypeInt原唱字段
visibleBoolean是否有版权(true,false)
表 4
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
creatorAvatarUrlString创建者头像
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
trackUpdateTimelong最近更新时间

关键响应字段

表 1
参数名必选类型说明
keywordString搜索关键字
qualityFlagBoolean是否下发音质
identityFlagBoolean是否组装艺人身份标签,默认false
subCountFlagBoolean是否组装粉丝数,默认false
表 2
参数名类型说明
bestMatchResourcesList<MixResourceVO>最佳匹配资源
bestMatchResourceTypesList<String>最佳匹配资源类型
songsList<SongListVo>歌曲列表
artistsList<ArtistVo>艺人列表
albumsList<AlbumDetailVo>专辑列表
playlistsList<PlaylistVo>歌单列表
voicelistList<PodcastDetailDTO>播单列表
表 3
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
genreString风格流派
artistsList<Artist>歌手信息
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
#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
参数名必选类型说明
keywordString搜索关键字
limitInt获取数据量
offsetInt偏移量
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
0Int状态未知
1Int原唱
2Int翻唱
表 3
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 4
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
fullArtistsList<Artist>全部艺人列表(包含已下线)
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString歌曲封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
originCoverTypeInt原唱字段
visibleBoolean是否有版权(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
参数名必选类型说明
keywordString搜索关键字
limitInt获取数据量(最多300,建议100以内)
offsetInt偏移量
表 2
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
genreString风格流派
artistsList<Artist>歌手信息
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
#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
参数名必选类型说明
keywordString搜索关键字
limitInt获取数据量
offsetInt偏移量
identityFlagBoolean是否组装艺人身份标签,默认false
subCountFlagBoolean是否组装粉丝数,默认false
表 2
参数名类型说明
userTypeInt身份type
showNameString身份名
表 3
参数名类型说明
roleIdLong身份id
roleNameString身份名称

关键响应字段

表 1
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
nationalityString国家/地区
musicSizeInt歌曲数量
#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
参数名必选类型说明
tagString标签
limitInt一页数据量(最多500条),别拿太多
offsetInt偏移量

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
creatorAvatarUrlString创建者头像
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
trackUpdateTimelong最近更新时间
#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
参数名必选类型说明
keywordString搜索关键字
limitInt获取数据量
offsetInt偏移量
表 2
参数名类型说明
0Int状态未知
1Int原唱
2Int翻唱
表 3
参数名类型说明
idString艺人Id
nameString艺人名称
表 4
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
originCoverTypeInt原唱字段
visibleBoolean是否有版权(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
参数名必选类型说明
songNameString歌曲名称
artistNameString艺人名称
limitint一页数据量(最多500条)
offsetint偏移量
表 2
参数名类型说明
0Int状态未知
1Int原唱
2Int翻唱
表 3
参数名类型说明
idString艺人Id
nameString艺人名称
表 4
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
originCoverTypeInt原唱字段
visibleBoolean是否有版权(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
参数名必选类型说明
albumNameString专辑名
artistNameString艺人名
limitInt获取数据量(不要超过300,建议100以内)
offsetInt偏移量
表 2
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
genreString风格流派
artistsList<Artist>歌手信息
companyString发行公司
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
#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
参数名必选类型说明
keywordString搜索关键字
limitInt获取数据量
offsetInt偏移量

关键响应字段

表 1
参数名类型说明
recordCountInt歌单数量
recordsList<record>歌单列表
表 2
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
creatorAvatarUrlString创建者头像
playCountString播放量
subscribedCountInt收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
trackUpdateTimelong最近更新时间

语音搜索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
参数名必选类型说明
mediaNameString搜索内容(只能是槽值),eg:刘德华忘情水、快乐,不能是“快乐的”
mediaTypeString用mediaType区分资源类型,枚举如下
artistNameString艺人(不知道不传)
albumNameString专辑(不知道不传)
sortOrderString资源按时间排序,比如新歌、新专辑用1
表 2
参数名类型说明
idString歌曲Id
originalIdLong原始id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString歌曲封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
visibleBoolean是否有版权(true,false)
表 3
参数名类型说明
idString声音Id
originalIdlong原始声音id
radioIdString播单id
originalRadioIdlong原始播单id
createTimelong创建时间(时间戳)
coverUrlString声音封面url
nameString声音名称
descriptionString描述
trackIdString音频Id,用来获取播放地址(已废弃,最好别用)
durationlong声音时长,单位:毫秒
playCountlong播放次数
feesList<FeeVO>付费信息,详见播客付费功能
feeActivityVoiceFeeActivityVO付费活动,详见播客付费功能
djNameString播单作者
表 4
参数名类型说明
idString歌单Id
originalIdLong原始歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
trackUpdateTimeLong歌曲变更时间
creatorAvatarUrlString头像
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型

关键响应字段

表 1
参数名类型说明
0String开放泛词(默认)
1String歌曲
2String专辑
3String艺人
5String歌单
表 2
参数名类型说明
albumsList<AlbumDetailVo>专辑列表
songsList<SongListVo>歌曲列表
voicesList<VoiceDetailVO>声音列表
playlistsList<PlaylistVo>歌单列表
resTypesList<String>返回类型列表
tipsList<SiriTipsVO>提示
表 3
参数名类型说明
idString专辑Id
originalIdLong原始id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
genreString风格流派
artistsList<Artist>歌手信息
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
#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
参数名必选类型说明
contentString语音原文

关键响应字段

表 1
参数名类型说明
responseString推荐语
songsList<SongVo>歌曲列表
表 2
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
fullArtistsList<Artist>全部艺人列表(包含已下线)
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
coverImgUrlString歌曲封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesList<String>支持的音质列表
originCoverTypeInt原唱字段
visibleBoolean是否有版权(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
参数名必选类型说明
limitInt查询条数,默认100条
表 2
参数名类型说明
osString来源

关键响应字段

表 1
参数名类型说明
recordsList<record>歌单列表
playTimeString最近一次播放时间
表 2
参数名类型说明
idString歌单Id
nameString歌单名称
coverImgUrlString歌单封面url
describeString歌单描述
creatorNickNameString创建者昵称
creatorAvatarUrlString创建者头像
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
trackUpdateTimelong最近更新时间
extMapextMapVo补充信息
#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
参数名必选类型说明
limitInt查询条数,默认100条
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
osString来源

关键响应字段

表 1
参数名类型说明
recordsList<record>歌单列表
playTimeString最近一次播放时间
表 2
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>歌手信息
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
extMapextMapVo补充信息
#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
参数名必选类型说明
typeInt0:查总排行,1:查周排行
offsetInt偏移量
limitInt获取的数据量
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagbooleanvip标识,需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放(不要用)
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
gainFloat音频增益
peakFloat音频peak
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
其余 10 行见官方文档

关键响应字段

表 1
参数名类型说明
playCountString播放次数
scoreString分数
songsongVo歌曲
#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
参数名必选类型说明
limitInt获取数量,默认10
表 2
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 3
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
genreString风格流派
artistsList<Artist>歌手信息
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
表 4
参数名类型说明
nameString名称
playCountString播放数量
coverImgUrlString封面

关键响应字段

表 1
参数名类型说明
playlistString歌单
albumString专辑
songRankString听歌排行
#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
参数名必选类型说明
limitInt查询条数,默认300条
qualityFlagBoolean是否下发音质

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 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
参数名必选类型说明
offsetInt偏移量,默认0
limitInt数据量,默认10
qualityFlagBoolean是否下发音质,默认false
表 2
参数名类型说明
startInt试听开始时间
endInt试听结束时间
表 3
参数名类型说明
dolbyMusicString杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准
表 4
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比: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
参数名必选类型说明
offsetint偏移量
limitint数据量
表 2
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>歌手信息
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
#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
参数名必选类型说明
offsetInt偏移量
limitInt一页数据量(最多500条)
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
likedboolean是否喜欢
coverImgUrlString歌曲封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
privateCloudSongBoolean是否云盘歌曲
songTagList<String>歌曲的曲风标签
algString算法推荐使用,播放数据上报接口需透传该字段
songFeeint歌曲付费类型
qualitiesint支持的音质列表
visibleBoolean是否有版权(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
参数名必选类型说明
idSting当前资源id, 例如:歌曲的id,声音的id或者encVoiceId
actionString行为,startplay:开始播放
bitrateInt码率,单位/kbps。song传实际播放码率,128:标准,320:极高,999:无损,1999:hires,高清臻音:3999,超清母带:4999,沉浸环绕声:4099,杜比全景声:2999,臻音全景声(vivid):5999,播客固定传128
fileInt文件类型回传枚举值:0:下载文件, 1:本地文件, 2:缓存文件, 3:云盘文件, 4:线上文件。不清楚填4
typeSting类型,song:歌曲, dj:播客
startLogTimeLong开始播放时的时间戳,单位:毫秒
algSting算法使用,私人漫游、每日推荐和场景音乐已返回该字段,产生播放时需透传alg(其余场景可参考下方,也可不传)
isAuditionInt试听类型,1:片段试听(固定传1),2:全曲试听
auditionStartInt试听片段开始时间点(从上游接口取,不同用户不一样),单位/s
auditionEndInt试听片段结束时间点(从上游接口取,不同用户不一样),单位/s
sourceIdSting播放来源资源ID(最近常听必传)
sourceTypeSting播放来源资源类型(最近常听必传)
categoryIdLong播客categoryId
openApiTraceInfoString全曲试听播放时需透传该字段(播放地址相关接口会下发)
extString设备唯一识别码,游戏必传,ios传idfa,android传oaid,eg:{"idfa":"abc"}或{"oaid":"def"}
表 2
参数名必选类型说明
idSting当前资源id, 例如:歌曲的id,声音的id或者encVoiceId
actionString行为,play:结束播放
bitrateInt码率,单位/kbps。song传实际播放码率,128:标准,320:极高,999:无损,1999:hires,高清臻音:3999,超清母带:4999,沉浸环绕声:4099,杜比全景声:2999,臻音全景声(vivid):5999,播客固定传128
fileInt文件类型回传枚举值:0:下载文件, 1:本地文件, 2:缓存文件, 3:云盘文件, 4:线上文件。不清楚填4
typeSting类型,song:歌曲, dj:播客
startLogTimelong开始播放时的时间戳,单位:毫秒
timedouble播放时长,单位:秒, 播放完成或者中止播放时的时长,按照实际播放时长统计,不包含暂停,不能超过歌曲总时长
endSting结束方式回传枚举值:playend:正常结束(歌曲播放到结尾自然结束;系统自动触发上报);interrupt:第三方APP打断(第三方应用抢占音频焦点;系统通知或电话等打断播放); exception:错误(网络错误导致播放失败;歌曲文件损坏;其他技术异常); ui: 用户切歌(用户主动切换到下一首/上一首;用户切换播放列表;用户点击指定歌曲播放;用户暂停播放)。不清楚填playend
algSting算法使用,私人漫游、每日推荐和场景音乐已返回该字段,产生播放时需透传alg(其余场景可参考下方,也可不传)
isAuditionInt试听类型,1:片段试听(固定传1),2:全曲试听
auditionStartInt试听片段开始时间偏移(从上游接口取,不同用户不一样),单位/s
auditionEndInt试听片段时间偏移(从上游接口取,不同用户不一样),单位/s
sourceIdSting播放来源资源ID(最近常听必传)
sourceTypeSting播放来源资源类型(最近常听必传)
categoryIdLong播客categoryId
openApiTraceInfoString全曲试听播放时需透传该字段(播放地址相关接口会下发)
extString设备唯一识别码,游戏必传,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
参数名类型说明
nameStringTab名
tabStringtab

关键响应字段

表 1
参数名类型说明
areaTabListList<ArtistZoneTabDetailVO>tab信息
bandTabListList<ArtistZoneTabDetailVO>乐队组合形式,男/女/乐队
表 2
参数名类型说明
nameStringTab名
tabStringtab
#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
参数名必选类型说明
areaTabString艺人tab信息,默认chinese
bandTabString乐队信息,默认female
limitint获取数量,默认10
offsetint偏移量,默认0

关键响应字段

表 1
参数名类型说明
artistsList<ArtistVo>艺人列表
hasMoreboolean是否有下一页
表 2
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
musicSizeInt歌曲数量
#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
参数名必选类型说明
limitInt获取数据量
offsetInt偏移量

关键响应字段

表 1
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(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
参数名必选类型说明
artistIdString艺人id
extFlagBoolean艺人简介信息
personalFlagBoolean艺人信息,地区、年龄之类
creatorRoleFlagBoolean艺人身份
subCountFlagBoolean是否获取艺人粉丝数
identityFlagBoolean用户标签 需要是入驻艺人才会有,比如林俊杰现在就没这个数据,但查艺人身份就有(该参数可不用)
表 2
参数名类型说明
userTypeInt身份type
showNameString身份名
表 3
参数名类型说明
roleIdLong身份id
roleNameString身份名称

关键响应字段

表 1
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
nationalityString国家/地区
musicSizeInt歌曲数量
#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
参数名必选类型说明
artistIdsString艺人list
identityFlagBoolean是否需要身份信息,默认false

关键响应字段

表 1
参数名类型说明
idString艺人Id
nameString艺人名称
transNameString艺人别名
coverImgUrlString艺人封面
typeInt艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
nationalityString国家/地区
musicSizeInt歌曲数量
#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
参数名必选类型说明
artistIdString艺人id
typeInt1 热门作品 2 作词作品 3 作曲作品,默认1
limitInt一页数据量(最多获取前500首),默认10
offsetInt偏移量,默认0
qualityFlagBoolean是否下发音质

关键响应字段

表 1
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false),已失效
payDownloadFlagBoolean是否需要付费才能下载(true、false),已失效
vipFlagbooleanvip标识,需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放(不要用)
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
gainFloat音频增益
peakFloat音频峰值
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
其余 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
参数名类型说明
idString艺人Id
nameString艺人名称
表 2
参数名类型说明
idString专辑Id
nameString专辑名称
表 3
参数名类型说明
dolbyMusiclong杜比
skMusicString沉浸环绕声
jyMasterMusicString超清母带
jyEffectMusicString高清臻音
hrMusicStringhi-res
sqMusicString无损
hmusicString极高
mmusicString较高
lmusicString标准

关键响应字段

表 1
参数名必选类型说明
artistsIdString艺人id
topInt前N首歌(最多获取前60首)
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
coverImgUrlString封面url
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率
userMaxBrint用户能播放的最大码率
maxBrLevelString歌曲码率对应的level
plLevelString用户播放歌曲码率对应的level
dlLevelString用户下载歌曲码率对应的level
songTagList<String>歌曲的曲风标签
visibleBoolean是否有版权(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
参数名必选类型说明
artistIdString艺人id
sortTypeString排序依据:"pubTime":发行时间,"score":热度
limitInt获取数据量
offsetInt偏移量
表 2
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>歌手信息
briefDescString简要描述
descriptionString详细描述
publishTimeLong发行时间
subedBoolean是否收藏
表 3
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
pageString分页信息
recordsList<Album>专辑列表
表 2
参数名类型说明
currentInt当前页码
sizeInt获取的记录数
recordCountInt总的记录数
totalInt总页码数
#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
参数名必选类型说明
typeInt艺人类型(1华语、欧美、3韩国、4日本)
表 2
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
nationalityString国家/地区
musicSizeInt歌曲数量
#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
参数名必选类型说明
areaIdInt艺人类型(0:其它, 7:华语, 24:日韩, 96:欧美, -1:全部)
genderInt1:男, 2:女, 3:组合, -1全部
表 2
参数名类型说明
idString艺人id
nameString艺人名称
transNameString别名
coverImgUrlString封面
typeint艺人类型(3:乐队组合, 1:男歌手, 2:女歌手)
authMusicianVBoolean大V认证
identityList<IdentityVO>身份
rolesList<ExpertIdentityTypeVO>艺人角色信息
subCountLong粉丝数
briefDescString简要描述
nationalityString国家/地区
musicSizeInt歌曲数量

专辑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
参数名必选类型说明
albumIdString专辑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
参数名必选类型说明
albumIdString专辑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
参数名必选类型说明
albumIdString专辑id
descFlagBoolean是否需要专辑介绍
表 2
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
genreString风格流派
artistsList<Artist>歌手信息
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏
#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
参数名必选类型说明
albumIdString专辑id
limitInt获取数据量
offsetInt偏移量
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
pagePage分页信息
recordsList<SongVO>歌曲信息
表 2
参数名类型说明
currentInteger当前页面
sizeInteger每页数量
recordCountInteger记录总条数
totalInteger每页数量
cursorString游标,默认返回本页列表最后一条数据的游标值,举例: 用户列表分页查询场景,使用userId作为游标; 假设本次查询结果中返回的userId列表按顺序分别为:[1001,1002,1003,1004,1005] 则游标可以为为1005
表 3
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
freeTrailFlagboolean是否支持试听
coverImgUrlString封面url
artistsList<Artist>艺人列表
albumAlbum专辑信息
visibleBoolean是否有版权(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
参数名必选类型说明
albumIdString专辑id
qualityFlagBoolean是否下发音质
表 2
参数名类型说明
idString艺人Id
nameString艺人名称
表 3
参数名类型说明
idString专辑Id
nameString专辑名称

关键响应字段

表 1
参数名类型说明
idString歌曲Id
nameString歌曲名称
durationlong时长
artistsList<Artist>艺人列表
albumAlbum专辑信息
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
likedboolean是否喜欢
coverImgUrlString封面url
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songTagList<String>歌曲的曲风标签
privateCloudSongboolean是否云盘歌曲
visibleBoolean是否有版权(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
参数名必选类型说明
offsetint偏移量
limitint一页数据量(最多500条)
表 2
参数名类型说明
idString艺人Id
nameString艺人名称

关键响应字段

表 1
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString封面
companyString发行公司
genreString风格流派
artistsList<Artist>歌手信息
transNameString中文翻译名
aliaNameString别名
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间
subedBoolean是否收藏

高品质专区

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
参数名必选类型说明
pageCodestring页面code
表 2
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型

关键响应字段

表 1
参数名类型说明
pageCodeString页面code
styleString模块展示样式
positionCodeString位置信息
titleString模块标题
resourcesList<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
参数名必选类型说明
pageCodestring页面code
表 2
参数名类型说明
resourceTypeString资源类型
resList<BANNER/PLAYLIST/SONG>资源内容
表 3
参数名类型说明
BANNERStringbanner
PLAYLISTString歌单
SONGString歌曲
表 4
参数名类型说明
idString资源id(对应的跳转类型及资源)
resourceTypeString/
backgroundString背景图

关键响应字段

表 1
参数名类型说明
styleString模块展示样式
positionCodeString位置信息
titleString模块标题
resourcesList<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
参数名必选类型说明
codestring页面code
supportVividBoolean是否获取vivid内容,需要单独配置
表 2
参数名类型说明
resourceTypeString资源类型
resList<BANNER/PLAYLIST/SONG>资源内容
表 3
参数名类型说明
BANNERStringbanner
PLAYLISTString歌单
SONGString歌曲
表 4
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型

关键响应字段

表 1
参数名类型说明
pageCodeString父位置
relationIdString关系id
styleString模块展示样式
positionCodeString子位置
titleString模块标题
resourcesList<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
参数名类型说明
resourceTypeString资源类型,歌单/歌曲/专辑
resString对应资源信息
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
songFeeint歌曲付费类型
visibleBoolean是否有版权(true,false)
表 3
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 4
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString专辑封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>艺人列表
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间

关键响应字段

表 1
参数名类型说明
styleString模块展示样式
positionCodeString位置信息
titleString模块标题
resourcesList<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
参数名必选类型说明
resourceTypesList<String>枚举类型:song、playlist、album
withUrlBoolean是否需要播放url(默认为true)
bitrateInt播放ur的l码率(默认320)
effectsString支持杜比的音效:eac3、ac4(默认ac4)
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
songFeeint歌曲付费类型
visibleBoolean是否有版权(true,false)
表 3
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 4
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString专辑封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>艺人列表
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间

关键响应字段

表 1
参数名类型说明
categoryString分类标题
songDetailVoListList<songDetailVo>歌曲
playlistDetailVoListList<playlistDetailVo>歌单
albumDetailVoListList<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
参数名必选类型说明
resourceTypesList<String>枚举类型:song、playlist、album
withUrlBoolean是否需要播放url(默认为true)
bitrateInt播放ur的l码率:固定传1999(默认320)
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
songFeeint歌曲付费类型
visibleBoolean是否有版权(true,false)
表 3
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 4
参数名类型说明
idString专辑Id
nameString专辑名
languageString专辑语种
coverImgUrlString专辑封面
companyString发行公司
transNameString中文翻译名
aliaNameString别名
genreString风格流派
artistsList<Artist>艺人列表
briefDescString简要描述
descriptionString详细描述
publishTimeString发行时间

关键响应字段

表 1
参数名类型说明
categoryString分类标题
songDetailVoListList<songDetailVo>歌曲
playlistDetailVoListList<playlistDetailVo>歌单
albumDetailVoListList<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
参数名必选类型说明
pageCodestring页面code
cursorstring游标(首次传空,下一次的cursor是上次请求结果中返回的cursor)
blockCodeOrderListstring子页面code列表(首次传空,下一次的blockCodeOrderList是上次请求结果中返回的blockCodeOrderList)
closeRcmdstring拒绝推荐code
extJsonstring额外信息
表 2
参数名类型说明
positionCodeString位置code
channelCodeString通道code
resourceTypeString资源类型
resourceresource资源
表 3
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountString播放量
subscribedCountString收藏量
tagsList<String>标签
creatorIdString歌单创建人Id
createTimeString创建时间
subedboolean是否收藏
trackCountint歌单下歌曲总数
specialTypeint歌单类型
表 4
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 2 行见官方文档

关键响应字段

表 1
参数名类型说明
blocksList<BlockDTO>模块展示样式
guideToastString提示
cursorString游标
blockCodeOrderListString子页面code列表
callbackParametersString回带字段
hasMoreBoolean是否还有更多
demoteBoolean是否降级
dinformationString模块标题
#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
参数名必选类型说明
codestring页面code
supportVividBoolean是否获取vivid内容,需要单独配置
表 2
参数名类型说明
resourceTypeString资源类型
resList<resourceType>资源内容
表 3
参数名类型说明
BANNERStringbanner
PLAYLISTString歌单
SONGString歌曲
ALBUMString专辑
LINKString链接
表 4
参数名类型说明
idString资源id(对应的跳转类型及资源)
resourceTypeString/
backgroundString背景图

关键响应字段

表 1
参数名类型说明
styleString模块展示样式
positionCodeString位置信息
titleString模块标题
resourcesList<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
参数名必选类型说明
idstring歌单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
参数名必选类型说明
songIdString歌曲id
isLikeBoolean添加/删除

关键响应字段

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

#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
参数名必选类型说明
limitInt一页数据量(最多500条)
offsetInt偏移量
originalCoverFlagBoolean是否使用原始封面(无水印),默认:false

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountInt播放量
trackCountInt歌单下歌曲总数
subscribedCountInt收藏量
tagsList<String>标签
createTimelong创建时间(时间戳)
subedboolean是否收藏
#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
参数名必选类型说明
playlistIdstring歌单Id
songIdListList<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
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountInt播放量
subscribedCountInt收藏量
tagsList<String>标签
createTimelong创建时间(时间戳)
trackCountInt歌单下歌曲总数
subedboolean是否收藏
specialTypeInt歌单类型
#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
参数名必选类型说明
limitInt一页数据量(最多500条)
offsetInt偏移量

关键响应字段

表 1
参数名类型说明
idString歌单Id
nameString歌单名称
describeString歌单描述
coverImgUrlString歌单封面url
creatorNickNameString创建者昵称
playCountInt播放量
subscribedCountInt收藏量
trackCountInt歌单下歌曲总数
tagsList<String>标签
createTimelong创建时间(时间戳)
subedboolean是否收藏
#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
参数名必选类型说明
playlistIdstring歌单Id
songIdListList<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
参数名必选类型说明
idstring歌单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
参数名必选类型说明
appIdString云音乐开放平台分配的appId
cashierIdInt收银台id, 由云音乐分配
encryptUserIdString合作方调用云音乐开放平台获取的加密用户id
cashierSignString签名
tabString指定商品sku,可排序,eg:"6,15"
extInfoString扩展信息(可以传车型、手表型号等自定义信息,方便数据分析)

关键响应字段

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

#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
参数名默认值备注
tabredvip,vipplus1. 传入会员权益名称,通过英文的","拼接。2. 第一个元素为进入页面后高亮的产品,建议根据业务需求灵活控制。3. 权益映射:redvip: 黑胶VIP vipplus: 黑胶SVIP
themelight1. 主题色,浅色为 light,深色为 dark 。 2. 只支持打开页面时设置,不支持在页面使用过程中响应变化
zoom1可以自定义任意正数,带小数也可以,长宽同比例缩放;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
参数名类型是否必填说明
sourceUrlString长链
expireTimeSecondsLong过期时间,默认:1296000

关键响应字段

表 1
参数名类型说明
shortUrlString短链
#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
参数名是否必填类型说明
actionString上报动作标识
orderTimeLong订单时间戳(毫秒)
outTradeNoString外部交易号
orderStatusInteger订单状态:1=成功,2=取消
paymentMethodInteger支付方式:1=IOS,2=非IOS
chargeTypeString付费类型(如:单本付费、联合会员、儿童故事会员、单曲付费、会员付费、其他)
idString资源ID
typeString资源类型 歌曲,播客
creatorIdString创作者ID
creatorNameString创作者名称
orderAmountLong订单金额(单位:分),含退款扣减
productNameString商品名称(如月卡、年卡等)
#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
参数名类型描述
encryptUserIdlong加密的uid
encryptOrderIdlong加密的云音乐订单号
vipTypeString会员类型:黑胶、音乐包、车机会员、svip.
durationlong开通时长,单位:天
payTimelong下单时间戳
amountString金额
notifyTypeint通知类型
cashierTokenString收银台token
Autopayint是否自动续费,1-是,0-否
extInfoString端上携带扩展信息
signString签名(已使用云音乐私钥签名,接入方可以使用下方的的云音乐公钥验签)

关键响应字段

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

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
参数名必选类型说明
sessionIdString会话id,含义为包含当前一次上下文内所有对话
queryString一页数据量(最多500条)
表 2
参数名类型说明
resourceTypeString资源类型,当前只有"song"
resourceIdString资源id,可用于查询歌曲详情等内容
contentExtString(SongModel JSON化) 歌曲模型
表 3
参数名类型说明
encIdString资源id
nameString资源名
durationInteger歌曲时长
artistsList<ArtistModel>艺人
albumModelList<AlbumModel>专辑
privilegeModelList<PrivilegeModel>权限
表 4
参数名类型说明
encIdString资源id
nameString资源名

关键响应字段

表 1
参数名类型说明
contentDone是否单类资源完结(单类资源完结可以带content)
totalDone是否整体完结(整体完结后服务端会断开SSE连接,整体完结不会带content)
totalException整体超时或异常
bizCode业务标识符(可忽略)
sessionId本次会话id
dialogueId本次对话id
msgIndex单条消息序号,从0开始
responseContentResponseContent响应内容
specialMeasures响应特殊处理措施 可以组合。在反垃圾、服务端异常且需要特殊处理方式时使用
respFixedText响应覆盖内容
reqFixedText请求覆盖内容
表 2
参数名类型说明
contentTypeString通用内容类型,如text/promptList/logger/resourceList,仅关注text/resourceList,其余内容客户端可自行忽略
bizTypeString业务定义内容类型,一般不使用
contentObject格式见契约
#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
参数名必选类型说明
sessionIdString会话id,含义为包含当前一次上下文内所有对话
queryString一页数据量(最多500条)
表 2
参数名类型说明
resourceTypeString资源类型,当前只有"song"
resourceIdString资源id,可用于查询歌曲详情等内容
contentExtString(SongModel JSON化) 歌曲模型
表 3
参数名类型说明
encIdString资源id
nameString资源名
durationInteger歌曲时长
artistsList<ArtistModel>艺人
albumModelList<AlbumModel>专辑
privilegeModelList<PrivilegeModel>权限
表 4
参数名类型说明
encIdString资源id
nameString资源名

关键响应字段

表 1
参数名类型说明
contentDone是否单类资源完结(单类资源完结可以带content)
totalDone是否整体完结(整体完结后服务端会断开SSE连接,整体完结不会带content)
totalException整体超时或异常
bizCode业务标识符(可忽略)
sessionId本次会话id
dialogueId本次对话id
msgIndex单条消息序号,从0开始
responseContentResponseContent响应内容
specialMeasures响应特殊处理措施 可以组合。在反垃圾、服务端异常且需要特殊处理方式时使用
respFixedText响应覆盖内容
reqFixedText请求覆盖内容
表 2
参数名类型说明
contentTypeString通用内容类型,如text/promptList/logger/resourceList,仅关注text/resourceList,其余内容客户端可自行忽略
bizTypeString业务定义内容类型,一般不使用
contentObject格式见契约

跨端续播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
参数名必选类型说明
playlistIdString歌单Id

关键响应字段

表 1
参数名类型说明
idString歌曲Id
addTimeString添加时间
#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
参数名类型必选说明
sourceTypeString播放列表来源类型: playlist 歌单 / podcast 播客 / album 专辑
initResIdString初始的默认资源 id
sourceIdString播放列表来源 id(如歌单 id、播客 id 等)
podcastAscBoolean播客升序标志: true 升序 / false 降序,不传走播客默认排序
resourcesString播放列表具体资源列表,示例 {"id":"12234","type":"voice"} (参 Resource )
resourceString当前播放资源,示例 {"id":"22344","type":"voice"} (参 Resource )
progressLong播放进度(毫秒, 播客必填 )
sessionIdString标识某轮播放 id,企业自定义;播放列表变化时变化,其他情况保持不变(如下一首)
stateInteger1 :播放列表变化上报; 2 :播放列表不变,只是切歌
playModeString播放模式: random / order / list_loop (默认)/ single_loop
playlistIdString歌单 id
songIdsString歌曲列表,示例 ["dasdasd","addasd"]
currentSongIdString当前播放的歌曲 id
表 2
参数名类型必选说明
idString声音节目id
typeString播客类型,固定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
参数名类型说明
idString资源id
typeString资源类型
originalIdString明文id
表 2
参数名类型说明
resourceIdString资源id
resourceTypeString资源类型
progressLong播放进度 毫秒
originalIdString明文id
表 3
参数名说明
pc来自你的电脑
tv来自你的电视
andrcar来自你的汽车
ios来自你的iPhone
android来自你的手机
default来自你的其他设备

关键响应字段

表 1
参数名类型说明
deviceIdString从哪台设备过来
sessionIdString哪个播放列表会话
relayModeString跨端数据模式
sourceIdString播放列表来源id (歌单id、播客id)
sourceTypeString来源类型,歌单还是播单
resourcesList<OpenApiRelayResourceVO>播放列表资源详情
currentPlayStateOpenApiPlayStateVO当前播放状态情况
playModeString播放模式:random随机播放, order顺序播放, list_loop列表循环, single_loop单曲循环
reportTimeLong上报时间,单位:ms
deviceNameString跨端设备名
osString端信息

随心唱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
参数名必选类型说明
songIdsList<String>歌曲Id列表

关键响应字段

表 1
参数名类型说明
songIdString歌曲id
hasVocalBoolean是否支持干声(人声)
hasMultiTrackBoolean是否有合并声(多轨音频)
#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
参数名必选类型说明
songIdsList<String>歌曲Id列表
表 2
参数名类型说明
typeint音频类型
urlString音频地址
durationint音频时长,单位ms
sizeint音频大小
md5int音频加密
audioQualityint音质
timeint音频时长,单位s
levelString级别
brint码率

关键响应字段

表 1
参数名类型说明
songIdString歌曲id
originAudioVO原唱音频
accompanyAudioVO伴奏音频
vocalAudioVO干声音频(人声)
multiTrackAudioVO多轨音频
#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
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
artistsList<Artist>艺人列表
fullArtistsList<Artist>完整艺人列表(包含已下线艺人)
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比: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
参数名必选类型说明
actionKeysString场景
timbreKeyString音色

关键响应字段

表 1
参数名类型说明
audioUrlString音频地址
audioIdString音频id
conversationString口播文案
durationFloat音频时长 单位秒
sizeLong语音文件大小,单位字节
gainFloat语音文件 gain 值
peakFloat语音文件 peak 值
poolCodeString不同类型的音频对应不同的code
validTimeLong有效时间 单位秒 即多久之后过期
fadeInOutBoolean是否支持淡入淡出(指和歌曲资源的重叠播放)
timbreKeyString音色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
参数名类型说明
avatarString头像
userDetailUrlString用户详情地址
nameString用户名称
timbreKeyString音色key
timbreDescString音色描述
playUrlString播放地址
defaultAudioString是否为默认音色
gainString语音文件 gain 值
peakString语音文件 peak 值
bindingModeString绑定的漫游模式
#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
参数名必选类型说明
songIdsString歌曲列表JSON字符串,eg: "["4FF2AEFFA12B91F8B36FC7A7A191946F"]"
timbreKeyString音色,测试可以传F793-C2
lastReqTimestampLong上一次请求口播的时间戳(ms),默认为0,0认为是第一次请求,用于判断是否为首次请求,出首次请求欢迎语

关键响应字段

表 1
参数名类型说明
audioUrlString音频地址
audioIdString音频id
conversationString口播文案
durationFloat音频时长 单位秒
sizeLong语音文件大小,单位字节
gainFloat语音文件 gain 值
peakFloat语音文件 peak 值
poolCodeString不同类型的音频对应不同的code
validTimeLong有效时间 单位秒 即多久之后过期
fadeInOutBoolean是否支持淡入淡出(指和歌曲资源的重叠播放)
timbreKeyString音色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
参数名必选类型说明
limitInt获取乐评数量,非必传 默认1
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 1 行见官方文档

关键响应字段

表 1
参数名类型说明
songListVoListList<songListVo>歌曲信息
imageString封面url
backgroundString背景
contentsList<String>评论列表
subContentString评论作者
iconString乐评logo
festivalDataWidgetVO节假日信息
表 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
参数名必选类型说明
contentTypeString固定传:CALENDAR
表 2
参数名类型说明
idString歌曲id
nameString歌曲名称
durationlong歌曲时长
albumNameString专辑名
albumIdString专辑Id
albumArtistIdString专辑艺人Id
albumArtistNameString专辑艺人名
artistIdString艺人Id
artistNameString艺人名
coverImgUrlString封面Url
mvIdStringmvId
playUrlString播放url
playFlagBoolean是否可以播放(true,false)
downloadFlagBoolean是否可以下载歌曲(true,false)
payPlayFlagBoolean是否需要付费才能播放(true、false)
payDownloadFlagBoolean是否需要付费才能下载(true、false)
vipFlagboolean需要VIP才能播放和下载
vipPlayFlagboolean需要VIP才能播放
freeTrailFlagboolean是否支持试听
freeTrailFreeTrail试听起止时间,单位:s
likedboolean是否喜欢
songMaxBrint歌曲原本的最大码率(已失效)
userMaxBrint用户能播放的最大码率(已失效)
maxBrLevelString歌曲拥有最大码率对应的level
plLevelString用户可播放歌曲最大码率对应的level
dlLevelString用户可下载歌曲最大码率对应的level
levelString当前返回的歌曲码率对应的level
songSizeint歌曲的大小
songMd5String歌曲的MD5
songTagList<String>歌曲的曲风标签
songFeeint歌曲付费类型
brint返回的歌曲码率
audioFlagint是否有杜比:1
effectsString音效信息(目前仅杜比才有)
privateCloudSongboolean是否云盘歌曲
其余 1 行见官方文档

关键响应字段

表 1
参数名类型说明
songListVoListList<songListVo>歌曲信息
imageString封面url
backgroundString背景
contentsList<String>评论内容
subContentString评论作者
iconString乐评logo
festivalDataWidgetVO节假日信息
#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
参数名必选类型说明
songIdStrin歌曲ID(加密)

关键响应字段

表 1
参数名类型说明
songIdString歌曲ID(加密)
commentsList<OpenCommentVO>评论列表)
表 2
参数名类型说明
contentString乐评内容
nickNameString乐评用户昵称
likedCountLong点赞数量
likedRankInteger点赞排名
#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
参数名类型说明
fontColorString字体颜色
yearInteger年,eg 2022
monthInteger月,eg 11
dayInteger日,eg 10
dayImgString日期图
dayOfWeekInteger星期几
festivalString节日
horizontalBackgroundString横版图片
verticalBackgroundString竖版图片
backgroundColorString节假日背景颜色
表 2
参数名类型说明
originArtistNameString歌手名

关键响应字段

表 1
参数名类型说明
textsList<String>评论列表
originString评论者
songIdString歌曲ID
songNameString歌曲名称
coverUrlString封面
singerNameString歌手名
commentCalendarOpenApiCommentCalendarDateDetailVO评论日期信息
extMap<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
参数名类型说明
idString权益包id
nameString权益包名称
stateint是否可以领取:(0不可以,1可以)
refInterestsList<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
参数名类型说明
composeIdString权益包id

关键响应字段

表 1
参数名类型说明
msgString提示信息
obtainedBooleantrue:领取成功,false:领取失败
errorCodeint领取错误码

音质限免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
参数名必选类型说明
levelString音质
表 2
参数名说明
vividAudio Vivid全景声
dolby杜比全景声
sky沉浸环绕声
jyMaster超清母带
jyEffect高清臻音

关键响应字段

表 1
参数名类型说明
useSucBoolean是否开启成功
trialStatusInteger限免状态(不用管)
trialTypeInteger限免类型(不用管)
expireTimeLong限免到期时间(不用管)
#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
参数名必选类型说明
levelsList<String>音质列表,eg:["jymaster"]
表 2
参数名说明
vividAudio Vivid全景声
dolby杜比全景声
sky沉浸环绕声
jyMaster超清母带
jyEffect高清臻音
表 3
参数名类型说明
useSucBoolean是否开启成功(不用管)
trialStatusInteger限免状态,1:有权限开没开,2:已开
trialTypeInteger限免类型
expireTimeLong限免到期时间

关键响应字段

表 1
参数名类型说明
canUseBoolean是否能使用
canUseTypeInteger可使用的类型
canNotUseReasonCodeInteger无法使用的code码
trialInfotrialInfo限免相关信息