跳转至

album

专辑相关 API

get_album_cover 

get_album_cover(mid: str, size: Literal[150, 300, 500, 800] = 300) -> str

获取专辑封面链接

PARAMETER DESCRIPTION
mid

专辑 mid

TYPE: str

size

封面大小

TYPE: Literal[150, 300, 500, 800] DEFAULT: 300

RETURNS DESCRIPTION
str

封面链接
Source code in qqmusic_api/album.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
def get_album_cover(mid: str, size: Literal[150, 300, 500, 800] = 300) -> str:
    """获取专辑封面链接

    Args:
        mid: 专辑 mid
        size: 封面大小

    Returns:
        封面链接
    """
    if size not in [150, 300, 500, 800]:
        raise ValueError("not supported size")
    return f"https://y.gtimg.cn/music/photo_new/T002R{size}x{size}M000{mid}.jpg"

Album 

Album(*, mid: str | None = None, id: int | None = None)

专辑类

ATTRIBUTE DESCRIPTION
mid

专辑 mid
id

专辑 id

初始化专辑类

Note

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

PARAMETER DESCRIPTION
mid

专辑 mid

TYPE: str | None DEFAULT: None

id

专辑 id

TYPE: int | None DEFAULT: None

Source code in qqmusic_api/album.py 
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
def __init__(
    self,
    *,
    mid: str | None = None,
    id: int | None = None,
):
    """初始化专辑类

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

    Args:
        mid: 专辑 mid
        id:  专辑 id
    """
    if mid is None and id is None:
        raise ValueError("mid or id must be provided")
    self.mid = mid or ""
    self.id = id or 0
    self._info: dict | None = None

get_mid async 

get_mid() -> str

获取专辑 mid

RETURNS DESCRIPTION
str

专辑 mid
Source code in qqmusic_api/album.py 
55
56
57
58
59
60
61
62
63
async def get_mid(self) -> str:
    """获取专辑 mid

    Returns:
        专辑 mid
    """
    if not self.mid:
        self.mid = (await self.get_detail())["basicInfo"]["albumMid"]
    return self.mid

get_id async 

get_id() -> int

获取专辑 id

RETURNS DESCRIPTION
int

专辑 id
Source code in qqmusic_api/album.py 
65
66
67
68
69
70
71
72
73
async def get_id(self) -> int:
    """获取专辑 id

    Returns:
        专辑 id
    """
    if not self.id:
        self.id = (await self.get_detail())["basicInfo"]["albumID"]
    return self.id

get_detail async 

get_detail() -> dict

获取专辑详细信息

RETURNS DESCRIPTION
dict

专辑详细信息
Source code in qqmusic_api/album.py 
75
76
77
78
79
80
81
82
83
async def get_detail(self) -> dict:
    """获取专辑详细信息

    Returns:
        专辑详细信息
    """
    if not self._info:
        self._info = await Api(**API["detail"]).update_params(albumMid=self.mid, albumId=self.id).result
    return self._info

get_song async 

get_song() -> list[dict]

获取专辑歌曲

RETURNS DESCRIPTION
list[dict]

歌曲列表
Source code in qqmusic_api/album.py 
85
86
87
88
89
90
91
92
async def get_song(self) -> list[dict]:
    """获取专辑歌曲

    Returns:
        歌曲列表
    """
    result = await Api(**API["song"]).update_params(albumMid=self.mid, albumId=self.id, begin=0, num=0).result
    return [song["songInfo"] for song in result["songList"]]