常見錯誤現象
當您看到類似以下錯誤訊息時：
{
"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。
Base URL 和 API Key 必須一一對應
| 服務提供商 | Base URL | API Key 格式 | 是否匹配 |
|---|
| Mixroute Api | https://console.mixroute.io | sk-xxxx… | ✅ 正確 |
| OpenAI 官方 | https://api.openai.com | sk-xxxx… | ✅ 正確 |
| ❌ Mixroute Key | https://api.openai.com | sk-xxxx… | ❌ 錯誤 |
| ❌ OpenAI Key | https://console.mixroute.io | sk-xxxx… | ❌ 錯誤 |
關鍵原則：使用哪家的 API Key，就必須將請求發送到對應服務商的 Base URL
正確的配置方法
方法一：修改 Base URL（推薦）
from openai import OpenAI
client = OpenAI(
api_key="sk-your-mixroute-key", # Mixroute Api 後台獲取的 Key
base_url="https://console.mixroute.io/v1" # 改為 Mixroute Api 地址
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}]
)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-mixroute-key',
baseURL: 'https://console.mixroute.io/v1'
});
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好' }]
});
curl https://console.mixroute.io/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-mixroute-key" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}'
方法二：使用環境變數
Linux/macOS
Windows PowerShell
Windows CMD
export OPENAI_API_KEY="sk-your-mixroute-key"
export OPENAI_BASE_URL="https://console.mixroute.io/v1"
$env:OPENAI_API_KEY="sk-your-mixroute-key"
$env:OPENAI_BASE_URL="https://console.mixroute.io/v1"
set OPENAI_API_KEY=sk-your-mixroute-key
set OPENAI_BASE_URL=https://console.mixroute.io/v1
支援的請求地址格式
| 格式 | 地址 | 適用場景 |
|---|
| 帶 /v1（推薦） | https://console.mixroute.io/v1 | 大多數程式庫 |
| 帶 /v1/（末尾斜線） | https://console.mixroute.io/v1/ | 某些框架要求 |
| 完整路徑 | https://console.mixroute.io/v1/chat/completions | cURL 請求 |
常見問題排查
可能原因：
- 拼寫錯誤：確認地址拼寫正確
- 快取問題：重啟程式或清除快取後重試
- 使用了代理或中間件：某些代理工具可能會重定向請求
- 程式碼中有多處配置：檢查配置檔案、環境變數、程式碼初始化等
大多數第三方工具都有「自訂 API」選項：
- API 地址 / Base URL：
https://console.mixroute.io/v1
- API Key：從 Mixroute Api 後台複製您的 Key
- 模型名稱：參考模型列表
錯誤示例 vs 正確示例
❌ 錯誤配置
client = OpenAI(
api_key="sk-mixroute-key",
base_url="https://api.openai.com/v1"
# ❌ 使用了 OpenAI 官網地址
)
✅ 正確配置
client = OpenAI(
api_key="sk-mixroute-key",
base_url="https://console.mixroute.io/v1"
# ✅ 使用 Mixroute Api 地址
)
快速測試方法
使用 cURL 命令快速驗證配置是否正確：
curl https://console.mixroute.io/v1/models \
-H "Authorization: Bearer sk-your-mixroute-key"
{
"data": [
{
"id": "gpt-4o",
"object": "model"
}
]
}
- API Key 是否正確複製（注意首尾空格）
- 網路連線是否正常
- 帳戶餘額是否充足
記住核心原則：哪家的 Key 配哪家的 URL，Mixroute Api 的 Key 就用 https://console.mixroute.io/v1
