Janitor AI proxy 通常不是 VPN,也不是用來隱藏 IP 的工具;它本質上是通往 LLM API 的請求路徑。要讓設定正常運作,端點、精確模型 ID 與 API Key 必須屬於同一個服務供應商;若再加上一層反向 proxy,就等於多了一台伺服器,也多了一個必須信任的環節。
先決定請求路徑,再開啟 Janitor AI
對多數人來說,直接使用相容 OpenAI 的 API 端點,是最單純的 Janitor AI proxy 設定方式。像 OpenRouter 這類聚合平台,適合想透過單一帳號存取多種模型的人;反向 proxy 則適合你自行掌控中繼服務,或必須串接私有、本機後端的情境。
| 路徑 | 請求流程 | 誰負責處理請求? | 設定負擔 | 適合作為起點? |
|---|---|---|---|---|
| 直連 API | Janitor AI → 供應商或閘道 | 端點營運方及其上游模型供應商 | 低 | 是,適合一般外部 API |
| 聚合平台 | Janitor AI → 模型聚合平台 → 選定模型 | 聚合平台及其上游供應商 | 低至中 | 是,適合需要多種模型選項時 |
| 反向 proxy | Janitor AI → 你的中繼服務 → 供應商或本機模型 | 你、中繼服務主機及上游供應商 | 中至高 | 僅限你能掌控中繼服務時 |
別把共用的「免費 proxy」當成直連 API。共用中繼可能讀取經過它的流量、隨時停止服務,或要求你交出本來就不該提供的憑證。使用供應商自己的端點搭配該供應商 API Key,則是完全不同的安排。
Janitor AI Proxy 欄位到底該填什麼
在 Janitor AI 的 Proxy 表單中,最重要的是三項與路徑綁定的資料:端點 URL、精確模型 ID 與 API Key。三者都必須來自同一個供應商或同一個中繼服務。
| Janitor AI 欄位 | 應填內容 | 常見問題 |
|---|---|---|
| Configuration Name | 任意辨識名稱,例如 AIReiter GPT-5.6 Luna | 修改這個標籤不會切換模型 |
| Model Name | 供應商目前使用的精確模型 ID | 顯示名稱、大小寫不同,或過期的 :free 後綴,都可能造成模型錯誤 |
| Other API/Proxy URL | 該路徑要求的端點格式 | SDK 可接受的 base URL,不一定能直接填進 Janitor AI 的 proxy 欄位 |
| API Key | 為同一端點或中繼服務建立的金鑰 | 其他供應商的 Key、已撤銷的 Key,或多了一個空白字元的 Key 都會失敗 |
完整請求 URL 與 SDK 的 base URL 不一定能互換。相容 OpenAI 的 SDK 通常使用像 https://example.com/api/v1 這樣的 base URL,再自行附加 /chat/completions。Janitor AI 的 proxy 欄位可能要求最終完整 URL,也就是 https://example.com/api/v1/chat/completions,因此請以端點針對該用戶端提供的說明為準。
Janitor AI 另外還有角色層級的 proxy 使用權限。Janitor AI 在一則官方版主公告中說明,勾選 Allow Proxy 後,其他人才能透過 proxy 使用該 bot,因為 proxy 會接收到 bot 資訊。若角色僅限 OpenAI 與 JanitorAI 選項,就無法透過外部 proxy 使用。這項權限與你的 API Key 是否有效是兩回事。
五分鐘完成 Janitor AI 設定
建立一組設定後,儲存、重新整理,再用簡短提示詞測試,就能快速區分問題是出在端點、模型 ID 還是 API Key。
1. 建立供應商 API Key
請向你準備貼入 Janitor AI 的 URL 所屬供應商或閘道建立 API Key。在服務顯示金鑰時立即複製,將它以機密資料保存,絕對不要貼在截圖、Discord 訊息、瀏覽器擴充功能或共用 proxy 表單中。
即使模型標示為免費,仍可能需要供應商 API Key。「免費」通常只是描述該模型在該供應商目前的價格或額度,不代表 Janitor AI 不經驗證就能呼叫模型。
2. 開啟 Proxy 面板
在 Janitor AI 開啟角色聊天,找到 API Settings。選擇 Proxy,再按下 Add Configuration 或對應功能。介面標籤與位置可能調整,請參考 Janitor AI 的官方 Help Center 帳號與設定分類取得目前產品指引。
使用者曾回報 Janitor AI 的 proxy UI 欄位有所更動,也可能要求必填模型欄位。(使用者回報範例)
3. 填入資料、儲存、重新整理並測試
所有資料都要來自同一條請求路徑。不要把某服務的端點、另一個服務複製來的模型 ID,以及第三個帳號的 Key 混在一起填。
- 替設定取一個容易辨識的名稱。
- 從供應商即時模型頁面或模型清單貼上精確模型 ID。
- 貼上 Janitor AI proxy 欄位要求的完整端點。
- 貼上相符的 API Key。
- 儲存設定。
- 重新整理或重新開啟 Janitor AI 分頁,然後送出一則簡短測試訊息。
如果角色沒有啟用 proxy,請先改用允許 proxy 的角色,再開始排查端點問題。有效的供應商設定無法覆蓋創作者設定的 proxy 限制。
AIReiter 設定:已驗證的 OpenAI 相容路徑
使用 AIReiter 時,請在 Janitor AI 的 Proxy URL 欄位填入最終 Chat Completions URL,而非較短的 SDK base URL。AIReiter 的 GPT-5.6 整合指南列出 Chat Completions 路徑為 /api/v1/chat/completions,以 gpt-5.6-luna 作為範例模型,並清楚區分用戶端 base URL 與由用戶端自行附加的路徑。
可先以下列設定作為起點:
| Janitor AI 欄位 | AIReiter 值 |
|---|---|
| Configuration Name | AIReiter GPT-5.6 Luna |
| Model Name | gpt-5.6-luna |
| Other API/Proxy URL | https://aireiter.com/api/v1/chat/completions |
| API Key | 你的 AIReiter API key |
以下是各端點的差異:
- Janitor AI Proxy URL:
https://aireiter.com/api/v1/chat/completions - OpenAI-compatible SDK base URL:
https://aireiter.com/api/v1 - 模型清單檢查:
https://aireiter.com/api/v1/models
請勿將 /api/v1/models 填入 Janitor AI;這是用來確認模型 ID 是否可用的診斷路徑。AIReiter 指南提供以下自我檢查方式:
curl -sS "https://aireiter.com/api/v1/models" \
-H "Authorization: Bearer $AIREITER_API_KEY"
若回應中沒有 gpt-5.6-luna,請使用清單回傳的精確模型 ID,並更新 Janitor AI 設定。測試模型 ID 問題時,端點與 Key 不要更動。
AIReiter 採用隨用隨付計費,而非方案分級,因此 API Key 對應帳號仍須具備可用餘額。若要依賴頁面顯示的費率,請先查看目前的 AIReiter 價格頁面;聊天成本取決於輸入與輸出 token,而不只是訊息數量。
OpenRouter 與其他供應商:沿用同一張表單邏輯
切換供應商時,Janitor AI 表單本身不變,但端點、Key 與模型 ID 必須一起替換。OpenRouter 的官方快速入門說明其相容 OpenAI 的 API,而它的目前模型目錄則是複製即時模型 ID 的正確來源。
| 欄位 | OpenRouter 填寫方式 |
|---|---|
| Model Name | 從 OpenRouter 模型目錄複製目前的精確 ID |
| Other API/Proxy URL | https://openrouter.ai/api/v1/chat/completions |
| API Key | 在你的 OpenRouter 帳號建立的 Key |
像 :free 這類模型後綴應視為即時可用性標籤,而不是永久設定資料。免費模型可能下架、受到速率限制或改名;儲存 Janitor AI 設定前,請立即複製最新 ID。
一則官方 Janitor AI 版主討論串連結了 Janitor 的 proxy/OpenRouter 快速入門與疑難排解資料,同時也區分 Janitor 整合問題,以及供應商的計費與帳號支援問題。若是直連供應商,請將這三項路徑資料全部換成該供應商自己的端點、Key 與模型 ID。
反向 proxy 還是直連 API:安全性如何取捨
直連路徑的環節最少:驗證、限制、計費、日誌與隱私政策都由供應商或閘道處理。反向 proxy 則新增一個中繼層,它可以在請求抵達上游模型前檢查、轉換、記錄或拒絕流量。
只有在你確實需要自行營運反向 proxy 時才應使用,例如透過已驗證的 HTTPS 中繼服務連接私有後端,或統一不同供應商的協定。私有 localhost URL 只有在實際發出請求的元件也運行於同一台機器時才有效;若請求是由 Janitor AI 伺服器發出,它的伺服器無法連到你電腦上的 localhost。需要這種架構時,請使用正確驗證的公開 HTTPS 中繼服務。
若中繼服務由你掌控,請遵守以下清單:
- 要求使用 HTTPS,並為中繼服務設定獨立驗證 token。
- 將上游供應商 Key 保留在中繼服務上,不要貼到未知的共用服務。
- 關閉詳細請求本文日誌,或設定明確記錄且保存時間短的保留政策。
- 限制允許連線的上游主機與請求方法。
- 確認中繼服務是否轉送標頭、對話紀錄與角色資料。
- 一旦懷疑憑證外洩,立即撤銷並更換憑證。
以下真實使用者警告說明了為何匿名中繼服務值得審慎看待:
「if u use the moxxie proxy on janitor ai please stop using it !! whoever used that proxy your chats have gotten leaked and so has your ip address...」 — @Ash3rz_c0m,X 使用者警告,2023 年 6 月(來源)
這是使用者回報的事件,並不能證明每個反向 proxy 都具惡意。但對於營運者、資料保留方式與事件紀錄都無法驗證的中繼服務,不應提供真正的供應商 Key 或私密對話內容。
依照失敗環節診斷錯誤
大多數 Janitor AI proxy 錯誤都能透過分層測試更快定位。先確認 Janitor AI 內建模型是否能回應,接著逐一驗證設定值,最後才排查額度或供應商故障。
| 症狀或狀態碼 | 可能出問題的層級 | 第一步檢查 |
|---|---|---|
400 或「invalid model」 | 請求或模型選擇 | 複製即時的精確模型 ID;確認大小寫、供應商前綴及所有後綴 |
401 Unauthorized | 驗證 | 撤銷可疑 Key、建立替代 Key、移除空白字元,並確認 Key 屬於該端點供應商 |
402 或付款/額度訊息 | 帳號餘額或使用資格 | 檢查點數、計費狀態與供應商目前的免費額度 |
404 或「model not found」 | URL 或模型路徑 | 將完整端點路徑與模型 ID 對照供應商目前文件 |
429 | 速率或用量限制 | 等待、降低請求頻率、改用可用模型,或視情況儲值 |
500、502、503 或逾時 | 上游或中繼服務可用性 | 稍後重試、查看供應商狀態,並盡可能測試不經自訂中繼的路徑 |
| 「Failed to fetch」或網路錯誤 | 瀏覽器、端點、CORS 或無法連線的中繼服務 | 重新確認 HTTPS、完整 URL,以及中繼服務是否可由公開網路存取 |
不同供應商對狀態碼的定義可能不同,因此回應本文的優先級更高。模型名稱錯誤不是重新產生 Key 就能解決;已撤銷的 Key 也不會因為調整 temperature 而恢復。
社群回報也說明模型 ID 必須保持最新。在一則 Janitor AI 新手討論串中,u/Puzzleheaded-Town350 發文表示:
「I get this message ‘proxy error 400 open-mistral-nemo-2407 is not a valid model’」 — r/JanitorAI_Official 的 u/Puzzleheaded-Town350
新設定失敗時,請按以下順序檢查:
- 測試 Janitor AI 內建模型,區分是平台問題還是 proxy 問題。
- 確認角色允許使用 proxy。
- 確認最終端點 URL;若路徑需要,必須包含
/chat/completions。 - 從供應商即時清單確認精確模型 ID。
- 確認 Key 與端點相符,且仍具備權限或可用餘額。
- 先用預設生成設定重試,再調整 temperature 或 token 限制。
隱私與帳號衛生
端點可能接收提示詞、對話紀錄、模型選擇資料,有時也包括角色資訊。請檢視你所選直連供應商、聚合平台或中繼服務的隱私條款與資料保留設定。
若 Key 可能已外洩,請立即撤銷、建立替代 Key、從 Janitor AI 設定中移除舊值,並查看使用紀錄。不要繼續使用已外洩的 Key 來測試它是否還能運作。
Janitor AI proxy 常見問題
Janitor AI proxy 是 VPN 嗎?
不是。它會將聊天請求路由到外部 LLM;VPN 改變的是網路路由,並不會提供語言模型。
使用免費模型還需要 API Key 嗎?
通常需要。供應商即使不對模型或額度收費,仍可能要求帳號專屬 Key。
我該填完整 URL,還是只填 /api/v1?
請填 Janitor AI Proxy 欄位要求的最終 URL。以 AIReiter 為例,應填 https://aireiter.com/api/v1/chat/completions;/api/v1 是 SDK base URL。
為什麼某個角色拒絕透過 proxy 運作?
可能是角色創作者停用了 proxy 使用。有效的外部 Key 無法覆蓋這項設定。
Janitor AI 能直接呼叫 localhost 嗎?
只有在發出請求的元件與本機伺服器運行於同一台機器時才行。否則,請使用適當保護的公開 HTTPS 中繼服務,而非暴露未經驗證的本機服務。
先前能用的模型 ID 為何突然失效?
供應商會調整模型可用性、別名、額度與免費層級標籤。請先重新檢查即時模型清單並更新模型欄位。
共用免費 proxy 安全嗎?
不要先入為主地認為安全。營運者可能讀取請求或擷取憑證;優先選擇直連供應商路徑,或使用由你營運且可稽核的反向 proxy。
從一把私密 API Key、一個精確模型 ID 與一條完整端點開始。直連 API 在簡單性上勝出;只有當你確實需要掌控中繼或上游連線時,反向 proxy 的維護成本才值得投入。