参数名	类型	必填	说明	示例
key	string	是	接口调用密钥

看图猜成语

接口说明

该接口提供随机获取看图猜成语内容的服务，适用于需要成语谜题素材的应用场景。调用时需通过 Query 参数传递密钥进行鉴权，接口免费且不限次但存在每分钟约 120 次的频率限制。

调用地址

接口路径为 /api/content/rebus.php。

请求方式

支持 GET 和 POST 两种请求方法。

鉴权说明

调用时需通过 Query 参数传递密钥，参数名为 key。该参数为必填项。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 URL 查询参数传递

成功响应示例

{
    "code": 200,
    "msg": "获取成功",
    "data": {
        "name": "宝珠市饼",
        "interpret": "喻指屏除凡欲，轻宝重道。",
        "provenance": "皇甫端《原化记．贺知章》：贺知章尝谒卖药王老，问黄白术，持一大遗之。老人得珠，即令易饼与贺食。",
        "image": "https://api2.vsaa.cn/api/content/data/rebus/img/297.jpg"
    }
}

响应字段说明

字段	类型	说明
`code`	integer	状态码，`200` 表示请求成功。
`msg`	string	状态描述信息，成功时返回“获取成功”。
`data`	object	返回的数据对象，包含成语猜图的具体内容。
`data.name`	string	成语名称。
`data.interpret`	string	成语释义或解释。
`data.provenance`	string	成语出处或典故来源。
`data.image`	string	成语对应图片的 URL 地址。

错误响应示例

当请求因鉴权失败、权限不足、资源不存在或系统异常等原因未能成功执行时，接口将返回统一结构的 JSON 对象。该对象包含 code（HTTP 状态码映射值或业务逻辑状态码）、msg（人类可读的错误信息描述）以及 errcode（具体的业务错误码）。

以下是一个典型的鉴权失败错误响应示例：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

若密钥无效或过期，响应示例如下：

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

所有业务层面的错误均通过 errcode 字段进行明确标识，客户端应依据此代码进行具体的业务逻辑处理，而非仅依赖 code 或 msg。

业务错误码说明

本接口在调用过程中可能遇到多种业务场景异常，系统通过唯一的 errcode 枚举值来标识具体的错误类型。完整的业务错误码定义如下表所示：

