OpenCode 與 APIMaster.ai

OpenCode Desktop 是 OpenCode 的圖形化用戶端（目前為 Beta 版）：支援本地代理工作階段、檔案編輯和 Shell 執行。APIMaster.ai 是 OpenAI 相容的服務 — 可在 設定 → 提供者 → 自訂提供者 中新增。

請先取得您的 API 金鑰。下方使用佔位符 your_apimaster_key；螢幕截圖已遮蓋真實金鑰。

---

先決條件

1. 從 opencode.ai/download 安裝 OpenCode Desktop。
   • Windows：opencode-desktop-win-x64.exe
   • macOS：brew install --cask opencode-desktop 或 .dmg
   • Linux：.deb / .rpm / AppImage
2. 從控制台取得 APIMaster API 金鑰。

---

步驟 1 — 開啟提供者

1. 啟動 OpenCode Desktop 並開啟一個工作區。
2. 按一下齒輪圖示（左下角）。
3. 在側邊欄中選取 Providers（提供者）。
4. 向下捲動到 Custom provider（自訂提供者）（通過 Base URL 新增 OpenAI 相容的提供者）。
5. 按一下 + Connect（連線）。

---

步驟 2 — 自訂提供者表單

欄位	值
Provider ID（提供者 ID）	apimaster
Display name（顯示名稱）	APIMaster.ai
Base URL	https://apimaster.ai/v1
API key（API 金鑰）	您的 APIMaster 金鑰

除非僅透過 Header 進行驗證，否則請將 Headers 保留空白。

---

步驟 3 — 新增模型並提交

在下一個畫面中，對應模型（左側 = OpenCode 中的標籤，右側 = 發送給 APIMaster 的 模型 ID — 通常相同）：

左側	右側
gpt-5.4	gpt-5.4
claude-sonnet-4-6	claude-sonnet-4-6

1. 按一下 + Add model（新增模型）以增加更多行。
2. 按一下 Submit（提交）。

從市集挑選 ID。在代理對話中避免使用僅圖像模型（例如 gpt-image-2）。

---

步驟 4 — 選擇模型

1. 開始或開啟一個工作階段。
2. 開啟輸入欄下方的模型下拉選單。
3. 在 APIMaster.ai 下方，選擇一個模型（例如 claude-sonnet-4-6）。

---

步驟 5 — 測試

發送 hello 或一個小型程式碼任務。正常取得 Assistant 回覆（檔案編輯 / Shell）表示 APIMaster 已連線。

---

進階：opencode.jsonc 與推理

上述 UI 流程已足夠快速入門。若要為相同的模型 ID 設定推理／思考努力層級（low、high、max 等），請編輯 opencode.jsonc。

設定檔位置

作業系統	路徑
macOS / Linux	~/.config/opencode/opencode.jsonc
Windows	C:\Users\<username>\.config\opencode\opencode.jsonc

如果檔案不存在，請建立它。儲存後請重新啟動 OpenCode Desktop 或開始一個新的工作階段。

API 金鑰（請勿放入 jsonc）

請勿將您的 API 金鑰存放在 opencode.jsonc 中。

請使用：

• 終端機中的 /connect，或
• 設定 → 提供者 → 連線提供者（與上述步驟 1–2 相同）。

將金鑰存放在 OpenCode 的驗證儲存區；jsonc 僅定義提供者、模型和推理變體。

jsonc 中的 APIMaster 提供者

提供者 ID：apimaster。npm 套件：@ai-sdk/openai-compatible。

baseURL 必須是：

https://apimaster.ai/v1

不是 https://apimaster.ai/ — OpenCode 會附加 /chat/completions。沒有 /v1 時會變成 https://apimaster.ai/chat/completions → 404 找不到。

包含推理變體的完整範例 — 下載並覆蓋 OpenCode 的設定檔：

1. 下載 opencode.jsonc
2. 覆蓋（或另存為）：
   • macOS / Linux：~/.config/opencode/opencode.jsonc
   • Windows：C:\Users\<username>\.config\opencode\opencode.jsonc
3. 透過 /connect 或 UI 設定 API 金鑰（絕不放在 jsonc 中）。
4. 重新啟動 OpenCode Desktop 或開始一個新的工作階段。

覆蓋前請備份現有檔案，或僅合併 provider.apimaster 區塊。

最小範例：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apimaster": {
      "name": "APIMaster.ai",
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://apimaster.ai/v1" },
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4",
          "variants": {
            "low": { "reasoningEffort": "low" },
            "high": { "reasoningEffort": "high" }
          }
        }
      }
    }
  }
}

推理原則

• variants = UI 中為一個模型 ID 提供的多個推理層級。
• 對於 OpenAI 相容的 API，OpenCode 將 reasoningEffort 映射為請求體中的 reasoning_effort。
• 變體名稱應與實際參數相符（high → "reasoningEffort": "high"）。
• 每個模型支援不同的層級 — 請依照官方文件設定；沒有隱藏的重新對應。

各模型的推理層級

模型	推理變體	備註
gpt-5.4	low, medium, high, xhigh	GPT 推理
gpt-5.5	low, medium, high, xhigh	GPT 推理
deepseek-v4-flash	high, max	DeepSeek 思考（建議）
deepseek-v4-pro	high, max	DeepSeek 思考（建議）
claude-sonnet-4-6	low, medium, high, max	Claude Sonnet 努力
claude-opus-4-7	low, medium, high, xhigh, max	Claude Opus 努力
claude-opus-4-8	low, medium, high, xhigh, max	Claude Opus 努力
claude-haiku-4-5	無	無未確認的努力層級
minimax-m3	無