新增国内直连 Base URL： https://api.highwayapi.ai/openai，原域名继续提供服务，详见产品文档

OpenAI API Key 如何配置调用：base_url 与鉴权设置全教程（含代码）

分类：技术交流发布时间：建议阅读时长：9分钟
作者：sodope llm

摘要

很多人拿到 OpenAI API Key 后卡在了第一步：有了密钥却不知道怎么让代码用起来。其实关键就两件事——把 base_url 指向正确的网关，再把鉴权头填对。本文以中转站签发的兼容 Key 为例，手把手讲清楚 base_url 该怎么写、鉴权怎么设置，并给出 Python、Node.js 和 curl 三种调用示例，最后附上最容易踩的 404 排查方法。

第一步：理解你的 Key 指向哪里

官方 Key 默认走 api.openai.com，而中转站签发的兼容 Key 指向的是平台自己的网关。以 jiekou.vip（接口AI）为例，它提供的是 OpenAI 兼容协议，所以你几乎不用改动业务逻辑，只要把请求的 base_url 换成平台给的地址即可。

需要牢牢记住的地址是：OpenAI 兼容协议的 base_url 为 https://api.highwayapi.ai/openai，完整的对话端点是 https://api.highwayapi.ai/openai/v1/chat/completions。注意这里域名是 api.highwayapi.ai，而不是 jiekou.vip——jiekou.vip 是你充值和管理用量的平台，api.highwayapi.ai 才是实际调用的接口域名。

第二步：设置鉴权

鉴权采用标准的 Bearer Token 方式，也就是在 HTTP 请求头里加上 Authorization: Bearer 你的Key。这和官方完全一致，所以官方 SDK 都能直接复用，只需改 base_url。

Python 调用示例

使用官方 openai 库时，只要在初始化客户端时传入 base_url 和 api_key 即可：

from openai import OpenAI
client = OpenAI(
    api_key="你的Key",
    base_url="https://api.highwayapi.ai/openai/v1"
)
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}]
)
print(resp.choices[0].message.content)

这里 base_url 结尾带了 /v1，因为 openai 官方库会在此基础上拼接 /chat/completions。

Node.js 调用示例

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "你的Key",
  baseURL: "https://api.highwayapi.ai/openai/v1",
});
const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "写一句欢迎语" }],
});
console.log(resp.choices[0].message.content);

逻辑和 Python 版一致，baseURL 同样带 /v1。

curl 调用示例

如果只是想快速验证 Key 是否可用，用 curl 最直接：

curl https://api.highwayapi.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer 你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "测试一下"}]
  }'

这里我们直接写了完整端点 https://api.highwayapi.ai/openai/v1/chat/completions，因为 curl 不会帮你拼路径，得手动写全。

最容易踩的坑：404 排查

配置调用时最常见的报错就是 404，几乎都出在路径拼接上。不同工具对 base_url 的处理逻辑不同：官方 SDK 会自动补 /v1/chat/completions，所以 base_url 只写到 /v1；而某些框架或你手写请求时需要写到完整端点。

如果遇到 404，第一件事就是检查 URL 尾部是否多写或少写了 /v1。比如 SDK 里已经带了 /v1，你又在 base_url 里重复写，就会变成 /v1/v1/... 导致找不到路径；反过来，手写 curl 时漏掉 /v1 也会 404。把这一段对照检查一遍，绝大多数问题都能解决。

管理你的用量

配置跑通后，别忘了回到控制台看用量。拿到 Key 只是开始，平台的用量面板能让你实时看到每个 Key 消耗了多少 token、余额还剩多少，方便你控制成本、及时续费。

小结

拿到 OpenAI API Key 后的配置其实很简单：base_url 指向 https://api.highwayapi.ai/openai，鉴权用 Bearer Token，剩下的和官方调用一模一样。记住”SDK 用 /v1 结尾、手写用完整端点”这条规则，再配合 404 时检查 /v1 的排查方法，你就能顺利把 API 密钥用起来了。

分享：
联系我们