常見錯誤現象
當您看到類似以下錯誤訊息时，通常是請求地址（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": "你好"}]
)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-mixroute-key',
baseURL: 'https://api.mixroute.ai/v1'
});
const response = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好' }]
});
curl https://api.mixroute.ai/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://api.mixroute.ai/v1"
$env:OPENAI_API_KEY="sk-your-mixroute-key"
$env:OPENAI_BASE_URL="https://api.mixroute.ai/v1"
set OPENAI_API_KEY=sk-your-mixroute-key
set 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/completions | cURL 請求 |
快速測試方法
使用 cURL 命令快速驗證配置是否正確：
curl https://api.mixroute.ai/v1/models \
-H "Authorization: Bearer sk-your-mixroute-key"
{
"data": [
{
"id": "gpt-4o",
"object": "model"
}
]
}
- API Key 是否正確複製（注意首尾空格）
- 網路連線是否正常
- 帳戶餘額是否充足
其他常見問題
可能原因：
- 拼寫錯誤：確認地址拼寫正確
- 快取問題：重啟程式或清除快取後重試
- 使用了代理或中間件：某些代理工具可能會重定向請求
- 程式碼中有多處配置：檢查配置檔案、環境變數、程式碼初始化等
在 MixRoute 後台查看：
- 登入 MixRoute 控制台
- 進入「API 密鑰管理」頁面
- 檢查 Key 狀態是否為「啟用」
- 確認帳戶餘額充足
大多數第三方工具都有「自訂 API」選項：
- API 地址 / Base URL：
https://api.mixroute.ai/v1
- API Key：從 MixRoute 控制台 複製您的 Key
- 模型名稱：參考模型廣場列表
