使用文档
API 检测页
通过本站同域代理检测 OpenAI 兼容接口，并拆解 hello 请求里的 Token 开销。
API 检测页在左侧「API 检测」（/api-check）。填写 Provider Base URL、API Key 和模型后，页面会发送一条检测消息（默认 hello，可自定义），确认接口可用，并对比供应商返回的 usage 与可见文本 Token。
浏览器不会直接请求 api.openai.com 这类第三方地址，因此不受供应商 CORS 限制。请求先到达本站 /api/api-check/proxy，再由服务端转发给 Provider。这与 Veridrop 的做法相同：跨域检查发生在服务器，而不是浏览器。
快速使用
- 打开左侧 API 检测。
- 填写 https 的 API Base URL，例如
https://api.openai.com/v1。完整接口地址也可以，末尾的/models、/chat/completions、/responses会自动去掉。 - 填写 API Key，选择 Responses 或 Chat Completions。
- 点击「读取模型」，或直接输入模型 ID。
- 需要时改发送内容，点击「发送并检测」。结果会出现在页面上方。
常用配置可以保存在当前浏览器的 localStorage 中，方便下次回填；这不是服务端存储。
为什么不再出现 CORS 报错
浏览器的同源策略会拦截网页去请求另一个域名，除非对方返回允许的 CORS 头。多数 OpenAI 兼容供应商不会给任意网站开放 CORS，所以从前在浏览器里 fetch 会失败。
现在的路径是：
浏览器 → 本站 /api/api-check/proxy → Provider /models 或 /chat/completions|/responses
- 浏览器只访问本站，属于同源请求。
- 服务端用
fetch访问 Provider，不受浏览器 CORS 限制。 - 服务端只允许
GET /models和单次短文本检测请求，不会把本站做成通用开放代理。
密钥与安全
- API Key 不会写入服务器数据库或日志。它只在这次检测请求的内存里用于设置
Authorization，响应返回后即丢弃。 - 若你点击保存配置，Key 会以明文写入当前浏览器的 localStorage。请勿在公共或共享设备上保存。
- 代理只接受
https公网地址，会拒绝内网、localhost、链路本地和云元数据地址，并拒绝跟随重定向。 - 每个 IP 有频率限制；单次检测约 20 秒超时。
因此本页不能用来探测你电脑上的本地接口（例如 http://127.0.0.1:11434）。这类地址需要你自己在本地发请求，不能经过网站服务器。
结果怎么看
| 结果 | 含义 |
|---|---|
| API 总 Token | Provider 在 usage 里上报的总量，计费应以此为准。 |
| 可见文本 Token | 本地用 o200k_base 估算的发送文本和可见回复。 |
| 其他 Token 消耗 | 总量减去可见文本，通常来自消息角色、协议封装或不可见推理输出。 |
| 接口耗时 | 本站服务器到 Provider 的往返时间，不含浏览器到本站的那一段。 |
文本估算只用于拆解开销；最终账单以 Provider 返回的 usage 为准。
常见问题
为什么必须用 https？ 服务端代理如果允许任意 http 或内网地址，会变成 SSRF 入口。公网 Provider 都应提供 https。
保存的 Key 在哪？
只在你当前浏览器的 localStorage，键名为 token-calculator:openai-api-credentials:v1。清站点数据或换设备后需要重新填写。
读取模型失败但手动填模型可以？
部分兼容接口没有实现 /v1/models，或返回格式不同。可以直接输入模型 ID 再发送检测消息。
和分词器页有什么区别？ 分词器页只在浏览器本地切分你粘贴的文本，不发网络请求。本页会真实调用 Provider，适合检查连通性和协议开销。