分享 API

供网页、App 与第三方客户端（CurrentMusicX 等）复用同一套分享链接、分享文案与分享图。覆盖歌曲、歌单、歌手、专辑四种实体；分享图可由客户端 canvas 实时生成，也可直接取服务端渲染图。

接口一览

实体	元数据	分享图	落地页
歌曲	`GET /cm/share/song/{ncm_id}`	`GET /cm/share/song/{id}/image`	`#/song/{id}`
网易云歌单	`GET /cm/share/playlist/{ncm_pl_id}`	`GET /cm/share/playlist/{id}/image`	`#/ncmpl/{id}`
站内歌单	`GET /cm/share/local-playlist/{playlist_id}`	`GET /cm/share/local-playlist/{id}/image`	`#/pl/{id}`
歌手	`GET /cm/share/artist/{artist_id}`	`GET /cm/share/artist/{id}/image`	`#/artist/{id}`
专辑	`GET /cm/share/album/{album_id}`	`GET /cm/share/album/{id}/image`	`#/album/{id}`

所有接口均为公开，无需登录；url 与 text 按当前请求的 Host 与 X-Forwarded-Proto 生成。服务端实体信息缓存 1 天（歌单/歌手/专辑）/ 歌曲 1 天。

歌曲

GET /cm/share/song/{ncm_id}

{
  "id": 3340114785,
  "type": "song",
  "name": "Reply",
  "artists": "kz / かぐや(cv.夏吉ゆうこ) / 超かぐや姫！",
  "album": "超かぐや姫！",
  "sub": "kz / かぐや(cv.夏吉ゆうこ) / 超かぐや姫！",
  "sub2": "超かぐや姫！",
  "pic": "https://p3.music.126.net/…/109951172602675059.jpg",
  "duration": 269343,
  "url": "https://music.example.com/app/#/song/3340114785",
  "image": "https://music.example.com/cm/share/song/3340114785/image",
  "text": "🎵 Reply - kz / かぐや(cv.夏吉ゆうこ) / 超かぐや姫！\n专辑：超かぐや姫！\n\n在 CurrentMusic 收听：https://music.example.com/app/#/song/3340114785"
}

字段	说明
`id`	网易云歌曲 id
`type`	实体类型：`song` / `playlist` / `local-playlist` / `artist` / `album`
`name` / `artists` / `album`	歌名 / 歌手（`/` 分隔）/ 专辑
`sub` / `sub2`	通用副标题 / 补充信息；歌曲分别为歌手 / 专辑
`pic`	封面（https）
`duration`	时长（毫秒），仅歌曲
`url`	分享链接，见上表落地页
`image`	服务端渲染好的分享图直链（1080×1440 JPEG）
`text`	可直接复制的分享文案

歌单 / 歌手 / 专辑

GET /cm/share/playlist/{ncm_pl_id}
GET /cm/share/local-playlist/{playlist_id}
GET /cm/share/artist/{artist_id}
GET /cm/share/album/{album_id}

通用字段：

type：playlist / local-playlist / artist / album
name / pic / sub / sub2 / url / text / image
歌单额外返回 creator（网易云）或 owner/description（站内）与 trackCount；
歌手额外返回 alias、total（作品数）、albumTotal；
专辑额外返回 artist、size、publishTime、company。

示例（歌手）：

{
  "id": 6452,
  "type": "artist",
  "name": "周杰伦",
  "alias": "Jay Chou / 周董",
  "total": 581,
  "albumTotal": 45,
  "sub": "Jay Chou / 周董",
  "sub2": "581 首作品 · 45 张专辑",
  "url": "https://music.example.com/app/#/artist/6452",
  "image": "https://music.example.com/cm/share/artist/6452/image",
  "text": "🎤 歌手：周杰伦\nJay Chou / 周董\n581 首作品 · 45 张专辑\n\n在 CurrentMusic 查看歌手：https://music.example.com/app/#/artist/6452"
}

错误：id 非法 400、实体不存在 404、上游异常 502。

分享落地页

歌曲：…/app/#/song/<id>
网易云歌单：…/app/#/ncmpl/<id>
站内歌单：…/app/#/pl/<id>
歌手：…/app/#/artist/<id>
专辑：…/app/#/album/<id>

均为公开页面，可浏览；播放/收藏等需要登录的操作会引导登录（音源仅限注册用户）。

分享图

服务端接口（推荐第三方客户端使用）

GET /cm/share/{type}/{id}/image — 公开，无需登录，直接返回 image/jpeg： 1080×1440 卡片，背景取色自封面，含封面、名称/副标题/补充信息、分享链接与二维码。版式随 type 显示 MUSIC SHARE / PLAYLIST SHARE / ARTIST SHARE / ALBUM SHARE。按「分享链接 + 版式版本」缓存 7 天，Host 变化不会串图；响应带 Cache-Control: public, max-age=3600。

依赖 Pillow、segno、Noto Sans CJK 字体；部署环境缺少任意一项时该接口返回 503 （其余接口不受影响）。第三方客户端也可以继续用上面的元数据自行绘制。

客户端本地生成

网页/App 仍会用 canvas 实时绘制同一套版式（离线可用）：

封面加载（网易云 CDN 带 CORS）；从封面 40×40 采样提取主色，作为背景渐变与柔光；
版式：品牌、封面、名称/副标题/补充信息、分隔线、左侧链接文案、右侧二维码；
二维码内容就是 url（EC 级别 M，含 4 模块静区）；生成后用 jsQR 实测可解码；
导出 JPEG；网页端 <a download> 下载，App 端通过原生桥 NativeApi.saveImage 写入 Pictures/CurrentMusic（Android 10+）或应用图片目录。

封面加载失败或画布被污染时，客户端会自动降级为品牌渐变占位封面，仍能出图。

第三方客户端接入

GET /cm/share/{type}/{id}
用返回的 url / text 打开系统分享或复制
分享图：直接使用返回的 image 直链（服务端已渲染并缓存）；
   如需离线/自定义版式，再用 pic 作封面、url 作二维码内容自行绘制

没有账号的用户也可以直接扫码或打开 url 浏览；播放需要登录。

接口一览​

歌曲​

歌单 / 歌手 / 专辑​

分享落地页​

分享图​

服务端接口（推荐第三方客户端使用）​

客户端本地生成​

第三方客户端接入​