跳转至

MvApi

modules.mv.MvApi 

MvApi(client: Client)

Bases: ApiModule

MV 相关 API.

Source code in qqmusic_api/modules/_base.py 
35
36
37
def __init__(self, client: "Client") -> None:
    self._client = client
    self._session = client._session

get_detail 

get_detail(vids: list[str])

获取 MV 详细信息.

PARAMETER DESCRIPTION
vids

视频 VID 列表.

TYPE: list[str]

Source code in qqmusic_api/modules/mv.py 
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
def get_detail(self, vids: list[str]):
    """获取 MV 详细信息.

    Args:
        vids: 视频 VID 列表.
    """
    return self._build_cgi(
        module="video.VideoDataServer",
        method="get_video_info_batch",
        param={
            "vidlist": vids,
            "required": [
                "vid",
                "type",
                "sid",
                "cover_pic",
                "duration",
                "singers",
                "video_switch",
                "msg",
                "name",
                "desc",
                "playcnt",
                "pubdate",
                "isfav",
                "gmid",
                "uploader_headurl",
                "uploader_nick",
                "uploader_encuin",
                "uploader_uin",
                "uploader_hasfollow",
                "uploader_follower_num",
                "uploader_hasfollow",
                "related_songs",
            ],
        },
        response_model=GetMvDetailResponse,
    )

get_mv_urls 

get_mv_urls(vids: list[str])

获取 MV 播放链接.

PARAMETER DESCRIPTION
vids

视频 VID 列表.

TYPE: list[str]

Source code in qqmusic_api/modules/mv.py 
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def get_mv_urls(self, vids: list[str]):
    """获取 MV 播放链接.

    Args:
        vids: 视频 VID 列表.
    """
    return self._build_cgi(
        module="music.stream.MvUrlProxy",
        method="GetMvUrls",
        param={
            "vids": vids,
            "request_type": 10003,
            "guid": get_guid(),
            "videoformat": 1,
            "format": 265,
            "dolby": 1,
            "use_new_domain": 1,
            "use_ipv6": 1,
        },
        response_model=GetMvUrlsResponse,
    )

get_mv_list 

get_mv_list(
    area: int = 15,
    version: int = 7,
    order: int = 0,
    num: int = 10,
    page: int = 1,
)

获取 MV 分类列表.

PARAMETER DESCRIPTION
area

地区 ID. 15=全部, 8=内地, 5=港台, 6=欧美, 7=韩国, 4=日本.

TYPE: int DEFAULT: 15

version

类型 ID. 7=全部, 8=MV, 13=现场, 14=翻唱, 15=舞蹈, 16=影视, 17=综艺, 18=儿歌.

TYPE: int DEFAULT: 7

order

排序方式. 0=最新, 1=最热.

TYPE: int DEFAULT: 0

num

每页返回数量.

TYPE: int DEFAULT: 10

page

页码, 从 1 开始.

TYPE: int DEFAULT: 1

Source code in qqmusic_api/modules/mv.py 
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
def get_mv_list(
    self,
    area: int = 15,
    version: int = 7,
    order: int = 0,
    num: int = 10,
    page: int = 1,
):
    """获取 MV 分类列表.

    Args:
        area: 地区 ID. 15=全部, 8=内地, 5=港台, 6=欧美, 7=韩国, 4=日本.
        version: 类型 ID. 7=全部, 8=MV, 13=现场, 14=翻唱, 15=舞蹈, 16=影视, 17=综艺, 18=儿歌.
        order: 排序方式. 0=最新, 1=最热.
        num: 每页返回数量.
        page: 页码, 从 1 开始.
    """
    return self._build_cgi(
        module="MvService.MvInfoProServer",
        method="GetAllocMvInfo",
        param={"area": area, "version": version, "order": order, "start": num * (page - 1), "size": num},
        response_model=GetMvListResponse,
        pager_strategy=OffsetStrategy[GetMvListResponse](
            offset_key="start",
            page_size_key="size",
            total_extractor=lambda r: r.total,
            count_extractor=lambda r: len(r.items),
        ),
    ).with_extractor(lambda r: r.items)