获取歌曲歌词文件

正式环境

https://api.kg.qq.com

POST

/karaoke/base/v2/get_lyric_url

根据歌曲id获取歌曲歌词文件

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

必需

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Body 参数application/json

need_decode

boolean

可选

是否需要解密歌词文件

song_id

string

歌曲id

必需

示例

{
    "need_decode": true,
    "song_id": "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/get_lyric_url' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID;' \
--header 'X-Open-App-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "need_decode": true,
    "song_id": "string"
}'

返回响应

🟢200OK

application/json

Body

lyric_content

object (protocol.SongContentStr)

可选

code

integer

可选

错误码,0表示成功,非0失败, 失败的时候不要使用这个内容更新本地缓存

compress_type

integer

可选

压缩类型，0-不压缩；1-gzip压缩

content

string

可选

这里设置为string类型，接口返回为[]byte, json go会自动base64解密

lyric_type

integer

可选

歌词类型 0-lrc(加密) 2-lrc(解密后)

time

integer

可选

时间戳，如果时间戳不一致,就更新本地缓存数据; 内容为空,也要更新本地缓存为空数据

version

string

版本号

可选

示例

{
    "lyric_content": {
        "code": 0,
        "compress_type": 0,
        "content": "string",
        "lyric_type": 0,
        "time": 0,
        "version": "string"
    }
}

修改于 2025-03-20 07:07:43

查询歌手歌曲

Q音歌曲mid映射K歌