singer
models.singer
Singer API 返回模型定义.
TagOption
pydantic-model
SingerBrief
pydantic-model
Bases: Singer
歌手列表条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
歌手 ID.
TYPE:
|
mid |
歌手 MID.
TYPE:
|
name |
歌手名称.
TYPE:
|
pmid |
图片标识.
TYPE:
|
area_id |
地区 ID.
TYPE:
|
country_id |
国家或地区 ID.
TYPE:
|
country |
国家或地区名称.
TYPE:
|
other_name |
别名.
TYPE:
|
spell |
拼音.
TYPE:
|
trend |
趋势标记.
TYPE:
|
concern_num |
关注数.
TYPE:
|
singer_pic |
歌手图片地址.
TYPE:
|
Fields:
-
title(str) -
type(int) -
uin(int) -
id(int) -
mid(str) -
name(str) -
pmid(str) -
area_id(int) -
country_id(int) -
country(str) -
other_name(str) -
spell(str) -
trend(int) -
concern_num(int) -
singer_pic(str)
SingerTagData
pydantic-model
Bases: Response
歌手筛选标签集合.
| ATTRIBUTE | DESCRIPTION |
|---|---|
area |
地区标签列表. |
genre |
流派标签列表. |
sex |
性别标签列表. |
index |
索引标签列表. |
Fields:
Validators:
-
_coerce_none_list→area,genre,sex,index
SingerTypeListResponse
pydantic-model
Bases: Response
歌手列表响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
area |
当前地区筛选值.
TYPE:
|
sex |
当前性别筛选值.
TYPE:
|
genre |
当前流派筛选值.
TYPE:
|
singerlist |
当前返回的歌手列表.
TYPE:
|
code |
返回码.
TYPE:
|
hotlist |
热门歌手列表.
TYPE:
|
tags |
可选筛选标签集合.
TYPE:
|
Fields:
-
area(int) -
sex(int) -
genre(int) -
singerlist(list[SingerBrief]) -
code(int) -
hotlist(list[SingerBrief]) -
tags(SingerTagData)
SingerIndexPageResponse
pydantic-model
Bases: SingerTypeListResponse
按索引分页的歌手列表响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
index |
当前索引筛选值.
TYPE:
|
total |
总数量.
TYPE:
|
Fields:
-
area(int) -
sex(int) -
genre(int) -
singerlist(list[SingerBrief]) -
code(int) -
hotlist(list[SingerBrief]) -
tags(SingerTagData) -
index(int) -
total(int)
HomepageBaseInfo
pydantic-model
Bases: Response
歌手主页基础信息.
| ATTRIBUTE | DESCRIPTION |
|---|---|
encrypted_uin |
加密 UIN.
TYPE:
|
background_image |
背景图地址.
TYPE:
|
avatar |
头像地址.
TYPE:
|
name |
展示名称.
TYPE:
|
is_host |
是否为主页所有者.
TYPE:
|
is_singer |
是否为歌手账号.
TYPE:
|
user_type |
用户类型标记.
TYPE:
|
Fields:
-
encrypted_uin(str) -
background_image(str) -
avatar(str) -
name(str) -
is_host(int) -
is_singer(int) -
user_type(int)
HomepageSinger
pydantic-model
TabMeta
pydantic-model
AlbumBrief
pydantic-model
Bases: Album
歌手相关专辑条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
专辑 ID.
TYPE:
|
mid |
专辑 MID.
TYPE:
|
name |
专辑名称.
TYPE:
|
subtitle |
专辑副标题.
TYPE:
|
time_public |
发行日期.
TYPE:
|
total_num |
曲目数.
TYPE:
|
album_type |
专辑类型文案.
TYPE:
|
singer_name |
歌手名称.
TYPE:
|
tags |
标签列表. |
Fields:
-
title(str) -
pmid(str) -
id(int) -
mid(str) -
name(str) -
subtitle(str) -
time_public(str) -
total_num(int) -
album_type(str) -
singer_name(str) -
tags(list[str])
Validators:
-
_coerce_tags→tags
VideoBrief
pydantic-model
Bases: MV
歌手视频条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
MV ID.
TYPE:
|
vid |
MV VID.
TYPE:
|
type |
MV 类型.
TYPE:
|
title |
标题.
TYPE:
|
picurl |
封面地址.
TYPE:
|
picformat |
封面格式标记.
TYPE:
|
duration |
时长.
TYPE:
|
playcnt |
播放量.
TYPE:
|
pubdate |
发布时间戳.
TYPE:
|
icon_type |
图标类型.
TYPE:
|
Fields:
-
name(str) -
id(int) -
vid(str) -
type(int) -
title(str) -
picurl(str) -
picformat(int) -
duration(int) -
playcnt(int) -
pubdate(int) -
icon_type(int)
HomepageTabDetailResponse
pydantic-model
Bases: Response
歌手主页标签详情响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
tab_id |
当前标签页 ID.
TYPE:
|
has_more |
是否还有更多结果.
TYPE:
|
need_show_tab |
是否需要展示标签.
TYPE:
|
order |
排序值.
TYPE:
|
tab_list |
标签页元信息列表. |
introduction_tab |
简介标签内容. |
song_tab |
歌曲标签内容. |
album_tab |
专辑标签内容.
TYPE:
|
video_tab |
视频标签内容.
TYPE:
|
Fields:
-
tab_id(str) -
has_more(int) -
need_show_tab(int) -
order(int) -
tab_list(list[TabMeta]) -
introduction_tab(list[dict[str, Any]]) -
song_tab(list[Song]) -
album_tab(list[AlbumBrief]) -
video_tab(list[VideoBrief])
Validators:
-
_coerce_tab_lists→tab_list,introduction_tab,song_tab,album_tab,video_tab
HomepageHeaderResponse
pydantic-model
Bases: Response
歌手主页头部响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
status |
状态码.
TYPE:
|
singer |
歌手信息.
TYPE:
|
base_info |
主页基础信息.
TYPE:
|
tab_detail |
默认标签页详情. |
prompt |
附加提示信息. |
Fields:
-
status(int) -
singer(HomepageSinger) -
base_info(HomepageBaseInfo) -
tab_detail(HomepageTabDetailResponse) -
prompt(dict[str, Any])
SingerBasicInfo
pydantic-model
Bases: Singer
歌手详情基础信息.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
歌手 ID.
TYPE:
|
mid |
歌手 MID.
TYPE:
|
name |
歌手名称.
TYPE:
|
type |
歌手类型.
TYPE:
|
pmid |
图片标识.
TYPE:
|
has_photo |
是否有照片.
TYPE:
|
wikiurl |
百科链接.
TYPE:
|
Fields:
-
title(str) -
uin(int) -
id(int) -
mid(str) -
name(str) -
type(int) -
pmid(str) -
has_photo(int) -
wikiurl(str)
SingerExtraInfo
pydantic-model
Bases: Response
歌手详情扩展信息.
| ATTRIBUTE | DESCRIPTION |
|---|---|
area |
地区信息.
TYPE:
|
desc |
描述文本.
TYPE:
|
tag |
标签文本.
TYPE:
|
identity |
身份信息.
TYPE:
|
instrument |
擅长乐器.
TYPE:
|
genre |
流派信息.
TYPE:
|
foreign_name |
外文名.
TYPE:
|
birthday |
生日.
TYPE:
|
enter |
入驻或出道信息.
TYPE:
|
blog_flag |
博客标记.
TYPE:
|
Fields:
-
area(str) -
desc(str) -
tag(str) -
identity(str) -
instrument(str) -
genre(str) -
foreign_name(str) -
birthday(str) -
enter(str) -
blog_flag(int)
Validators:
-
_coerce_optional_text→area,identity,instrument,genre,enter
SingerDetail
pydantic-model
Bases: Response
歌手详情条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
basic_info |
基础信息.
TYPE:
|
ex_info |
扩展信息.
TYPE:
|
wiki |
百科或扩展说明数据.
TYPE:
|
group_list |
组合成员列表. |
photos |
照片列表. |
group_info |
组合附加信息. |
Fields:
-
basic_info(SingerBasicInfo) -
ex_info(SingerExtraInfo) -
wiki(str) -
group_list(list[dict[str, Any]]) -
photos(list[dict[str, Any]]) -
group_info(list[dict[str, Any]])
Validators:
-
_coerce_detail_lists→group_list,photos,group_info
SingerDetailResponse
pydantic-model
Bases: Response
歌手详情响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
singer_list |
歌手详情列表.
TYPE:
|
Fields:
-
singer_list(list[SingerDetail])
SimilarSinger
pydantic-model
Bases: Singer
相似歌手条目.
| ATTRIBUTE | DESCRIPTION |
|---|---|
id |
歌手 ID.
TYPE:
|
mid |
歌手 MID.
TYPE:
|
name |
歌手名称.
TYPE:
|
pmid |
图片标识.
TYPE:
|
singer_pic |
歌手图片地址.
TYPE:
|
trace |
追踪信息.
TYPE:
|
abt |
补充文案.
TYPE:
|
tf |
附加标记.
TYPE:
|
Fields:
-
title(str) -
type(int) -
uin(int) -
id(int) -
mid(str) -
name(str) -
pmid(str) -
singer_pic(str) -
trace(str) -
abt(str) -
tf(str)
SimilarSingerResponse
pydantic-model
Bases: Response
相似歌手列表响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
singerlist |
相似歌手列表.
TYPE:
|
code |
返回码.
TYPE:
|
err_msg |
错误消息.
TYPE:
|
Fields:
-
singerlist(list[SimilarSinger]) -
code(int) -
err_msg(str)
Validators:
-
_coerce_similar_list→singerlist
SingerSongListResponse
pydantic-model
SingerAlbumListResponse
pydantic-model
Bases: Response
歌手专辑列表响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
singer_mid |
歌手 MID.
TYPE:
|
total |
专辑总数.
TYPE:
|
album_list |
当前页专辑列表.
TYPE:
|
Fields:
-
singer_mid(str) -
total(int) -
album_list(list[AlbumBrief])
Validators:
-
_coerce_album_list→album_list
SingerMvListResponse
pydantic-model
Bases: Response
歌手 MV 列表响应.
| ATTRIBUTE | DESCRIPTION |
|---|---|
total |
MV 总数.
TYPE:
|
mv_list |
当前页 MV 列表.
TYPE:
|
Fields:
-
total(int) -
mv_list(list[VideoBrief])
Validators:
-
_coerce_mv_list→mv_list