转换Q音或酷狗歌曲ID

联调中

正式环境

https://api.kg.qq.com

POST

/karaoke/base/v2/convert_ksong_mid

用于听转唱场景，转换QQ音乐或酷狗歌曲ID为K歌歌曲ID。后台只返回最匹配的一首对应歌曲，如果没有对应歌曲或者该歌曲被下架则返回空字符串。

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

可选

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Device-ID

string

可选

设备id，调用KtvSdk.getSdkImei()获取

Body 参数application/json

midType

integer

歌曲ID类型

必需

0 K歌ID，1 QQ音乐ID，2 酷狗ID

vctMid

array[string]

歌曲ID列表

必需

传需要转换的歌曲ID

示例

{
    "midType": 0,
    "vctMid": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/base/v2/convert_ksong_mid' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "midType": 0,
    "vctMid": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

vctKgMid

array[object (ConvertKSongMidStatus) {2}]

转换歌曲ID结果

必需

按传入顺序返回转换的歌曲ID结果

strKgMid

string

K歌歌曲ID

必需

K歌的歌曲ID

status

integer

歌曲状态

必需

K歌歌曲状态，0 表示可播，非0为转换失败或其他原因不可播

示例

{
    "vctKgMid": [
        {
            "strKgMid": "string",
            "status": 0
        }
    ]
}

修改于 2025-06-23 09:01:16

查询应用限免配置

排行榜id说明