跳转至

lyric

歌词 API

get_lyric async 

get_lyric(*, mid: str | None = None, id: int | None = None, qrc: bool = False, trans: bool = False, roma: bool = False) -> dict[str, str]

获取歌词

Note

歌曲 mid 和 id,两者至少提供一个

PARAMETER DESCRIPTION
mid

歌曲 mid

TYPE: str | None DEFAULT: None

id

歌曲 id

TYPE: int | None DEFAULT: None

qrc

是否返回逐字歌词

TYPE: bool DEFAULT: False

trans

是否返回翻译歌词

TYPE: bool DEFAULT: False

roma

是否返回罗马歌词

TYPE: bool DEFAULT: False

RETURNS DESCRIPTION
dict[str, str]

{"lyric": 歌词或逐字歌词, "trans": 翻译歌词, "roma": 罗马歌词}
Source code in qqmusic_api/lyric.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
async def get_lyric(
    *,
    mid: str | None = None,
    id: int | None = None,
    qrc: bool = False,
    trans: bool = False,
    roma: bool = False,
) -> dict[str, str]:
    """获取歌词

    Note:
        歌曲 mid 和 id,两者至少提供一个

    Args:
        mid:   歌曲 mid
        id:    歌曲 id
        qrc:   是否返回逐字歌词
        trans: 是否返回翻译歌词
        roma:  是否返回罗马歌词

    Returns:
        {"lyric": 歌词或逐字歌词, "trans": 翻译歌词, "roma": 罗马歌词}
    """
    if mid is None and id is None:
        raise ValueError("mid or id must be provided")

    params = {
        "crypt": 1,
        "ct": 11,
        "cv": 13020508,
        "lrc_t": 0,
        "qrc": qrc,
        "qrc_t": 0,
        "roma": roma,
        "roma_t": 0,
        "songId": id,
        "songMid": mid,
        "trans": trans,
        "trans_t": 0,
        "type": 1,
    }
    res = await Api(**API["info"]).update_params(**params).result

    lyric = qrc_decrypt(res["lyric"])

    if lyric and qrc:
        try:
            root = ET.fromstring(lyric)
            lyric_info = root[1]
            lyric = lyric_info[0].attrib.get("LyricContent", lyric)
        except Exception:
            pass

    return {
        "lyric": lyric,
        "trans": qrc_decrypt(res["trans"]),
        "roma": qrc_decrypt(res["roma"]),
    }