参数名	类型	必填	说明
key	string	是	接口调用密钥
action	string	是
keyword	string	否
page	string	否

书音FM

接口说明

书音FM 接口提供有声小说资源的检索与分页获取功能，支持按关键字搜索及列表展示。该接口面向开发者开放，适用于集成有声书内容展示或播放列表构建场景，调用免费且无需额外费用。

调用地址

https://api.vsaa.cn/api/book/shuyinfm/index.php

请求方式

支持 GET 和 POST 两种请求方式。客户端可根据实际业务场景选择任意一种方式进行调用，请求参数需按接口定义传递。

鉴权说明

调用接口前必须完成身份验证。请通过 URL 查询参数（Query）方式传递密钥，在请求地址后附加参数 key=您的密钥。

鉴权示例：

https://api.vsaa.cn/api/book/shuyinfm/index.php?key=your_key&action=search&keyword=book

请注意：

密钥为必填项，未携带密钥或密钥错误将导致调用失败。
请务必妥善保管密钥，避免泄露给未授权方。

请求参数

调用地址：https://api.vsaa.cn/api/book/shuyinfm/index.php
支持请求方式：GET、POST。密钥通过查询参数 key 传递，为必填项。

参数名	类型	必填	说明
key	string	是	接口调用密钥，以查询参数形式传入。
action	string	是	操作类型，指定接口返回的数据集或功能分支。
keyword	string	否	搜索关键词。传入后接口将基于该词筛选音频资源；不传则返回默认列表。
page	string	否	页码。用于分页获取数据；不传时返回第一页内容。

参数取值说明：

key：需在控制台获取有效密钥，作为 URL 查询字符串的一部分拼接，例如 ?key=YOUR_API_KEY。
action：字符串类型，用于区分不同的接口行为。具体可选值取决于业务场景，通常对应列表获取、详情查询等逻辑。
keyword：支持文本输入，建议避免过长或包含特殊字符，以确保匹配准确性。
page：字符串形式的整数，代表页序。通常从 "1" 开始，递增获取后续数据。

成功响应示例

调用接口成功时，返回 HTTP 200 状态码，响应体为 JSON 格式。数据通过 data 字段包裹，具体结构如下：

{
  "code": 0,
  "data": {
    "isEnd": false,
    "data": [
      {
        "id": "126558",
        "title": "花颜策",
        "artist": "月白花繁,药仰,晏绥,郸子邯,元墨,小龟香,鹿千万,小小韓,cv风雨竹,宇粥,夜冥,飞鱼,凡尘_悍匪剧社,cv安期生,江沉",
        "artwork": "https://img1.kuwo.cn/star/albumcover/240/s4s45/49/181749152.jpg",
        "description": "太子云迟选妃选中花颜，消息令京城碎心。传言太子文登峰武造极，花颜觉天上掉馅饼，自此要与全天下抢这个男人。",
        "status": "连载中"
      },
      {
        "id": "126557",
        "title": "回京认亲后，四个驸马都想弄死我",
        "artist": "月白花繁,药仰,小龟香,鹿千万,元墨,墨雪雪,宇粥,夜冥,落端端,小小韓,一眠,CV大刘,cv风雨竹,珝翎",
        "artwork": "https://img4.kuwo.cn/star/albumcover/240/s4s11/43/380065995.jpg",
        "description": "大唐嫡长公主李汐禾被四个男人杀了四次，重生在选驸马那天，她做出震惊朝野的决定：四位驸马，我全要了！她不再任人操控，要让驸马们为名分争得头破血流，自己稳坐钓鱼台。一场权力、忠诚与真心的较量，谎言与真相交织，谁才是最后的赢家？",
        "status": "完结"
      },
      {
        "id": "126556",
        "title": "京师无人生还",
        "artist": "月白花繁,药仰,元墨,cv风雨竹,鹿千万,CV大刘,夜冥,飞鱼,珝翎,落端端,小小韓,宇粥,小龟香,晏绥,阿由",
        "artwork": "https://img1.kuwo.cn/star/albumcover/240/s4s19/31/1176191234.jpg",
        "description": "无脸医女换脸入狱，与画骨画魂的指挥使陷入一场以整座都城为赌注的生死迷局。他咬她是凶手，她笑他是棋子，十步一杀，百步一坑，真相背后是诛心之局。",
        "status": "完结"
      }
    ]
  }
}

注：实际响应中 data.data 数组长度可能因分页参数而异，示例仅展示部分条目以说明结构。

响应字段说明

字段名	类型	说明
`code`	Integer	业务状态码。`0` 表示请求成功且数据有效。
`data`	Object	响应数据容器，包含分页状态及音频列表数据。
`data.isEnd`	Boolean	分页终止标识。`false` 表示还有更多数据，可继续翻页；`true` 表示当前页为最后一页。
`data.data`	Array	音频作品列表，每个元素代表一条作品信息。
`data.data[].id`	String	作品唯一标识 ID，可用于后续详情查询。
`data.data[].title`	String	作品标题/名称。
`data.data[].artist`	String	配音演员或制作团队名称，多人时以逗号分隔。
`data.data[].artwork`	String	封面图片 URL 地址。
`data.data[].description`	String	作品简介，包含剧情梗概或风格描述。
`data.data[].status`	String	作品更新状态。常见值包括：“连载中”、“完结”。

