歌曲音质详情

调用此接口获取歌曲各个音质的文件信息，与 获取歌曲详情 接口相比，多出 高清环绕声、沉浸环绕声、超清母带等音质的信息

接口信息

项目	值
接口地址	`/song/music/detail`
请求方式	`GET` / `POST`
需要登录	否
对应模块	`song_music_detail`
文档分类	歌曲与播放

请求参数

这页暂时没有单独整理参数表，直接参考下面的示例调用即可。

HTTP 示例

bash

GET /song/music/detail?id=2082700997

编程式调用

import { songMusicDetail } from 'hana-music-api';

const result = await songMusicDetail({
  id: '2082700997',
});

console.log(result.body);

返回内容

data 是这首歌各档音质的文件信息：songId 是歌曲编号，h、m、l 是 320k/192k/128k，sq 是无损，vi、sk、jm、je 分别是沉浸环绕声、高清环绕声、超清母带和全景声，sks 是同一档的多个文件。每档有 br（比特率）、size（文件大小）、vd、sr（采样率），sk 和 sks 还有 it（编码）。

code、data、data.songId 是收紧字段；各档音质、sks、error、message、success 是宽松字段。hr、db 在录制里只见过 null，没有声明。未知歌曲是上游 HTTP 200、正文 { data: null, code: 400, message: '参数异常', success: false, error: true }；SDK 以前 resolve status: 200，现在以 status: 400 reject，调用方需要 try/catch 接住 NcmApiResponse，不能只检查 resolve 后的 status。结构定义和类型是 SongMusicDetailBody，见返回体结构。

补充说明

说明: 调用此接口获取歌曲各个音质的文件信息，与 获取歌曲详情 接口相比，多出 高清环绕声、沉浸环绕声、超清母带等音质的信息

必选参数：

id: 歌曲id

接口地址: /song/music/detail

调用例子: /song/music/detail?id=2082700997

返回字段说明 :

text

"br": 比特率Bit Rate,
"size": 文件大小,
"vd": Volume Delta,
"sr": 采样率Sample Rate

歌曲音质详情 ​

接口信息 ​

请求参数 ​

HTTP 示例 ​

编程式调用 ​

返回内容 ​

补充说明 ​