Skip to main content

​
常见错误现象

当您看到类似以下错误信息时，通常是请求地址（Base URL）配置错误。 
{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
有可能使用了 MixRoute 的 API Key，但请求地址仍然指向 OpenAI 官网 https://api.openai.com

​
什么是 Base URL？

Base URL（基础 URL / 请求地址）是 API 请求的目标服务器地址。不同的 API 服务提供商使用不同的 Base URL。

​
MixRoute 的 Base URL 和 API Key 必须对应

client = OpenAI(
    api_key="sk-mixroute-key",
    base_url="https://api.mixroute.ai/v1"
    # ✅ 使用 MixRoute API 地址
)

​
正确的配置方法

​
方法一：修改 Base URL（推荐）

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-mixroute-key",  # MixRoute 后台获取的 API Key
    base_url="https://api.mixroute.ai/v1"  # 改为 MixRoute API 地址
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)

​
方法二：使用环境变量

export OPENAI_API_KEY="sk-your-mixroute-key"
export OPENAI_BASE_URL="https://api.mixroute.ai/v1"

​
支持的请求地址格式

格式地址适用场景
带 /v1（推荐）https://api.mixroute.ai/v1大多数代码库
带 /v1/（末尾斜杠）https://api.mixroute.ai/v1/某些框架要求
完整路径https://api.mixroute.ai/v1/chat/completionscURL 请求

​
快速测试方法

使用 cURL 命令快速验证配置是否正确： 
curl https://api.mixroute.ai/v1/models \
  -H "Authorization: Bearer sk-your-mixroute-key"
预期结果：返回可用模型列表 
{
  "data": [
    {
      "id": "gpt-4o",
      "object": "model"
    }
  ]
}
如果返回错误，请检查：
  1. API Key 是否正确复制（注意首尾空格）
  2. 网络连接是否正常
  3. 账户余额是否充足

​
常见问题排查

可能原因：
  1. 拼写错误：确认地址拼写正确
  2. 缓存问题：重启程序或清除缓存后重试
  3. 使用了代理或中间件：某些代理工具可能会重定向请求
  4. 代码中有多处配置：检查配置文件、环境变量、代码初始化等
在 MixRoute 后台查看：
  1. 登录 MixRoute 控制台
  2. 进入「令牌」页面
  3. 检查 Key 状态是否为「启用」
  4. 确认账户余额充足
大多数第三方工具都有「自定义 API」选项：