Android 手機 AI 模型 API 設定：供應商、模型 ID、圖片與工具測試
在 FoneClaw 使用預設模型或相容線上 API，設定供應商預設、Base URL、API Key 與模型 ID，再分別驗證文字、圖片理解和 Android 工具，釐清模型退場與手機權限問題。
- FoneClaw 可使用內建免費預設模型，也可設定相容線上模型；自訂路線需要供應商的 API 存取資格，聊天 App 訂閱不等於 API 額度或帳戶權限。
- 供應商預設、API Base URL、API Key 與模型 ID 各有用途；圖片和工具支援設定必須符合端點與模型實際能力，開啟選項不會讓模型取得原本沒有的功能。
- 依序測試短文字、自選圖片和一項低風險 Android 工具；文字回覆成功，只能證明基本通訊可用，不能代替圖片或工具測試。
- 模型棄用與退場屬供應商維護，Android 權限則屬手機執行條件。更換模型後要重新驗證能力，並查看先前任務的實際結果，再重試未完成操作。
先選模型路徑：使用預設模型或接入自己的 API
設定 Android 手機 AI 模型 API，先決定是否需要自行連接供應商。FoneClaw 有兩條路徑：直接使用內建免費預設模型，或在 FoneClaw 內設定相容線上模型，讓該模型負責理解、推理與規劃。自訂路線需要供應商提供的 API 端點、憑證與可用模型；購買某個聊天 App 的訂閱，不代表已取得同品牌 API 的存取資格或計費額度。
這個分工很重要。模型回答「下一步應該開啟地圖」是一回事；FoneClaw 能不能呼叫支援的 Android 工具、是否需要權限、是否要你確認，以及結果是否可見，是另一回事。模型負責理解與規劃，已啟用的手機工具則依權限、App 狀態與實際核准政策執行。
| 路徑 | 需要準備 | 適合情境 | 注意事項 |
|---|---|---|---|
| 使用免費預設模型 | 不需要自行提供 API Key | 想先熟悉 FoneClaw 的手機任務流程 | 從低風險任務確認工具與權限 |
| 設定相容線上模型 | 供應商 API 資格、Base URL、API Key、模型 ID | 已有 API 帳戶，想選擇模型能力或成本 | 分別驗證端點相容性、圖片理解與工具呼叫 |
若你還不熟 Android 手機代理如何從自然語言變成可見動作，可先讀AI 代理控制 Android 手機指南：從意圖到確認、執行、驗證與復原。那篇說明執行層、工具、權限與結果；本篇聚焦模型 API 設定與驗證。
供應商預設、Base URL、API Key 與模型 ID 各代表什麼
FoneClaw 的供應商預設可協助配置線上模型，但預設本身不會建立供應商帳戶，也不證明你的金鑰能使用某個模型。API Base URL 指向相容服務的基礎端點；API Key 用來驗證請求；模型 ID 則指定該端點實際提供的模型。這些資料必須彼此對應。
API Base URL 不是品牌名稱，也不是文件首頁。它通常是供應商指定的 HTTPS 端點，路徑與請求格式都要符合文件。Google 的Gemini API 相容性說明就是一個例子：供應商可以提供相容介面，但仍會使用自己的端點、憑證與模型名稱。原生 API 與相容介面也可能不同，不能只改品牌名稱就沿用設定。
API Key 應像密碼一樣保護，不要放在公開截圖、螢幕錄製、共享文件或客服貼文中。OpenAI 的API 驗證說明也將金鑰用於請求驗證。排錯時提供狀態碼與已遮蔽的設定資訊即可，無須公開完整金鑰。
| 設定 | 用途 | 要核對的內容 |
|---|---|---|
| 供應商預設 | 協助配置供應商連線 | 是否符合實際使用的服務與端點 |
| API Base URL | 指定相容服務端點 | HTTPS、路徑與請求格式 |
| API Key | 驗證 API 請求 | 帳戶、專案、有效性及使用資格 |
| 模型 ID | 指定要呼叫的模型 | 端點列出的精確識別碼，而非顯示名稱 |
| 圖片／工具支援 | 讓配置符合模型能力 | 模型與端點是否真的支援圖片輸入或工具呼叫 |
API 憑證只能處理模型服務的存取，不能授予 Android 權限。即使模型連線成功，手機動作仍取決於 FoneClaw 支援工具、系統權限與核准設定。
在 FoneClaw 設定供應商與模型能力
在 FoneClaw 的模型配置中，可使用適合的供應商預設，再核對 Base URL、API Key 和模型 ID。圖片與工具支援控制也已提供；應依所選模型及端點的文件設定，而不是為了讓測試通過就全部開啟。具備視覺能力的相容模型才能理解圖片，工具呼叫也須由模型與介面共同支援。
- 先決定使用預設模型，還是已有 API 存取資格的相容供應商。
- 選擇適用的供應商預設，或依文件配置相容端點。
- 核對 Base URL、API Key 與精確模型 ID，避免多餘空白或換行。
- 依供應商文件確認圖片與工具呼叫能力，設定相應支援選項。
- 儲存並選用該模型，再依序測試文字、圖片與工具。
- 若文字測試就失敗，先排查 API 配置，不必立即修改 Android 權限。
所選大尺寸圖片可在輸入流程中最佳化並校正方向，但這些處理不會替文字模型增加視覺能力。使用線上模型時，交給模型的文字、圖片或任務脈絡可能離開手機；測試可選擇不含私人資料的圖片。
如果你正在比較供應商與模型路由，可延伸閱讀Kimi K3、DeepSeek V4 與 GLM-5.2：手機 Agent 該如何選模型。設定完成與模型適合你的任務，仍要分別驗證。
分別測試文字、圖片與 Android 工具
第一步是無害的短文字請求，例如「請只回覆：連線測試收到」。收到預期文字，表示該次請求的端點、憑證與模型基本通訊可用；模型自行聲稱「已連線」並不能額外證明圖片或工具能力。
第二步才測圖片。選一張內容容易核對、沒有私人資料的照片，請模型描述其中兩個可見物件。確認回答確實對應圖片，而不是泛泛推測。若文字正常、圖片失敗，先查視覺能力、端點圖片格式與圖片支援設定，不要先去開手機工具權限。
第三步測一項已啟用的低風險 Android 工具，例如查詢目前媒體音量或藍牙狀態。查看是否真的執行工具並取得狀態結果，不能只看模型寫出的建議。這一步才涉及工具呼叫格式、FoneClaw 工具啟用狀態、Android 權限及實際核准政策。
| 測試 | 可核對的結果 | 通過後仍須另測 |
|---|---|---|
| 短文字 | 收到符合要求的回覆 | 圖片與工具能力 |
| 自選圖片 | 描述與圖片內容一致 | Android 工具執行 |
| 低風險狀態工具 | 有實際工具結果，且狀態可核對 | 其他工具及寫入操作的條件 |
若你想理解模型推理與手機執行的差異，可參考DeepSeek 手機 AI Agent 能控制 Android 手機嗎？推理模型與手機 AI Agent 的差別。三項測試各自通過，才有足夠資訊判斷目前配置能做什麼。
排除驗證、端點、模型能力與手機權限錯誤
排錯時先找出失敗在哪一層。API 驗證或端點問題通常在文字回覆前出現；圖片能力問題可能只在加入圖片後發生；Android 權限與 App 狀態問題則常在工具執行時出現。不同供應商的錯誤格式可能不同，狀態碼應與回覆內容及官方文件一起看。
| 症狀 | 先核對 | 下一步 |
|---|---|---|
| 401 或驗證失敗 | 金鑰、帳戶、專案與有效性 | 確認憑證及 API 存取資格，勿公開金鑰 |
| 404 或找不到模型 | Base URL 路徑、精確模型 ID、帳戶可用模型 | 依該端點文件修正，不用品牌顯示名稱代替 ID |
| 模型棄用或退場提示 | 供應商生命週期與實際停用日期 | 區分仍可呼叫的棄用模型與已退場模型 |
| 逾時或連線延遲 | 網路、服務狀態與請求大小 | 先用短文字確認，再恢復其他測試 |
| 文字正常、圖片失敗 | 視覺能力、圖片格式與支援設定 | 核對模型及端點文件，不靠切換選項補足能力 |
| 文字正常、工具呼叫失敗 | 模型工具能力、相容格式與工具啟用狀態 | 先確認請求能到執行層，再查系統權限 |
| 工具被權限或政策阻擋 | Android 權限、App 狀態與核准政策 | 處理明確缺少的條件，不必因此更換 API Key |
模型服務成功回覆、手機操作卻受阻，是可以同時發生的情況。想深入看權限與核准如何管理，可讀AI 代理身份與權限治理：逐工具核准、稽核紀錄與 FoneClaw Android 控制。若確認是供應商暫時故障，Android AI 助理模型故障復原指南：安全重試、模型備援與避免重複手機操作則處理備援與重試情境。
更換模型前，確認能力與退場時程
選模型時，除了成本、延遲與資料處理政策，也要查看模型 ID 是否仍在服務，以及圖片和工具能力是否符合你的任務。以Anthropic 官方模型生命週期說明為例，claude-sonnet-4-5-20250929於 2026 年 9 月 30 日列為棄用，預定於 2026 年 11 月 30 日退場，官方建議替代模型為 claude-sonnet-5-5。棄用期間仍可運作，退場後的請求才會失敗；不能把兩個日期視為同一件事。
這個例子的日期適用於 Anthropic 營運的平台，合作平台可有自己的時程與模型識別碼。官方推薦替代模型，也不證明原生 Anthropic Messages API 能直接套用到 FoneClaw 所配置的相容端點。遷移時要重新確認供應商實際提供的模型、請求協定、Base URL 與能力設定，再做文字、圖片和工具三項測試。
如果你也在評估模型 App 與手機控制的差別，可看Grok 能控制 Android 手機嗎？通話、主要助理入口與 FoneClaw 模型設定解析。對 FoneClaw 使用者而言，選定模型負責理解與規劃，手機執行條件仍由已啟用工具、權限和政策決定。
重測設定，再恢復未完成的手機動作
更換供應商或模型後，先完成三項能力測試，再恢復原本任務。可以先查詢一個手機狀態，確認新模型能透過支援工具取得結果。FoneClaw 依實際工具政策處理核准，並非每個步驟都固定要求同一種確認。FoneClaw 功能介紹可供核對目前支援的手機能力。
如果先前任務包含寄送郵件、建立事件或其他寫入，重試前先打開目標 App 或帳戶查看：內容是否已寄出？事件是否已存在？只有回覆中斷，不代表操作沒有完成。保留已確認結果，只重試未完成部分；需要逐層復原時，可參考手機 AI 代理失敗除錯與復原指南：根因分析、權限修復與安全重跑。安裝資訊可查看FoneClaw 下載頁，API 設定則仍以所選供應商的相容文件為準。