先執行此 curl 測試
在修改程式碼之前,請先讓應用程式靠邊站。此單一指令會向 API 發送最小有效請求:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models 不收費,因此是測試金鑰的安全方式。-i 標記會列印狀態行和標頭。
- 200 和模型列表:金鑰正常。你的應用程式發送了不同的內容,請前往環境變數和 Base URL 章節。
- 401: 金鑰或標頭有誤。繼續下一節。
- 連接或 DNS 錯誤:Base URL 錯誤,這是與 401 不同的問題。
手動將金鑰貼入此測試,不要透過變數。這樣可以將環境從嫌疑列表中排除。
原因 1:標頭不完全正確
API 期望收到 Authorization: Bearer <key>。些微偏差都會導致 LLM API 錯誤 401:
Authorization: YOUR_KEY缺少 Bearer 字詞。Authorization: Bearer: YOUR_KEY多了一個冒號。Authorization: Bearer "YOUR_KEY"值內有引號。Authorization: Bearer YOUR_KEY有兩個空格。- 標頭名為
X-API-Key或api-key而非Authorization。這些是其他服務的慣例。
如果你使用 OpenAI SDK,則不需要自行撰寫標頭。SDK 會從 api_key 參數建構它。如果仍然看到 401,則傳遞給 SDK 的值有問題,而非標頭格式。
原因 2:金鑰本身已損壞
金鑰是長隨機字串,因此複製錯誤很常見且難以肉眼發現。
- 尾隨換行符或空格。 從終端機或文字檔案複製時通常會添加一個。許多 HTTP 庫隨後會發送無效的標頭或無法匹配的金鑰。
- 截斷的金鑰。 如果金鑰包含會中斷單詞選擇的字元,雙擊僅選擇字串的一部分。請改用 API 金鑰頁面 上的複製按鈕。
- 智慧引號。 透過文字處理器或聊天應用程式貼上時,可能會將直引號替換為彎引號。
- 舊金鑰或已旋轉的金鑰。 如果你建立了新金鑰,舊金鑰可能不再是你要使用的金鑰。
要檢查 Python 中的不可見字元,請列印值的 repr:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
如果第二行列印 False,則金鑰周圍有空格。讀取時請呼叫 .strip()。
原因 3:錯誤的 Base URL
這是將現有應用程式切換到新供應商時最常見的錯誤。你的金鑰僅對發行它的主機有效。此站點的 Base URL 為:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
兩種失敗模式反覆出現:
- 你設定了新金鑰但保留了舊的 Base URL。請求發送至舊供應商,該供應商拒絕它從未見過的金鑰並返回 401。錯誤文本隨後提及舊供應商,這是一個有用的線索。
- 你設定了新的 Base URL 但在環境中保留了舊金鑰。請求到達我們這裡,我們拒絕其他供應商的金鑰。
還要檢查路徑。Base URL 已以 /v1 結尾,因此 SDK 會在其後添加 /chat/completions。如果你手動建構 URL,完整路徑為 /v1/chat/completions,而非 /v1/v1/chat/completions。
原因 4:環境變數和配置文件
如果 curl 有效但你的應用程式失敗,則有某些東西向應用程式提供了與你認為不同的金鑰。
- 變數未匯出。 在 Shell 中,
API_KEY=abc python app.py可以運作,但單獨一行寫API_KEY=abc無法傳遞至子程序。請使用export。 - 被其他值遮蔽。 庫可以自動讀取
OPENAI_API_KEY。如果舊的金鑰設定在你的殼層配置文件中,它可能會覆蓋你的意圖。 - .env 文件中的引號。 某些載入器會將引號保留為值的一部分。如果你的金鑰被引號字元包裹,請移除它們或使用上述的 repr 檢查進行測試。
- 未重新啟動。 伺服器和筆記本在啟動時讀取環境變數。編輯後請重新啟動。
- 生產環境中的不同環境。 容器、CI 和託管儀表板各有自己的變數儲存區。在日誌中列印金鑰長度,而非金鑰本身。
證明配置的最小 Python 檢查
此腳本使用 OpenAI SDK,並在驗證失敗時清楚報告:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
如果輸出 X-Request-Id,請在聯繫 支援團隊 時附上,這有助於團隊找到您的請求。其他語言的相同檢查方法見 五種語言的快速入門指南。
401 與其他錯誤的區別
如果錯誤是其他類型,不要浪費時間在認證上。簡易對照表:
| 狀態碼 | 常見含義 | 檢查位置 |
|---|---|---|
| 401 | 金鑰遺失或無效 | 標頭、金鑰、Base URL |
| 429 | 速率限制或暫時過載 | 等待後重試;請參閱 文件了解限制 |
| 400 | 請求主體格式錯誤 | JSON、模型名稱、參數 |
| 404 | 路徑錯誤 | Base URL 與端點 |
也請檢查模型名稱。請精確使用uncensored;錯誤的模型 ID 會導致請求錯誤,而非 401。API 接受的端點與標頭等規格詳情,請見OpenAI 相容 API 規格頁面。
代理伺服器、瀏覽器與最後手段
兩種設定會導致看似神秘的 401 錯誤。
代理伺服器與閘道器
你的應用程式與 API 之間的反向代理、API 閘道器或無伺服器包裝器可能會遺失或重寫 Authorization 標頭。請使用 curl 從同一台機器進行測試並進行比較。某些框架僅將標頭轉寄至相同來源的主機,因此自訂的 fetch 包裝器在跨來源呼叫時可能會靜默遺失該標頭。
前端程式碼中的金鑰
直接從瀏覽器 JavaScript 呼叫 API 會讓任何開啟開發者工具的人取得金鑰,且瀏覽器也可能因跨來源原因封鎖請求,這些原因看起來像是認證錯誤。請將金鑰保留在伺服器上,讓前端呼叫您自己的端點,再由該端點附上金鑰呼叫 API。如果金鑰曾被貼到公開程式碼或截圖中,請更換它。
仍卡關
如果剛複製的金鑰在 curl 測試中仍傳回 401,請從 API 金鑰頁面重新產生金鑰,直接貼入指令,再試一次。如果失敗,請發送請求時間、端點和 X-Request-Id 回應標頭給支援團隊。訊息中不要傳送完整金鑰;首尾各四個字元就足以識別。
