CurrentMusic API 文档
面向客户端开发者的接口手册。这里集中说明自建账户、音乐播放、歌单、社区、一起听、AI、通行证与网易云代理的接入方式。
从哪里开始
- 阅读快速开始，完成首次公开请求与账户登录。
- 阅读认证、错误与请求约定，区分 CurrentMusic 会话与通行证令牌。
- 在接口完整索引或左侧分类中找到接口。搜索框支持接口路径、参数与关键词。
- 接入歌词、通行证、私人漫游或一起听时，优先阅读对应的完整专题。
服务地址
| 线路 | API 基址 | Web 客户端 |
|---|---|---|
| 主站 | https://music.20110208.xyz/cm | 打开主站 |
| CTCEHS | https://music.ctcehs.com/cm | 打开镜像 |
| Geekertao | https://currentmusic.geekertao.com/cm | 打开镜像 |
| Bileizhen | https://cm.bileizhen.top/cm | 打开镜像 |
通过线路测速页选择入口。浏览器与服务端的测速口径不同；某个 CDN 端口可达不表示 API 一定正常。
文档如何保证与实现对应
自有接口索引由当前后端路由提取，按 HTTP 方法分别列出实际读取的字段、直接返回结构与业务校验。复杂协议另附可阅读的专题与接入示例。网易云侧按本项目网关登记表列出，每项标明 T0～T3 权限、缓存时间、专用路由优先规则，并附已部署上游版本的参数说明。
文档中的“请求模板”需要填写业务参数；“返回结构中的实现表达式”不是伪造的成功响应。上游原始示例中的 Cookie、裸路径、写入方式必须按本站统一请求约定调整。对于尚未匹配到上游独立说明的接口，会明确标记其资料来源。
常用场景
- 搜索与播放：搜索 → 歌曲详情 → 登录后解析音源 → 获取歌词。
- 账号接入：注册/登录 → Bearer 会话 → 资料与设备管理。
- 同步网易云：CurrentMusic 登录 → 手机/二维码绑定 → 同步歌单或调用 T1/T2 接口。
- 第三方产品登录：通行证接入，使用授权码 + PKCE。
- 实时能力：聊天 AI、一起听。
实用链接
开发者平台 · 账户控制台 · 机器可读接口目录 · 本手册目录数据 · 来源与许可
当前目录：211 项自有路由/方法组合，421 项上游登记路径。