{"code":0,"message":"ok","data":{"title":"音乐聚合 API 文档","version":"v1","base":"\/api","charset":"UTF-8","methods":"GET \/ POST","platforms":{"netease":"网易云音乐","tencent":"QQ音乐"},"auth":["X-API-Key: msk_xxxxxxxxxxxx","Authorization: Bearer msk_xxxx","?api_key=msk_xxxx"],"auth_note":"所有接口均需 API Key（强制），缺少或无效返回 401。","envelope":{"code":"0 成功，非 0 为业务错误码","message":"成功为 ok，失败为错误描述","request_id":"请求标识","data":"业务数据，失败时为 null","meta":"meta.platform 平台代码；meta.platform_name 平台名称；meta.count 本页条数；meta.channel_id 渠道账号 ID；meta.mode 模式；meta.remaining_today 今日剩余，-1 不限"},"actions":[{"path":"\/song","name":"歌曲","examples":["GET \/api\/song?platform=netease&keyword=晴天&limit=20","GET \/api\/song?platform=netease&id=186016"],"params":[["platform","string","是","netease \/ tencent"],["keyword","string","二选一","搜索关键词"],["id","string","二选一","唯一 ID，返回详情"],["page","int","否","页码，默认 1"],["limit","int","否","每页条数，默认 20"]],"search_fields":"keyword, page, limit, total, list[]","search_item":"id, name, artist[{id,name}], album_id, album, pic_id, url_id, lyric_id, cover, duration, duration_text","detail_fields":"id, name, artist[{id,name}], album_id, album, pic_id, url_id, lyric_id, cover, duration, duration_text, qualities[{code,name,br,size}]"},{"path":"\/playlist","name":"歌单","examples":["GET \/api\/playlist?platform=netease&id=3778678","GET \/api\/playlist?platform=netease&keyword=周杰伦&limit=20"],"params":[["platform","string","是","netease \/ tencent"],["keyword","string","二选一","搜索关键词"],["id","string","二选一","唯一 ID，返回详情"],["page","int","否","页码，默认 1"],["limit","int","否","每页条数，默认 20"]],"search_fields":"id, name, creator{id,name,avatar}, cover, pic_id, description, play_count","search_item":"id, name, creator{id,name,avatar}, cover, pic_id, description, play_count","detail_fields":"id, name, cover, creator{id,name,avatar}, pic_id, description, play_count, song_count, songs[]"},{"path":"\/artist","name":"歌手","examples":["GET \/api\/artist?platform=netease&keyword=周杰伦&limit=20","GET \/api\/artist?platform=netease&id=6452&data_type=songs&page=1&limit=20","GET \/api\/artist?platform=netease&id=6452&data_type=albums&page=1&limit=20"],"params":[["platform","string","是","netease \/ tencent"],["keyword","string","二选一","搜索关键词"],["id","string","二选一","唯一 ID，返回详情"],["page","int","否","页码，默认 1"],["limit","int","否","每页条数，默认 20"],["data_type","string","否","详情返回类型：songs（默认）或 albums，各自独立分页"]],"search_fields":"id, name, avatar, album_count, song_count, description","search_item":"id, name, avatar, album_count, song_count, description","detail_fields":"id, name, avatar, description, data_type, songs[], song_count, albums[], page, limit, total","note":"详情用 data_type 选择返回 songs（默认）或 albums，各自独立分页。"},{"path":"\/album","name":"专辑","examples":["GET \/api\/album?platform=netease&id=32311","GET \/api\/album?platform=netease&keyword=周杰伦&limit=20"],"params":[["platform","string","是","netease \/ tencent"],["keyword","string","二选一","搜索关键词"],["id","string","二选一","唯一 ID，返回详情"],["page","int","否","页码，默认 1"],["limit","int","否","每页条数，默认 20"]],"search_fields":"id, name, cover, pic_id, artists[{id,name}], publish_date, description","search_item":"id, name, cover, pic_id, artists[{id,name}], publish_date, description","detail_fields":"id, name, cover, pic_id, artists[{id,name}], publish_date, description, song_count, songs[]"},{"path":"\/lyric","name":"歌词","examples":["GET \/api\/lyric?platform=netease&id=186016"],"params":[["platform","string","是","netease \/ tencent"],["id","string","是","唯一 ID"]],"search_fields":"keyword, page, limit, total, list[]","detail_fields":"id, name, lyric, trans_lyric"},{"path":"\/playurl","name":"播放链接","examples":["GET \/api\/playurl?platform=netease&id=186016&quality=lossless"],"params":[["platform","string","是","netease \/ tencent"],["id","string","是","唯一 ID"],["quality","string","否","音质代码，缺省自动"]],"search_fields":"keyword, page, limit, total, list[]","detail_fields":"song_id, name, available, url, quality, quality_name, size, format, bitrate, free, available_qualities[{code,name}], quality_unavailable, reason","note":"只返回请求的那一档，不做降级；本曲或账号没有该档位时返回 available=false 与可用档位。"},{"path":"\/pic","name":"封面图","examples":["GET \/api\/pic?platform=netease&id=109951173569626660&size=500"],"params":[["platform","string","是","netease \/ tencent"],["id","string","是","唯一 ID"],["size","int","否","图片边长像素，默认 300"]],"search_fields":"keyword, page, limit, total, list[]","detail_fields":"id, size, url","note":"id 取歌曲或歌单的 pic_id（封面 CDN 路径）。"},{"path":"\/quality","name":"音质列表","examples":["GET \/api\/quality?platform=netease"],"params":[["platform","string","是","netease \/ tencent"]],"detail_fields":"platform, platform_name, total, qualities[{code,name}]","note":"平台内置音质档位，不依赖歌曲，也不消耗上游请求。"}],"qualities":{"netease":{"jymaster":"超清母带（jm）","jyeffect":"沉浸环绕（je）","sky":"空间音频（sk）","hires":"Hi-Res","lossless":"无损 SQ","exhigh":"极高 320kbps","higher":"较高 192kbps","standard":"标准 128kbps"},"tencent":{"master":"臻品母带 24bit\/192kHz","flac":"无损 FLAC","320":"MP3 320kbps","aac192":"AAC 192kbps","128":"MP3 128kbps","ogg192":"OGG 192kbps","aac96":"AAC 96kbps","ogg96":"OGG 96kbps"}},"errors":[[400,"参数错误","缺少 platform \/ keyword \/ id，或 keyword 与 id 同时传入"],[401,"未授权","缺少或无效 API Key"],[403,"禁止访问","API Key 已停用或已过期"],[429,"超出配额","今日调用次数已达上限"],[500,"服务异常","上游接口异常或内部错误"]]}}