album

专辑相关 API

get_cover

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

获取专辑封面链接

参数	描述
mid	专辑 mid 类型： str
size	封面大小 类型： Literal[150, 300, 500, 800] 默认： 300

返回	描述
str	封面链接

源代码位于： qqmusic_api/album.py

def get_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"

get_detail async

get_detail(value: str | int)

获取专辑详细信息

参数	描述
value	专辑 id 或 mid 类型： str | int

源代码位于： qqmusic_api/album.py

@api_request("music.musichallAlbum.AlbumInfoServer", "GetAlbumDetail")
async def get_detail(value: str | int):
    """获取专辑详细信息

    Args:
        value: 专辑 id 或 mid
    """
    if isinstance(value, int):
        return {"albumId": value}, NO_PROCESSOR

    return {"albumMId": value}, NO_PROCESSOR

get_song async

get_song(value: str | int, num: int = 10, page: int = 1)

获取专辑歌曲

参数	描述
value	专辑 id 或 mid 类型： str | int
num	返回数量 类型： int 默认： 10
page	页码 类型： int 默认： 1

源代码位于： qqmusic_api/album.py

@api_request("music.musichallAlbum.AlbumSongList", "GetAlbumSongList")
async def get_song(value: str | int, num: int = 10, page: int = 1):
    """获取专辑歌曲

    Args:
        value: 专辑 id 或 mid
        num: 返回数量
        page: 页码
    """
    params: dict[str, Any] = {
        "begin": num * (page - 1),
        "num": num,
    }

    def _processor(data: dict[str, Any]) -> list[dict[str, Any]]:
        return [song["songInfo"] for song in data["songList"]]

    if isinstance(value, int):
        params["albumId"] = value
    else:
        params["albumMid"] = value

    return params, _processor