跳转至

recommend

models.recommend

Recommend API 返回模型定义.

RecommendNiche pydantic-model

Bases: Response

首页推荐楼层中的细分卡片分组, 保留标题信息与原始卡片列表.

ATTRIBUTE DESCRIPTION
id

细分分组 ID.

TYPE: int

title_template

标题模板.

TYPE: str

title_content

标题实际展示内容.

TYPE: str

cards

原始卡片列表.

TYPE: list[dict[str, Any]]

Fields:

RecommendShelf pydantic-model

Bases: Response

首页推荐页中的单个楼层, 聚合楼层标题、更多入口与下属细分分组.

ATTRIBUTE DESCRIPTION
id

楼层 ID.

TYPE: int

title_template

楼层标题模板.

TYPE: str

title_content

楼层标题实际展示内容.

TYPE: str

more

更多入口信息.

TYPE: dict[str, Any]

niches

楼层下属的细分分组列表.

TYPE: list[RecommendNiche]

Fields:

RecommendFeedCardResponse pydantic-model

Bases: Response

首页推荐首屏响应, 包含楼层化推荐内容及继续加载所需的状态字段.

ATTRIBUTE DESCRIPTION
retcode

接口返回码.

TYPE: int

msg

附加消息.

TYPE: str

prompt

提示信息.

TYPE: str

d_num

分页或批次计数信息.

TYPE: int

load_mark

继续加载标记.

TYPE: int

shelves

首页推荐楼层列表.

TYPE: list[RecommendShelf]

Fields:

GuessRecommendResponse pydantic-model

Bases: Response

“猜你喜欢”接口响应, 返回按接口顺序展开的推荐歌曲列表.

ATTRIBUTE DESCRIPTION
songs

推荐歌曲列表.

TYPE: list[Song]

Fields:

Validators:

  • _normalize_tracks

RadarRecommendResponse pydantic-model

Bases: Response

雷达推荐响应, 返回推荐歌曲及继续刷新推荐流所需的上下文信息.

ATTRIBUTE DESCRIPTION
songs

推荐歌曲列表.

TYPE: list[Song]

recommend_song_ids

推荐歌曲 ID 列表.

TYPE: list[int]

base_song_ids

作为推荐依据的基础歌曲 ID 列表.

TYPE: list[int]

has_more

是否还能继续获取更多推荐.

TYPE: bool

toast

提示信息块或提示文案.

TYPE: str

timestamp

服务端时间戳.

TYPE: int

video_cards

关联视频卡片数据.

TYPE: dict[str, Any]

Fields:

RecommendSonglistItem pydantic-model

Bases: SongList

推荐歌单列表中的单个歌单摘要, 补充封面、播放量与创建者昵称.

ATTRIBUTE DESCRIPTION
picurl

歌单封面地址.

TYPE: str

songnum

歌单歌曲数量.

TYPE: int

listennum

歌单播放量.

TYPE: int

creator_nick

创建者昵称.

TYPE: str

Fields:

RecommendSonglistResponse pydantic-model

Bases: Response

推荐歌单分页响应, 返回当前批次歌单及是否还能继续拉取更多内容.

ATTRIBUTE DESCRIPTION
songlists

当前批次推荐歌单列表.

TYPE: list[RecommendSonglistItem]

has_more

是否还能继续拉取更多歌单.

TYPE: bool

from_limit

当前批次对应的偏移或起始位置.

TYPE: int

msg

附加消息.

TYPE: str

Fields:

RecommendNewSongTag pydantic-model

Bases: Response

推荐新歌页的标签项, 用于标识当前新歌流所属的频道或筛选维度.

ATTRIBUTE DESCRIPTION
id

标签记录 ID.

TYPE: int

tagid

标签 ID.

TYPE: int

tag

标签名称.

TYPE: str

link

标签跳转链接.

TYPE: str

from_type

标签来源类型.

TYPE: int

Fields:

RecommendNewSongResponse pydantic-model

Bases: Response

推荐新歌响应, 返回当前语言或频道下的新歌列表及可选标签信息.

ATTRIBUTE DESCRIPTION
lanlist

可选语言或频道列表.

TYPE: list[dict[str, Any]]

lan

当前语言或频道标识.

TYPE: str

songs

当前新歌列表.

TYPE: list[Song]

ret_msg

附加返回消息.

TYPE: str

type

当前推荐类型标记.

TYPE: int

song_tags

新歌标签列表.

TYPE: list[RecommendNewSongTag]

Fields: