繁中 ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
取得 API 金鑰

LLM API 錯誤 401:解決驗證失敗問題

LLM API 錯誤 401 代表伺服器無法驗證您的請求。在幾乎所有情況下,問題出在客戶端:標頭輸入錯誤、金鑰包含雜字元,或請求發送至錯誤的主機。本指南將依能最快找出問題的順序,逐步說明檢查步驟。

更新

金鑰無法插入閃亮鎖頭,說明呼叫 LLM API 時發生認證失敗

重點摘要

  1. 401 是驗證失敗,不是速率限制或帳單錯誤。
  2. 標頭必須完全為 Authorization: Bearer YOUR_KEY,含一個空格且不含引號。
  3. 發送至錯誤 Base URL 的金鑰會像錯誤的金鑰一樣失敗。
  4. 先使用 curl 測試;如果 curl 有效,則錯誤在於應用程式的配置。

先執行此 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 回應標頭給支援團隊。訊息中不要傳送完整金鑰;首尾各四個字元就足以識別。

問答

401 代表我的預付額度已用完嗎?

不是。401 是關於認證的問題:金鑰遺失、格式錯誤或未知。預付額度耗盡是另一種狀況。

為什麼同一個金鑰在 curl 可以運作,但在我的應用程式卻不行?

您的應用程式可能讀取了不同的值,例如舊的環境變數、帶引號的 .env 條目或包含尾端空白的金鑰。請印出您程式碼實際使用的金鑰長度與 repr。

我可以將 OpenAI 金鑰用於這個 API 嗎?

不行。每個金鑰僅對發行該金鑰的主機有效。請使用 API 金鑰頁面上的金鑰,並搭配此站點的 Base URL。

401 會扣費嗎?

不會。失敗或被拒絕的請求不會收費。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