/ 接口详情
唱鸭
唱鸭随机弹唱接口，支持搜索联想、榜单、发现页、音频详情、房间列表等。
接口信息
GET / POST
api.vsaa.cn/api/changya/index.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| action | string | 是 | 操作。取值：suggest / search_ranks / discover_init / audio_detail / home_rec / solo_content_rec / room_get_banners / room_room_list / list | suggest |
| searchWord | string | 否 | 仅 action=suggest 使用；检索关键词 | 爱 |
| size | string | 否 | 用于 suggest / search_ranks / home_rec / solo_content_rec；返回条数 | 10 |
| audioId | string | 否 | 仅 action=audio_detail 使用；音频 id，缺省为内置示例 | QPp1MT8qvB0RsXe5E |
| cursor | string | 否 | 用于 home_rec / solo_content_rec；分页游标，首页不传 | |
| gender | string | 否 | 仅 action=home_rec 使用；内容性别偏好（male/female） | male |
| lastTime | string | 否 | 仅 action=solo_content_rec 使用；上次请求时间戳，首页为 0 | 0 |
| roomType | string | 否 | 仅 action=room_room_list 使用；房间类型，默认 101 | 101 |
[
{
"name": "action",
"type": "string",
"required": true,
"description": "操作。取值：suggest / search_ranks / discover_init / audio_detail / home_rec / solo_content_rec / room_get_banners / room_room_list / list",
"example": "suggest"
},
{
"name": "searchWord",
"type": "string",
"required": false,
"description": "仅 action=suggest 使用；检索关键词",
"example": "爱"
},
{
"name": "size",
"type": "string",
"required": false,
"description": "用于 suggest / search_ranks / home_rec / solo_content_rec；返回条数",
"example": "10"
},
{
"name": "audioId",
"type": "string",
"required": false,
"description": "仅 action=audio_detail 使用；音频 id，缺省为内置示例",
"example": "QPp1MT8qvB0RsXe5E"
},
{
"name": "cursor",
"type": "string",
"required": false,
"description": "用于 home_rec / solo_content_rec；分页游标，首页不传",
"example": ""
},
{
"name": "gender",
"type": "string",
"required": false,
"description": "仅 action=home_rec 使用；内容性别偏好（male/female）",
"example": "male"
},
{
"name": "lastTime",
"type": "string",
"required": false,
"description": "仅 action=solo_content_rec 使用；上次请求时间戳，首页为 0",
"example": "0"
},
{
"name": "roomType",
"type": "string",
"required": false,
"description": "仅 action=room_room_list 使用；房间类型，默认 101",
"example": "101"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "唱鸭",
"description": "唱鸭随机弹唱接口，支持搜索联想、榜单、发现页、音频详情、房间列表等。",
"version": "1.0.0"
},
"paths": {
"\/api\/changya\/index.php": {
"get": {
"summary": "唱鸭",
"description": "唱鸭随机弹唱接口，支持搜索联想、榜单、发现页、音频详情、房间列表等。",
"parameters": [
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "suggest"
},
"description": "操作。取值：suggest \/ search_ranks \/ discover_init \/ audio_detail \/ home_rec \/ solo_content_rec \/ room_get_banners \/ room_room_list \/ list"
},
{
"name": "searchWord",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "爱"
},
"description": "仅 action=suggest 使用；检索关键词"
},
{
"name": "size",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "用于 suggest \/ search_ranks \/ home_rec \/ solo_content_rec；返回条数"
},
{
"name": "audioId",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "QPp1MT8qvB0RsXe5E"
},
"description": "仅 action=audio_detail 使用；音频 id，缺省为内置示例"
},
{
"name": "cursor",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "用于 home_rec \/ solo_content_rec；分页游标，首页不传"
},
{
"name": "gender",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "male"
},
"description": "仅 action=home_rec 使用；内容性别偏好（male\/female）"
},
{
"name": "lastTime",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "仅 action=solo_content_rec 使用；上次请求时间戳，首页为 0"
},
{
"name": "roomType",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "101"
},
"description": "仅 action=room_room_list 使用；房间类型，默认 101"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "唱鸭",
"description": "唱鸭随机弹唱接口，支持搜索联想、榜单、发现页、音频详情、房间列表等。",
"parameters": [
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "suggest"
},
"description": "操作。取值：suggest \/ search_ranks \/ discover_init \/ audio_detail \/ home_rec \/ solo_content_rec \/ room_get_banners \/ room_room_list \/ list"
},
{
"name": "searchWord",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "爱"
},
"description": "仅 action=suggest 使用；检索关键词"
},
{
"name": "size",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "用于 suggest \/ search_ranks \/ home_rec \/ solo_content_rec；返回条数"
},
{
"name": "audioId",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "QPp1MT8qvB0RsXe5E"
},
"description": "仅 action=audio_detail 使用；音频 id，缺省为内置示例"
},
{
"name": "cursor",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "用于 home_rec \/ solo_content_rec；分页游标，首页不传"
},
{
"name": "gender",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "male"
},
"description": "仅 action=home_rec 使用；内容性别偏好（male\/female）"
},
{
"name": "lastTime",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "仅 action=solo_content_rec 使用；上次请求时间戳，首页为 0"
},
{
"name": "roomType",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "101"
},
"description": "仅 action=room_room_list 使用；房间类型，默认 101"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口（https）"
}
]
}
详细文档
暂无详细文档
快速上手
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
在线测试
请求地址
api.vsaa.cn/api/changya/index.php
Method
参数
Response
// 结果将在此处显示
接口反馈
免责声明
免责声明
欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期：2026年10月6日
