全民K歌IOT开放平台
  1. 基础类
全民K歌IOT开放平台
  • 厂商合作流程
  • 快速接入
  • SDK bug提单规范
  • 如何在线调试接口
  • 常见问题
  • 业务错误码说明
  • 开放平台接入指南
    • 登录鉴权方式介绍V2（推荐）
    • 如何申请接入
    • CDK权限申请流程
    • 获取应用级token
      POST
    • 获取登录二维码
      POST
    • 查询二维码的状态
      POST
    • 获取用户级token
      POST
    • 刷新用户级token
      POST
  • 基础类
    • tagId对照表
    • 歌曲详情
      POST
    • 查询mv的播放地址
      POST
    • 搜索
      POST
    • 搜索联想
      POST
    • 查询歌手歌曲
      POST
    • 获取歌曲歌词文件
      POST
    • 搜索某歌手的歌曲
      POST
    • Q音歌曲mid映射K歌
      POST
    • 短剧播放链接
      POST
    • 查询应用限免配置
      POST
  • 运营类
    • 排行榜id说明
    • 获取城市id列表
      GET
    • 获取专题分类列表
      POST
    • 获取云端配置
      POST
    • 热门ugc
      POST
    • 热搜词
      POST
    • 排行榜
      POST
    • 获取专题下歌曲信息
      POST
    • 获取车联渠道映射
      POST
    • 热门推荐
      POST
    • （新）排行榜
      POST
    • 综合歌单列表查询
      POST
    • 设置缓存设备
      POST
    • TV版分类歌单列表
      POST
    • 获取广告配置
      POST
    • 拉取短剧合集的列表
      POST
  • 用户类
    • 用户信息查询
      POST
    • 删除用户UGC作品
      POST
    • 获取推荐/翻唱作品
      POST
    • 获取同城作品
      POST
    • 用户作品列表
      POST
    • 获取好友作品
      POST
    • UGC作品详情
      POST
    • 更改作品访问权限
      POST
    • 用户个推歌单
      POST
  • 支付类
    • 支付接入流程
    • 订单发货使用简述
    • 开通设备会员限免简述
    • 通用sign计算规则
    • 【CDK】CDK兑换
      POST
    • 【CDK】生成CDK
      POST
    • 【CDK】CDK召回
      POST
    • 【CDK】CDK状态查询
      POST
    • 【三方支付】订单发货
      POST
    • 【三方支付】手机号发货
      POST
    • 【三方支付】订单状态查询
      POST
    • 【米大师支付】获取会员商品列表
      POST
    • 【米大师支付】未登录-查询会员商品列表
      POST
    • 【米大师支付】支付下单
      POST
    • 【米大师支付】支付成功通知
      POST
    • 【米大师支付】查询用户支付成功订单记录
      POST
    • 查询设备以及用户是否有赠送资格
      POST
    • 查询设备限免剩余时长
      POST
    • 退款设备会员
      POST
    • 设备会员迁移
      POST
    • 查询会员赠送时长
      POST
    • 同步支付订单接口
      POST
    • 【三方支付】存量会员迁移领取查询
      POST
    • 【三方支付】存量会员迁移接口
      POST
    • 授权设备体验会员
      POST
    • 查询用户会员信息
      POST
  • 用户作品-文件类
    • callback_url说明
    • 上传音频源文件
      POST
    • (服务端)上传音频作品的链接
      POST
  • 通用类
    • 【厂商定制】匹配搜索
      POST
    • 【腾讯视频专用】获取SDK请求使用的token
      POST
    • 获取kg的短链接
      POST
  • 用户资产类
  1. 基础类

歌曲详情

正式环境
正式环境
POST
/karaoke/base/v2/get_song_info_batch
基础类
根据歌曲id列表获取歌曲的详细信息
可根据接口返回给歌曲设置如下标签：VIP、HQ、高清、打分、MV

请求参数

Header 参数
X-Open-Access-Token
string 
必需
access token
默认值:
{{X-Open-Access-Token}}
X-Open-ID
string 
openid
可选
默认值:
{{X-Open-ID}}
X-Open-App-ID
string 
业务appid
必需
默认值:
{{X-Open-App-ID}}
Device-ID
string 
可选
设备id，调用KtvSdk.getSdkImei()获取
Body 参数application/json
filter_invalid
boolean 
可选
true的时候，过滤掉被下架的歌曲
song_id_list
array[string]
可选
示例
{
  "song_id_list": [
    "003rw1nY0qfb6w",
    "002FVh9i1aaAav"
  ]
}

示例代码

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/base/v2/get_song_info_batch?members&reference&Type&_postman_listIndexKey=key&_postman_listAllowsMultipleValues' \
--data-raw '{
    "song_id_list": [
        "003rw1nY0qfb6w",
        "002FVh9i1aaAav"
    ]
}'

返回响应

🟢200OK
application/json
Body
song_info_list
array[object (protocol.SongInfo) {31}] 
可选
1080_mv_cover_size
integer 
可选
遮挡mv1080质量文件大小
1080_mv_size
integer 
可选
mv1080质量文件大小
480_mv_cover_size
integer 
可选
遮挡mv480质量文件大小
480_mv_size
integer 
可选
mv480质量文件大小
720_mv_cover_size
integer 
可选
遮挡mv720质量文件大小
720_mv_size
integer 
可选
mv720质量文件大小
album_img
string 
可选
歌曲专辑封面图片500*500
cp_status
integer 
可选

版权状态，1:有版权， [-99,0]无版权，可播， <-300,无版权，不可播

has_hq
boolean 
是否有HQ品质伴奏
可选
has_lyric
integer 
可选
（废弃）是否有字幕(0-未知 1-无字幕 2-有字幕)
has_midi
boolean 
唱歌时是否支持打分
可选
has_mv
boolean 
是否有MV
可选
has_ori_song
boolean 
歌曲是否有原唱
可选
language
integer 
可选
语种：0-国语 1-粤语 2-闽南语 3-日语 4-韩语 5-英语 6-法语 7-其他 9-纯音乐
mv_cover
string 
mv视频封面
可选
mv_has_lyric
boolean 
可选
MV是否包含KTV歌词字幕：0-无，1-有（这种情况可以不用再加载伴奏歌词了）
mv_height
integer 
mv视频高度
可选
mv_width
integer 
mv视频宽度
可选
need_vip
boolean 
是否需要VIP
可选
play_count
integer 
歌曲播放量
可选
play_duration
integer 
播放时长
可选
qqmusic_id
integer 
可选
废弃(该字段返回0)
singer_id
string 
歌手Id
可选
singer_name
string 
歌手名称
可选
song_desc
string 
歌曲描述
可选
song_id
string 
歌曲编号
可选
song_lyric_mask
integer 
可选
伴奏歌词标记，可按位判断与是否有对应的类型。(1:有qrc歌词)+(2:有lrc歌词)
song_name
string 
歌曲名称
可选
song_type
integer 
可选
歌曲类型 0-完整版 3-Live 6-Remix 100-和声
status
integer 
可选
状态 0-下架 1-正常
tag_id_list
array[integer]
可选
tagid列表。参考《TagId对照表》
示例
{
  "song_info_list": [
    {
      "1080_mv_cover_size": 0,
      "1080_mv_size": 0,
      "480_mv_cover_size": 0,
      "480_mv_size": 0,
      "720_mv_cover_size": 0,
      "720_mv_size": 0,
      "album_img": "string",
      "cp_status": 0,
      "has_hq": true,
      "has_lyric": 0,
      "has_midi": true,
      "has_mv": true,
      "has_ori_song": true,
      "language": 0,
      "mv_cover": "string",
      "mv_has_lyric": true,
      "mv_height": 0,
      "mv_width": 0,
      "need_vip": true,
      "play_count": 0,
      "play_duration": 0,
      "qqmusic_id": 0,
      "singer_id": "string",
      "singer_name": "string",
      "song_desc": "string",
      "song_id": "string",
      "song_lyric_mask": 0,
      "song_name": "string",
      "song_type": 0,
      "status": 0,
      "tag_id_list": [
        0
      ]
    }
  ]
}
修改于 2024-11-18 06:26:43
上一页
tagId对照表
下一页
查询mv的播放地址
Built with