OpenAI Base URL 是什么？国内直连配置教程
OpenAI Base URL 是 OpenAI SDK 中用来指定 API 请求地址的参数，默认值为 https://api.openai.com/v1。国内开发者在调用 OpenAI API 时，由于网络原因无法直接访问默认地址，需要将 Base URL 替换为国内可直连的中转服务地址。通过 QuickRouter 的统一端点 https://api.quickrouter.ai/v1，可以使用同一套 OpenAI SDK 代码调用 GPT-5 等 OpenAI 模型。其他模型（Claude、Gemini、DeepSeek、Grok）通过 https://api.quickrouter.ai 调用。
配置前准备
配置方法
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.quickrouter.ai/v1"
)
response = client.chat.completions.create(
model="gpt-5", # 或 claude-sonnet-4-6, deepseek-chat 等
messages=[
{"role": "user", "content": "你好"}
]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: "https://api.quickrouter.ai/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5",
messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);curl https://api.quickrouter.ai/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5","messages":[{"role":"user","content":"hello"}]}'常见工具配置
常见问题
OpenAI Base URL 是什么？▾
OpenAI Base URL 是 OpenAI SDK 中 base_url（Python）或 baseURL（Node.js）参数的值，用来指定 API 请求发送到哪个服务器地址。默认值是 https://api.openai.com/v1，使用中转服务时需要替换为对应的中转端点地址。
OpenAI Base URL 应该填什么？▾
如果使用 QuickRouter 中转服务，Base URL 应填写 https://api.quickrouter.ai/v1。注意末尾的 /v1 是 OpenAI SDK 约定的路径前缀，大多数 OpenAI 兼容工具都需要这个后缀。
为什么有些工具需要 /v1？▾
OpenAI 的 API 路径格式是 {base_url}/chat/completions，其中 /v1 是版本标识。Python SDK 的 base_url 参数通常需要包含 /v1，Node.js SDK 的 baseURL 参数一般也包含 /v1。而 Claude Code 使用的是 Anthropic 原生协议，其 Base URL（ANTHROPIC_BASE_URL）不需要 /v1 后缀。
Base URL invalid 怎么办？▾
首先确认 Base URL 格式正确（以 https:// 开头，不含多余空格或末尾斜杠）。如果使用 QuickRouter，OpenAI SDK 场景应填写 https://api.quickrouter.ai/v1。如果仍然报错，检查网络连接是否正常，或联系技术支持。
OpenAI SDK 怎么配置 Base URL？▾
Python SDK 在创建客户端时设置 base_url 参数：client = OpenAI(api_key='...', base_url='https://api.quickrouter.ai/v1')。Node.js SDK 使用 baseURL 参数：new OpenAI({ apiKey: '...', baseURL: 'https://api.quickrouter.ai/v1' })。配置完成后，其他调用代码无需修改。