配置
请求配置
单次 API 连通性测试
不落库您的API Key只用于本次连通性测试，服务端临时转发到目标接口，不会被保存。
接口格式
选择目标服务使用的请求协议，页面会自动匹配路径、请求头和请求体。
检测记录
最近连通性测试
记录只保存在当前浏览器本地，不保存 API Key 明文。
当前还没有本页历史记录。
终端复现
也可以直接用 curl 测试
命令会跟随上面的表单实时更新。复制到 PowerShell、Windows Terminal 或 macOS/Linux Terminal 执行，可以更接近后端服务的真实调用环境。
curl -sS 'https://api.example.com/v1/chat/completions' \
-X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <API_KEY>' \
--data-binary '{
"model": "model-id",
"messages": [
{
"role": "user",
"content": "Hello, what model are you using?"
}
],
"max_tokens": 64,
"stream": false
}'如何在终端运行
- 1点击右上角复制命令。
- 2打开 PowerShell、Windows Terminal，或 macOS/Linux Terminal。
- 3粘贴命令后按 Enter 执行。
- 4对照终端输出里的 HTTP 状态、错误信息和返回内容。
错误排查
Windows 新版本通常可以直接使用 curl；如果命令被 PowerShell 别名影响，可以改用 curl.exe。
macOS 和多数 Linux 发行版一般自带 curl。
如果提示找不到命令，先运行 curl --version 或 curl.exe --version 检查安装状态。
错误排查
常见问题和处理办法
401 Unauthorized
Key 无效、过期、复制不完整，或当前服务商不接受这个 Key。
回到服务商后台确认 Key 状态，重新复制时注意不要带空格或换行。
403 Forbidden
账号权限、余额、账单状态、地区限制或目标模型权限不满足。
检查账号套餐、余额、模型授权，并确认选择的接口格式和服务商文档一致。
404 Not Found
接口路径可能拼错，或者把完整路径和页面自动补全路径叠在一起了。
优先填写服务根地址，例如 https://api.example.com，再由页面按协议补全路径。
429 Rate Limited
请求频率过高、额度不足，或服务商对当前 Key 做了并发限制。
稍后重试，降低测试频率；生产接入前确认 RPM、TPM 和并发上限。
CORS / Failed to fetch
浏览器环境不能读取目标 API 响应，或目标服务禁止前端直连。
使用页面生成的 curl 命令在终端执行，或放到自己的后端服务里再测。
5xx Server Error
目标服务、中转层或上游模型服务临时异常。
保留原始返回和请求时间，稍后复测；关键业务建议准备备用接口。
常见问题
连通性测试怎么用
怎么测试我的 API Key？
选择接口格式，填写接口地址、API Key、模型和测试文本，然后点击开始连通性测试。结果会显示状态码、耗时、原始返回和可复现命令。
这个页面和 API 检测有什么区别？
API 连通性测试只发起一次请求，重点看接口地址、Key、模型、权限和返回格式是否能跑通。API 检测会执行多轮探针，用来判断模型一致性、能力掺水、安全泄露和流式完整性。
为什么要生成 curl 命令？
curl 可以绕开浏览器环境差异，更接近后端程序真实调用方式。测试失败时，把脱敏后的命令和原始返回一起保存，方便定位是 Key、路径、权限还是上游服务问题。
API Key 会被保存吗？
不会落库。为了避免浏览器 CORS 限制，本页会把 Key 随本次检测请求发到本站服务端，再转发给目标接口；服务端只用于本次请求，不写入数据库。
测试失败后先看什么？
先看 HTTP 状态码和原始返回。401 多半是 Key 问题，403 多半是权限或余额问题，429 是限流，5xx 更偏上游或中转层异常。
可以连续测试多个 Key 吗？
可以。替换 API Key 后重新检测即可。建议用低额度测试 Key，不要直接拿主账号或高权限 Key 做公开环境验证。