ima 自訂模型設定：API Key、介面位址與排錯
在有自訂模型入口的 ima 用戶端填寫 API Key、Base URL 與模型 ID，完成儲存與切換。排查認證失敗、模型不存在和請求失敗，並區分聊天模型與知識庫 API 設定。
本教學說明如何讓 ima 呼叫外部聊天模型 API。請使用有「新增自訂模型」入口的版本；電腦與手機的選單位置可能不同。API Key 與 Base URL 應來自同一服務商，模型 ID 請從目前可用清單複製。舊截圖的型號只用於展示設定位置。請勿填入完整的 /chat/completions 請求 URL，也不要重複加入 /v1。先保留預設長度並傳送一個簡短問題；成功儲存設定不等於已成功呼叫 API。
ima 自訂模型設定：API Key、介面位址與排錯
步驟1：開啟模型選擇入口
在ima copilot的對話介面底部，找到「DS 快速」按鈕（如圖1紅框），點選它展開模型選擇選單。
圖片展示了行動版ima應用介面，位於“步驟2：進入‘新增自訂模型’”步驟的上下文位置
步驟2：進入“新增自訂模型”
在模型選單中，找到「新增自訂模型」按鈕，點選它進入自訂模型設定頁。
圖片展示的是行動版新增自訂模型的介面
步驟3：選擇模型廠商（可選“自訂”）
在“新增自訂模型”頁面，點選「模型廠商」下拉式選單（如圖4），可選擇預設廠商（如DeepSeek、Kimi、智譜等）；若需串接第三方/自建模型，選擇「+ 自訂」（預設已選“自訂”，可直接跳過此步）。
這張圖片呈現的是新增自訂模型時選擇模型廠商的介面，對應教學裡的「步驟3：選擇模型廠商」相關內容
步驟4：填寫模型核心資訊
在設定頁中，需填寫3項關鍵內容（如圖5紅框）：
- 介面位址：輸入模型的API介面位址（例如範例中的
https://api.llm-token.cn/v1，需替換為你要串接的真實介面）。 - API Key：輸入模型的API金鑰（格式類似
sk-xxxxxx...，需從模型服務供應商處取得）。 - 模型名稱：輸入模型的名稱（例如
gpt-5.5、claude-sonnet-4-6，需與介面支援的模型名一致）。
進階設定（輸入/輸出長度）可保持“使用預設值”，無需修改。
這是新增自訂模型的設定介面，用於完成ima的自訂模型設定操作
步驟5：儲存自訂模型
填寫完畢後，點選右上角「儲存」按鈕（如圖5手指指引），自訂模型會自動新增到「自訂模型」清單中（如圖6，新模型claude-opus-4-8已成功新增並可切換）。
後續使用：切換自訂模型
回到模型選擇選單（步驟1的「DS 快速」按鈕），在「自訂模型」清單中即可看到你新增的模型（如圖6），點選即可切換使用~
圖片展示的是行動版模型選擇選單介面
ima 自訂模型請求失敗怎麼辦？
| 現象 | 優先檢查 |
|---|---|
| 認證失敗或 401 | Key 是否完整、有效，且屬於目前介面位址的服務商。 |
| 模型不存在或無權存取 | 模型 ID 是否與目前清單一致，該 Key 是否有權限。 |
| 404 或找不到介面 | Base URL 是否誤填完整請求路徑，或重複出現 /v1/v1。 |
| 儲存成功但傳送失敗 | 是否切換至新設定，以及餘額、服務狀態與網路。 |
| 簡短問題成功、長內容失敗 | 輸入與輸出長度、上下文預算及服務商限制。 |
向服務商回報時，提供請求時間、模型 ID、完整錯誤與請求 ID（如有），並隱藏 API Key。
自訂模型與 ima 知識庫 API 有何差異？
本設定是讓 ima 呼叫外部聊天模型。若要讓外部 Agent 讀寫 ima 知識庫，應另外核對官方介面、認證與存取權限；儲存聊天模型不會完成該項設定。
如何確認模型 ID 與費用？
從服務商目前的模型目錄複製準確 ID，分別查看輸入、輸出與快取計費。不要從舊截圖推斷目前的可用型號或費用。
即時模型與計費方式
輸入、輸出與快取輸入可能採用不同單價。圖片、影片或按次計費的模型請確認計費單位。模型 ID 與價格以即時定價頁為準，實際扣款以帳單紀錄為準。