说明：

当 action 参数指定为列表查询时，返回上述结构。
isEnd 字段仅在启用分页（传入 page 参数）时具有实际翻页判断意义。
所有字符串字段均可能包含中文及特殊符号，建议客户端进行适当的 URL 解码或文本清洗处理。

错误响应示例

当接口调用出现业务逻辑异常、鉴权失败或系统状态异常时，响应体将返回统一的 JSON 结构。成功状态码为 code: 0，具体业务状态由 errcode 字段标识，msg 字段提供人类可读的错误描述。

以下为一个通用的错误响应示例：

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

在此示例中，errcode 为 11002，表明请求中提供的调用密钥无效或不存在。开发者应根据 errcode 数值判断具体的业务错误类型，并据此调整请求参数或处理异常流程。

业务错误码说明

在调用书音FM接口过程中，可能遇到以下业务错误码。请根据对应的 errcode 值排查问题原因并采取相应措施。

errcode	含义	说明
11001	未提供调用密钥	请求中缺少必需的 `key` 参数。
11002	密钥错误	提供的调用密钥无效、格式错误或不存在。
11003	密钥已禁用	该密钥已被管理员手动禁用，无法用于任何接口调用。
11004	积分余额不足	账户积分不足以支付本次接口调用的费用。
11005	请求过于频繁（QPM 限制）	当前请求频率超过限制（每分钟约 60 次），请降低请求频率。
11006	接口维护中	当前接口正在进行维护，暂时不可用，请稍后再试。
11007	接口已禁用	该接口已被管理员全局禁用，禁止任何调用。
11008	接口不可用	接口当前处于不可用状态，可能由于内部配置错误或服务异常。
11009	密钥校验暂不可用	密钥验证服务暂时异常，请稍后重试。
11010	积分系统暂不可用	积分查询或扣减服务暂时异常，请稍后重试。
11011	收费接口须提供有效密钥	该接口为收费接口，必须提供有效的调用密钥进行鉴权。
11012	鉴权方式错误	请求中使用的鉴权方式（如 Query 参数）不符合接口要求。
11013	接口不存在	请求指定的接口路径或动作不存在。
11014	***地址无效	后端依赖的服务地址配置无效或不可解析。
11015	***地址不允许	后端依赖的服务地址不在允许访问的白名单内。
11016	***请求失败	后端依赖的服务返回了错误，导致本次请求失败。
11017	服务暂不可用	后端依赖的服务暂时无法连接或响应超时。
11018	请求方式不允许	使用的 HTTP 请求方法（GET/POST）不被该接口支持。
11019	当前IP不在白名单内	发起请求的客户端 IP 地址不在允许访问的白名单中。
11020	启用出口代理须提供有效密钥	若配置了出口代理功能，必须提供有效的调用密钥。
11021	未配置可用出口代理	接口配置要求使用出口代理，但未找到可用的代理配置。
11022	出口代理不可用	配置的出口代理服务当前不可用或连接失败。
11023	密钥已过期	提供的调用密钥已超过有效期，需更新密钥。
11024	令牌分配积分不足	用于本次分配的令牌所绑定的积分额度不足。
11025	该密钥无权调用此接口	该密钥的权限等级不足以调用当前指定的接口。

调用示例

终端 curl（bash）

curl -X GET "https://api.vsaa.cn/api/book/shuyinfm/index.php?key=你的密钥&action=list&page=1" \
  -H "Content-Type: application/json"

PHP

// PHP 示例

注意事项

密钥安全管理：接口调用密钥（key）具有唯一性和排他性，切勿硬编码在前端代码（HTML/JS/CSS）或客户端 App 中。务必在后端服务或受保护的逻辑层中完成请求，通过后端代理调用本接口，避免密钥泄露导致非法盗用。
鉴权方式：本接口仅支持将密钥通过 URL 查询参数（Query）方式传递，即拼接至请求地址末尾。请勿尝试使用 Header 或其他非标准方式传递密钥，否则将导致鉴权失败。
频率限制：当前接口限频为每分钟约 60 次调用。请合理控制客户端请求并发量，避免频繁刷新或循环调用触发限流机制。若业务场景需要高频访问，建议实施本地缓存策略以降低实际请求次数。
参数取值规范：action 为必填项，请严格按照文档指定的枚举值填写，大小写需一致。keyword 和 page 为可选分页参数，若不指定则默认返回第一页数据；page 传入非数字或负数可能导致返回空列表。
HTTPS 强制：调用地址必须使用 https:// 协议，禁止降级为 http://，以确保密钥在传输过程中不被明文截获。
响应解析：返回结果中的 code 为 0 表示请求成功。注意 data.data 数组可能为空（例如搜索无结果），前端需做好空值判断与容错处理，防止渲染崩溃。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

书音FM

接口信息

请求参数

返回示例

详细文档

书音FM

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

性格测试