- 厂商合作流程
- 快速接入K歌开放平台流程
- SDK bug提单规范
- 如何在线调试接口
- 常见问题FAQ
- 开放平台API错误码说明
- 开放平台接入指南
- KtvSDK3.0接入说明
- 基础类
- 运营类
- 用户类
- 支付类
- 支付接入流程
- 订单发货使用简述
- 开通设备会员限免简述
- 订单发货中通用sign计算规则
- 通用返回结构
- 【CDK】CDK兑换
- 【CDK】生成CDK
- 【CDK】CDK召回
- 【CDK】CDK状态查询
- 【三方支付】订单发货
- 【三方支付】手机号发货
- 【三方支付】订单状态查询
- 【米大师支付】获取会员商品列表
- 【米大师支付】未登录-查询会员商品列表
- 【米大师支付】支付下单
- 【米大师支付】支付成功通知
- 【米大师支付】查询用户支付成功订单记录
- 查询设备以及用户是否有赠送资格
- 查询设备限免剩余时长
- 设备会员迁移
- 查询会员赠送时长
- 同步支付订单接口
- 【三方支付】存量会员迁移领取查询
- 【三方支付】存量会员迁移接口
- 授权设备体验会员
- 查询用户会员信息
- 【三方支付】超会发货
- 取消授权设备体验会员
- 用户作品-文件类
- 通用类
综合歌单列表查询（海外）
正式环境
https://api.kg.qq.com
正式环境
https://api.kg.qq.com
POST
/karaoke/oper/wesing/multi_playlist
推荐优先使用该接口查询歌单。
playlist_id获取途径：
1.
playlist_id需用接口"榜单列表查询（海外）"查询
2.
推荐歌单不需传playlist id
3.
playlist_id需用接口"自建歌单列表查询(海外)"查询
{"id": 1000340,
"category_name": "Best Karaoke Songs",}
找到Best Karaoke Songs对应的id，在本接口传入playlist type:”custom_playlist“，id：1000340，即可查询
"en" -> 英文
"zh_Hans" -> 简体中文
"zh_Hant" -> 繁体中文
"id" -> 印度尼西亚
"ms" -> 马来西亚
"th" -> 泰国
"ph" -> 菲律宾
"vi" -> 越南
"ar" -> 阿拉伯语
"pt" -> 葡萄牙语
"es" -> 西班牙语
请求参数
Header 参数
Body 参数application/json
示例
{
"playlist_id": "2",
"playlist_type": "toplist",
"index": 0,
"nums": 20
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kg.qq.com/karaoke/oper/wesing/multi_playlist' \
--header 'X-Language: en' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID;' \
--header 'X-Open-App-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
"playlist_id": "2",
"playlist_type": "toplist",
"index": 0,
"nums": 20
}'返回响应
🟢200成功
application/json
Body
示例
{
"code": 0,
"sub_code": 0,
"msg": "请求成功",
"data": {
"songs": [
{
"status": 1,
"song_id": "0034bo051eKtJO",
"song_name": "Cô Độc Vương",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000sg002cGmyM0ugZbx.jpg",
"singer_id": "002cGmyM0ugZbx",
"singer_name": "Thiên Tú",
"song_type": 0,
"play_count": 1118129,
"play_duration": 204,
"has_mv": false,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": -11,
"need_vip": false,
"qqmusic_id": 0,
"language": 24,
"has_lyric": 0,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 0,
"720_mv_size": 0,
"1080_mv_size": 0,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 0,
"mv_height": 0,
"mv_cover": "https://imgcache.qq.com/music/photo/mid_album_500/b/x/sg002cGmyM0ugZbx.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "0040jSbS2DlsWh",
"song_name": "可可托海的牧羊人",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000002sYQ3h4Fgp4d.jpg",
"singer_id": "002YZB8L41d2Ne",
"singer_name": "王琪",
"song_type": 0,
"play_count": 1106302,
"play_duration": 340,
"has_mv": true,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": 1,
"need_vip": false,
"qqmusic_id": 0,
"language": 0,
"has_lyric": 1,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 31816391,
"720_mv_size": 58913868,
"1080_mv_size": 255471686,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 1920,
"mv_height": 1080,
"mv_cover": "https://p.kg.qq.com/music/photo_new/T029R960x540M0000013VQgZ1SE2J8.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "003PKuZP2PsztN",
"song_name": "Having You Near Me",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000004JG0Cq4gA5Ne.jpg",
"singer_id": "001pobIk2GYE2r",
"singer_name": "Air Supply(AirSupply)",
"song_type": 0,
"play_count": 4977990,
"play_duration": 247,
"has_mv": false,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": -11,
"need_vip": false,
"qqmusic_id": 0,
"language": 5,
"has_lyric": 0,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 0,
"720_mv_size": 0,
"1080_mv_size": 0,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 0,
"mv_height": 0,
"mv_cover": "https://imgcache.qq.com/music/photo/mid_album_500/N/e/004JG0Cq4gA5Ne.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "000JeePO22XI2X",
"song_name": "白月光与朱砂痣",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000000dt9Py0BrReK.jpg",
"singer_id": "002sT7040IAT6z",
"singer_name": "大籽",
"song_type": 0,
"play_count": 562685,
"play_duration": 204,
"has_mv": true,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": 1,
"need_vip": false,
"qqmusic_id": 0,
"language": 0,
"has_lyric": 1,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 16535628,
"720_mv_size": 31282247,
"1080_mv_size": 69997786,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 1920,
"mv_height": 1080,
"mv_cover": "https://p.kg.qq.com/music/photo_new/T029R960x540M000004OS5QR42JwWP.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "002888ho2NCSTJ",
"song_name": "Sài Gòn Đau Lòng Quá",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000sg0012Vy6S3753P4.jpg",
"singer_id": "0012Vy6S3753P4",
"singer_name": "Hứa Kim Tuyền/Hoàng Duyên",
"song_type": 0,
"play_count": 256439,
"play_duration": 312,
"has_mv": false,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": -11,
"need_vip": false,
"qqmusic_id": 0,
"language": 24,
"has_lyric": 0,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 0,
"720_mv_size": 0,
"1080_mv_size": 0,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 0,
"mv_height": 0,
"mv_cover": "https://imgcache.qq.com/music/photo/mid_album_500/P/4/sg0012Vy6S3753P4.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "002rnFOM4U7DKo",
"song_name": "Chỉ Là Không Cùng Nhau",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M0000049QHB141QBxr.jpg",
"singer_id": "001Uy1372BHghq",
"singer_name": "Tăng Phúc/Trương Thảo Nhi",
"song_type": 0,
"play_count": 481448,
"play_duration": 232,
"has_mv": false,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": -11,
"need_vip": false,
"qqmusic_id": 0,
"language": 24,
"has_lyric": 0,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 0,
"720_mv_size": 0,
"1080_mv_size": 0,
"480_mv_cover_size": 0,
"720_mv_cover_size": 0,
"1080_mv_cover_size": 0,
"mv_width": 0,
"mv_height": 0,
"mv_cover": "https://imgcache.qq.com/music/photo/mid_album_500/x/r/0049QHB141QBxr.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
},
{
"status": 1,
"song_id": "0000GPZN34f4bK",
"song_name": "永不失联的爱",
"album_img": "https://p.kg.qq.com/music/photo_new/T002R500x500M000003xoLyf0Xj3Oe.jpg",
"singer_id": "0022bqqN3dRfN4",
"singer_name": "Eric周兴哲(Eric Chou)",
"song_type": 0,
"play_count": 413281,
"play_duration": 253,
"has_mv": true,
"has_hq": true,
"has_ori_song": true,
"has_midi": true,
"mv_has_lyric": false,
"cp_status": 1,
"need_vip": false,
"qqmusic_id": 0,
"language": 0,
"has_lyric": 2,
"song_lyric_mask": 3,
"song_desc": "",
"480_mv_size": 29333355,
"720_mv_size": 38331802,
"1080_mv_size": 86513145,
"480_mv_cover_size": 19775949,
"720_mv_cover_size": 35549296,
"1080_mv_cover_size": 64407553,
"mv_width": 1920,
"mv_height": 1080,
"mv_cover": "https://p.kg.qq.com/music/photo_new/T029R960x540M000002SInlP4G4Dbj.jpg",
"tag_id_list": null,
"singer_type": 0,
"hq_accompany_file_mid": "",
"hq_song_file_mid": "",
"hq_accompany_file_md5": "",
"hq_song_file_md5": "",
"accompany_file_mid": "",
"song_file_mid": "",
"song_mask": 0,
"has_segment": false,
"segment_start_ms": 0,
"segment_end_ms": 0,
"is_Favorites": false
}
],
"has_more": 1,
"next_index": 0,
"pass_back": "20",
"total": 0,
"detail": {
"title": "",
"sub_title": "",
"square_img": "",
"long_img": "",
"desc": ""
}
}
}修改于 2025-08-14 10:51:48