错误码 (errcode)	含义说明	可能原因及排查建议
11001	未提供调用密钥	请求参数中缺少 `key` 字段。请确保在 Query 参数中正确传递有效的 API 密钥。
11002	密钥错误	提供的 `key` 值不存在或拼写错误。请核对密钥是否复制完整，检查是否多空格或换行符。
11003	密钥已禁用	该密钥已被管理员手动禁用。请联系服务商恢复密钥状态或申请新密钥。
11004	积分余额不足	账户可用积分低于本次调用所需费用（尽管本接口标称免费，若配置策略变更可能涉及计费校验）。请充值或联系管理员调整额度。
11005	请求过于频繁	触发 QPM（每分钟请求数）限制。当前接口限制为每分钟约 120 次，请降低请求频率或增加重试间隔。
11006	接口维护中	后端服务正在进行计划内维护或升级。请稍后重试，或查看服务状态页获取预计恢复时间。
11007	接口已禁用	该特定接口路由已被全局或针对该密钥禁用。请确认是否有权限调用此接口，或联系管理员开启。
11008	接口不可用	接口暂时无法提供服务，可能由后端依赖服务故障引起。请重试或稍后再试。
11009	密钥校验暂不可用	鉴权服务暂时异常，无法完成密钥合法性验证。这通常是临时故障，请等待片刻后重试。
11010	积分系统暂不可用	计费或额度查询服务暂时无法连接。虽为免费接口，但预检流程可能受阻，请稍后重试。
11011	收费接口须提供有效密钥	针对计费接口的强制校验。虽然本接口当前为免费，但若在计费策略调整期间调用，必须提供有效密钥。
11012	鉴权方式错误	客户端使用了不被支持的鉴权传输方式。本接口首选 Query 参数传递密钥（`key=...`），请勿使用其他未经授权的 Header 注入方式。
11013	接口不存在	请求的路径 `/api/content/rebus.php` 在路由表中未找到。请检查 URL 拼写是否正确，或该接口是否已下线。
11014	***地址无效	后端尝试访问的数据源地址格式错误或无法解析。这是服务端内部错误，通常无需客户端处理，可反馈给服务商。
11015	***地址不允许	后端数据源访问被策略拦截或域名不在允许列表中。需服务商调整内部访问策略。
11016	***请求失败	后端获取数据的内容源发生超时、连接拒绝或其他非 2xx 响应。建议客户端实现重试机制。
11017	服务暂不可用	整体服务容量不足或瞬时过载。建议客户端增加指数退避重试策略。
11018	请求方式不允许	使用了接口不支持的 HTTP 方法。本接口仅支持 `GET` 和 `POST`，请确保请求方法正确。
11019	当前IP不在白名单内	来源 IP 未被授权访问。请检查请求出口 IP 是否在服务商配置的安全白名单中，如需新增 IP 请联系管理员。
11020	启用出口代理须提供有效密钥	内部网络策略要求：若通过代理出口，必须携带有效密钥以进行身份绑定。请确保证书/密钥配置正确。
11021	未配置可用出口代理	服务端未配置正确的代理通道。这是服务端配置问题，请联系技术团队检查网络出口设置。
11022	出口代理不可用	配置的代理节点失效或无法连接。客户端无需处理，服务商需修复代理链路。
11023	密钥已过期	密钥的生命周期结束，超过有效期。请在控制台申请更新密钥或启用长期有效密钥。
11024	令牌分配积分不足	针对子令牌或特定配额池的积分耗尽。请检查具体令牌的额度分配，或向主账户补充积分。

客户端集成时，建议对 11001、11002、11023 等鉴权类错误进行显式处理，提示用户更新密钥；对 11005 进行限流退避；对 11006、11008、11009、11010、11016、11017 等临时性错误实施指数退避重试策略。对于 11013、11014、11015、11018 等配置或路由错误，若多次重试无果，应记录日志并报警，因为这些问题通常不是由客户端瞬时状态引起的。

调用示例

终端 curl（bash）

curl "https://api2.vsaa.cn/api/content/rebus.php?key=YOUR_API_KEY"

注意：请将 YOUR_API_KEY 替换为您在控制台获取的实际密钥。该接口支持 GET 请求，参数通过 URL 查询字符串传递。

PHP

以下示例使用 file_get_contents 发起 GET 请求，并将返回的 JSON 字符串解析为数组。

注意事项

密钥安全保管
key 参数通过 Query 字符串传递（`?key=*** 会随请求 URL 暴露，严禁将密钥硬编码在前端 JavaScript、移动端 App 或客户端代码中。生产环境务必通过后端服务端转发调用，防止密钥泄露。
传输安全
接口必须使用 HTTPS 协议访问，避免明文传输导致密钥在中间节点被窃取。
频率限制
单密钥调用频率限制为每分钟约 120 次。超出限制将触发限流响应，请合理规划请求间隔，避免高频轮询。
参数校验
key 为必填参数，缺失或格式错误时将返回非 200 业务码。请勿在 URL 中传递多余未定义参数，以免干扰服务端解析。
内容合规
返回数据中的 provenance（出处）及 interpret（释义）字段可能包含历史典故或传统文化内容，展示时请自行校验合规性，避免用于违规场景。
资源缓存
返回示例中的 image 字段为静态图片地址，建议前端适当设置缓存策略，减少重复请求对频率限制的占用。

免责声明

欢迎使用 万象数据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日

看图猜成语

接口信息

请求参数

返回示例

详细文档

看图猜成语

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

西格玛FM