开发者工具 / API 连通性测试

OpenRouter API 在线测试

快速验证 API Key,发起一次真实的模型调用。输入密钥、发送简短消息,即可查看接口是否正常连通以及实际返回结果。

配置测试请求

获取 API Key ↗

仅用于本次请求,不写入 Cookie 或浏览器本地存储。

自动选择免费模型,仍受模型可用性和请求额度限制。

高级选项

可设置 16–1,024。较小上限适合快速测试,推理模型可能需要更多 Token。

本页仅为方便测试使用。Key 验证不生成 Token;模型调用使用您的 OpenRouter 账户。

测试结果

等待测试
API Key 身份验证尚未测试
模型调用响应尚未测试
HTTP 状态码
总耗时
总 Token 数
测试结果将在这里显示

发起测试后,查看模型回复、连接信息,或具体错误与排查建议。

测试结果仅保留在当前标签页。

您的浏览器HTTPS 直接请求OpenRouter API

三步完成 API 连通性测试

无需安装 SDK,无需命令行,打开网页即可测试。

01 / 输入密钥

粘贴您自己的 Key

在 OpenRouter 账户中创建 API Key,将完整密钥粘贴到输入框。点击“仅验证 Key”,即可检查身份验证是否通过,无需向模型发送消息。验证通过表示 OpenRouter 当前接受此 Key,但不代表所有模型都可调用。

02 / 发起请求

发送一条简短消息

建议先使用默认免费模型路由与简短测试消息。“发送测试请求”会先验证 Key,验证通过后再发送一次对话补全请求。如果需要检查特定模型,可以从 OpenRouter 模型目录复制 ID,切换到自定义模型进行测试。

03 / 查看结果

了解响应与失败原因

查看模型回复,或切换到 JSON 阅读完整响应。状态码对应最后一次收到的 API 响应;总耗时包含本次验证与调用。接口返回 Token 用量时,会显示输入与输出的总量。测试结束后可以清空会话。

隐私与透明说明

只有网页,没有测试后端

这是一个方便测试 OpenRouter API 的静态网页工具。Caitty 仅提供页面文件,不接收或中转您的 API Key、消息和接口响应。所有测试请求都由浏览器直接发送至 https://openrouter.ai/api/v1/.

  • Key 只临时保留在当前页面的内存和输入框中。本工具不会将其写入 localStorage、sessionStorage、Cookie、网址参数或数据库。
  • 本页仅接入 Google AdSense 广告,未接入 Google Analytics 或其他独立流量统计。本工具的测试代码不会把您的 Key、消息或响应发送给广告服务。
  • 刷新页面、离开页面或点击“清空本次会话”,都会移除本工具中的 Key 和测试结果。只有主动点击复制才会写入剪贴板;显示的响应中可识别的 OpenRouter Key 会被隐藏。

广告会加载第三方脚本。Google 及其广告合作伙伴可能使用 Cookie 或类似技术投放和衡量广告,因此“仅有广告”并不代表没有第三方请求或广告追踪。 详情请参阅 Google 广告隐私说明

OpenRouter 会接收 Key 以完成身份验证,并将消息路由给模型服务商,因此仍适用其各自的隐私政策。浏览器扩展和设备环境不受本页控制,任何网页都无法承诺绝对安全。建议使用可信浏览器及设置消费限额的测试 Key。

您可以查看 本页请求源码,或通过浏览器开发者工具的网络面板核对请求目的地。本工具独立于 OpenRouter,仅用于快速验证连接是否正常。

常见问题排查

API 错误代表什么?

状态 排查方向
400 / 404 检查模型 ID 和请求参数。所选模型可能已变更或暂时不可用。
401 OpenRouter 拒绝身份验证。请检查 Key 是否完整、是否输错、过期或已被撤销。
402 检查账户余额、Key 消费额度和并发请求预算。必要时降低 Token 上限。
403 检查账户权限、模型访问权限、地区限制或内容规则。
429 等待后重试。即使 Key 有效,免费模型及服务商也有请求频率和额度限制。
5xx OpenRouter 或模型服务商可能暂时不可用。请检查服务状态,或尝试其他模型。
网络 网络、代理、扩展或跨域限制可能导致浏览器无法读取响应。未收到 HTTP 响应不等于 Key 无效。

测试会在 60 秒后停止等待。取消请求并不保证服务商停止处理,也不保证撤销已经产生的费用。

测试前可能想了解

Key 验证通过,就一定能调用模型吗?

不一定。身份验证与模型生成是两个不同的环节。Key 有效时,模型仍可能因余额、权限、限流或服务商不可用而调用失败。本页分别展示这两个步骤的结果,便于定位请求在哪一步停止。

使用这个工具测试需要付费吗?

Caitty 不收取工具使用费。默认的 openrouter/free 路由会选择免费模型,但仍受 OpenRouter 的可用性与额度限制。自定义模型可能产生账户费用。“仅验证 Key”不会发起模型生成。详情请参阅 官方免费路由说明

为什么接口已经响应,却没有回复文本?

部分模型会先消耗输出额度进行推理,再生成可见文本。输出上限较小时,可能出现空回复或 length 截断结果。本页会单独标记这些情况;可以提高 Token 上限或更换模型,再检查实际输出。

这能当聊天应用或性能评测工具吗?

本工具每次只发送一条测试消息,不维护聊天历史。总耗时包含网络连接、Key 验证、路由和模型生成,适合基础排查,不适合直接比较模型速度。正式接入应用时,可以参考 OpenRouter 快速入门API 额度说明