Dashboard 模型

要更換預設對話模型，或補上圖片、影片與語音能力，開啟 Dashboard 的 Models。這裡儲存 Profile 預設路由；已有對話的模型選擇需要在該工作階段中另行修改。

從哪張卡片開始

anyy dashboard

進入 Models 後按任務選擇：

想做什麼	分類/卡片
先接通日常對話	Text → Main model
增加故障時的備用目標	Text → Add fallback
理解或產生圖片	Image
理解影片	Video
設定聽寫和聲音回覆	Voice → STT/TTS

卡片會顯示 provider/model，以及 primary、enabled、disabled、unavailable 等狀態。卡片狀態和目錄條目不能確認實際產生回覆，需要儲存後在對話裡另做驗證。

完成一組連線設定

點選 Main model，頁面會根據目前服務商契約顯示真實可用的欄位：

1. 選擇 Provider 型別；
2. 如果有多個服務或協定，選擇對應 Service 和 Protocol；
3. 選擇認證方式；
4. 輸入 API Key，或完成支援的訂閱登入；
5. 保留預設 Base URL，或填寫可信的相容位址；
6. 重新整理模型目錄，必要時切換成手動輸入模型 ID；
7. 選擇模型和預設推理設定；
8. 用 Test connection 檢查目錄可存取、所選模型存在，然後 Save；
9. 建立 Chat 工作階段，核對選中的 provider/model，傳送「請回復：連線已確認」，確認收到真實回答。驗證時暫時停用已設定 fallback，測後復原原設定；若保留 fallback，則必須核實回答實際來自所測目標且未退回。選擇器顯示目標名稱並收到回覆，還不能單獨證明該目標產生成功。

右側設定預覽只展示非敏感設定。已經儲存的 API Key 不會以明文完整顯示。

目錄檢查和真實回答分開確認

更改 Provider、Endpoint、認證資料或模型後，可以用 Test connection 檢查待儲存設定或已儲存認證資料對應的目錄。這個按鈕只查目錄連通和模型是否存在，不執行對話產生；顯示 connected 後，仍要按上面的新工作階段步驟確認實際回答。

API Key 與訂閱登入

同一詳情頁會根據服務商提供相應操作：

• 新增或替換 API Key；
• 清除已儲存的 Key；
• 發起或重新進行 OAuth/訂閱登入；
• 登出目前訂閱帳號。

認證與實際 Endpoint 綁定。切換服務或協定後，可用認證資料範圍和模型目錄也可能變化。Codex 使用訂閱裝置登入；Anthropic 的 Claude Code 訂閱選項接受外部取得的 setup token，不能據此推斷所有 OAuth 服務都可用。目錄和登入成功仍需分別驗證實際模型請求。

目前五類對話協定及未實現的其他原生協定見服務商協定與模型介面。

什麼時候需要 Fallback

在 Text 分類點選 Add fallback，設定獨立 provider/model，檢查目錄後儲存。再到新工作階段明確選中這個目標，傳送一則短提示，並按主模型相同方式停用 fallback 或確認回答未退回，測後復原原設定。備用卡片上的目錄檢查不能代替這一步。

fallback 按儲存順序嘗試。每一項可以啟用/停用，並控制：

• 是否允許丟棄目標無法回放的推理歷史；
• 是否允許使用更小上下文視窗；
• 該 fallback 的最大嘗試次數（包括該目標的第一次嘗試）。

不再需要的目標應進入詳情頁明確移除。

fallback 是可用性路由

它不會同時詢問多個模型，也不會合併多個答案。它是在錯誤策略允許且目標相容時，為執行環境提供有順序的替代路徑；工具、媒體、推理歷史和上下文要求可能使某項被跳過。Session 自動重試和 Provider SDK 重試另行控制。

給圖片和影片選擇路徑

如果主模型目錄明確宣告支援相應輸入，影像理解和影片理解可以自動走主模型；否則需要選擇專用 provider/model。

理解類路由還可以設定：

• 功能啟用狀態；
• auto 或 summary_first；
• 專用提示詞；
• Token/字元上限；
• 逾時；
• thinking 行為。

summary_first 必須有專用路由。手動填寫的未知模型不會被 Anyy 自動視為具有圖片或影片能力，應先測試。

影像產生屬於輸出路由，有自己的 provider/model、預設寬高比、逾時和位元組上限。產品影像產生目前要求 OpenAI Responses，不能只憑一般 OpenAI-compatible Chat Endpoint 工作；它與 Codemode 的 openrouter-images 模型介面分別設定。

聽寫與聲音回覆

Voice 中包含：

• TTS：Provider、模型、協定、音色、自動語音行為和試聽；
• STT：Provider、模型、協定、預設語言和連線測試。

文字對話可用，並不意味著該服務商的語音 Endpoint 也可用。TTS 協定為 audio-speech 或 chat-audio-output；STT 為 audio-transcriptions 或 chat-audio-input。填寫 API 根位址，並讓協定匹配模型。只啟用已經測試通過的路由，詳見語音與聽寫。

儲存後到哪裡驗證

Dashboard 透過目前 Gateway 儲存設定。建立工作階段使用已儲存的主模型；已有 Chat 工作階段可能保留自己的 provider/model 與推理狀態，直到你在工作階段裡切換或建立工作階段。

需要純終端機設定方式，請閱讀模型設定。

常見問題

現象	處理方法
模型清單為空	檢查認證與 Base URL，再點 Refresh models
Test connection 失敗	核對 Endpoint、認證資料、模型 ID 和帳號權限
Main model 顯示 unavailable	核對詳情裡的目錄連線和儲存路由，再在新 Chat 工作階段驗證回覆是否成功產生
顯示 connected，聊天卻失敗	connected 僅表示目錄檢查成功；檢視真實產生錯誤，核對模型權限、Endpoint 和認證資料
圖片/影片要求專用模型	主模型未宣告對應輸入能力，或選擇了 summary_first
Chat 裡看不到剛儲存的模型	建立工作階段，或在目前工作階段明確切換
訂閱狀態過期	重新認證；必要時先登出，再連線正確帳號