OpenAI Base URL 测试工具
检测 API 中转地址是否可用,生成 curl 测试命令,快速排查 Base URL 和 API Key 配置问题。
API Key 只在本地浏览器中用于生成命令,不会上传到 QuickRouter 网站服务器。
生成测试命令
填写配置信息,生成可在终端中运行的 curl 测试命令
仅用于本地生成命令,不会上传到服务器
curl https://api.quickrouter.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "Hello"}
]
}'复制以上命令,在终端中粘贴运行即可测试 API 连通性
OpenAI Base URL 是什么
Base URL 是 API 请求的基础地址。当你使用 OpenAI SDK 或兼容接口调用大模型时,所有请求都会发送到这个地址。OpenAI 官方的 Base URL 是 https://api.openai.com/v1,使用 QuickRouter 等中转服务时,需要替换为对应的地址。Base URL 配置正确是 API 调用成功的前提。
为什么要测试 Base URL
配置错误的 Base URL 是 API 调用失败的最常见原因之一。常见问题包括:地址拼写错误、缺少 /v1 路径、使用了错误的协议、网络无法访问目标地址等。通过生成 curl 命令在终端中测试,可以快速确认 Base URL 和 API Key 是否配置正确,排除环境问题。
常见错误原因
注意:Claude Code 与 OpenAI SDK 的 Base URL 不同
Claude Code 和 OpenAI SDK 使用不同的 Base URL 格式。Claude Code 设置 ANTHROPIC_BASE_URL=https://api.quickrouter.ai(不带 /v1)。而 OpenAI SDK / Chat Completions 接口使用 https://api.quickrouter.ai/v1(带 /v1)。本工具生成的是 OpenAI SDK 兼容格式的 curl 命令,用于测试 OpenAI Chat Completions 接口。如果你要配置 Claude Code,请使用 Claude Code 配置生成器。
常见问题
Base URL 是什么?▾
Base URL 是 API 请求的基础地址。OpenAI SDK 默认使用 https://api.openai.com/v1,使用 QuickRouter 的 OpenAI 兼容接口时替换为 https://api.quickrouter.ai/v1。注意:Claude Code 使用不同的 Base URL(https://api.quickrouter.ai,不带 /v1),具体参考 Claude Code 配置生成器。
为什么需要测试 Base URL?▾
如果 Base URL 配置错误,所有 API 请求都会失败。常见问题包括地址拼写错误、缺少 /v1 路径、使用了错误的协议(http vs https)等。
生成的 curl 命令怎么用?▾
复制生成的 curl 命令,在终端(macOS/Linux)或 PowerShell(Windows)中粘贴运行。如果返回 JSON 响应,说明 Base URL 和 API Key 配置正确。
API Key 会被上传到服务器吗?▾
不会。这个工具完全在浏览器本地运行,只用于生成测试命令。API Key 不会发送到 QuickRouter 网站服务器。
curl 测试成功但 SDK 调用失败怎么办?▾
检查 SDK 中的 base_url 参数是否与 curl 中的一致。有些 SDK 使用 baseURL,有些使用 base_url,注意大小写和命名差异。