連線模型服務商

AI Reader 使用你在設定裡選中的服務商。能用哪些模型、怎麼計費，都由你的服務商帳號決定。瀏覽和搜尋檔案不需要這個連線。

新增服務商

開啟Settings → Models，點加號Add Provider，再把新建的設定選為Current provider。名稱起一個自己認得出的就行，比如「團隊閘道器」。名稱只是個標籤，不影響使用哪種 API。

然後填寫：

欄位	填什麼
API 型別	服務實際使用的協議：OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages
端點	服務地址，包括閘道器要求的路徑字首
認證方式 / API Key	你的 API Key，或該服務商提供的帳號登入
模型	帳號能用的準確模型 ID

API Key 只在設定裡填寫，不要貼到對話或專案檔案裡。有些服務商支援帳號登入、不需要 Key；如果支援，在Sign-in method裡選擇即可。

端點要和 API 型別對上

模型名稱看不出協議：同一個閘道器可能透過不同的 API 提供名字相近的模型。請按服務文件選擇 API 型別，並保留必要的路徑字首。

下面的地址只用來演示 Yenpo 怎麼拼接請求 URL，不是真實可用的服務：

API 型別	端點示例	實際請求 URL
Chat Completions	https://gateway.example/v1	https://gateway.example/v1/chat/completions
Responses	https://gateway.example	https://gateway.example/v1/responses
Messages	https://gateway.example	https://gateway.example/v1/messages

如果端點已經以 /chat/completions、/responses 或 /messages 結尾，Yenpo 會原樣用於對應的 API 型別。Responses 和 Messages 遇到以 /v1 結尾的端點，會補上最後一段路徑。Chat Completions 則總是在你填的地址後面直接加 /chat/completions，不會幫你補上缺失的 /v1。

遇到錯誤時，別靠來回切換 API 型別碰運氣。先弄清服務支援哪種協議、完整的請求路徑應該是什麼。

模型 ID

可以直接在Model裡輸入 ID；服務提供模型清單的話，也可以點Fetch List。拉取清單和呼叫模型是兩個不同的請求，清單拉不下來時，模型本身可能照樣能用，直接填文件裡的 ID 試試。

Context length會影響 Yenpo 的輸入和輸出預算，以及何時壓縮對話、壓縮後保留多少上下文。填寫所用模型公佈的視窗上限；留空時使用 Yenpo 的預設值。填得太小可能造成不必要的壓縮，太大可能讓請求超出模型實際能接收的範圍。

Pricing用於計算執行詳情中顯示的估算費用，按服務商公佈的價格填寫。它不會改變服務商的實際收費，也不會授予模型存取權限。第一次連通之前，其他模型參數先別動。

每個服務商的圖片輸入預設關閉。只有模型和 API 都支援你要傳送的圖片時，再開啟Accept images。

用一個小問題測試

開啟一個允許發給這個服務的小檔案，問：

輸入為空時，這個函式返回什麼？請引用對應的分支。

能收到回答，說明連線沒問題。回答對不對是另一回事，要回到程式碼裡核對。

請求裡除了你的訊息，還會帶上 AI Reader 從專案裡找到的相關程式碼，不只是你輸入的文字。往遠端端點傳送保密程式碼之前，請先讀資料去向、編輯權限與終端。

請求失敗時

現象	檢查方向
認證或權限錯誤	目前帳號或 Key、端點屬於哪個服務、模型權限
找不到資源或 API 不支援	API 型別、完整請求路徑、閘道器字首
找不到模型	模型 ID 是否準確，帳號能否使用
拉取模型失敗	服務是否提供模型清單；改為直接填寫文件中的模型 ID
超時或流式響應中斷	網路、代理或閘道器、服務是否可用

只憑一個 HTTP 狀態碼很難判斷原因，閘道器也可能改寫上游返回的錯誤。回報問題時，請附上錯誤訊息、API 型別和隱去私密部分的端點地址，不要附帶 API Key。

如果中斷的是一次允許編輯的執行，重試之前先檢查專案裡的改動。即使沒收到最終回答，檔案也可能已經被改過。