QuickRouter API 大模型API聚合中转平台QuickRouter API

OpenAI Base URL 测试工具

检测 API 中转地址是否可用,生成 curl 测试命令,快速排查 Base URL 和 API Key 配置问题。

API Key 只在本地浏览器中用于生成命令,不会上传到 QuickRouter 网站服务器。

生成测试命令

填写配置信息,生成可在终端中运行的 curl 测试命令

仅用于本地生成命令,不会上传到服务器

terminal
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 是否配置正确,排除环境问题。

常见错误原因

地址拼写错误:例如 api.quickrouter.ai 写成了 api.quickrouter.com
缺少或多余路径:例如忘记 /v1,或 /v1 写成了 /v1/
API Key 格式错误:不是以 sk- 开头,或复制时遗漏了字符
网络无法访问:本地网络环境无法连接到目标服务器
Content-Type 未设置:请求头中缺少 application/json

注意: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,注意大小写和命名差异。