U9 AI · DOCUMENTATION

OpenCode 串接指南

OpenCode 設定入口、位址填寫、模型選擇、驗收步驟與 MD 下載。

適用範圍與前提#

本頁提供 OpenCode 串接本站的設定說明。需要啟用的本站金鑰、可用餘額及協定相符的實際模型。2026-10-24 已核對官方資料，不代表每個客戶端版本與上游模型都已完成全流程測試。

設定步驟#

1. 將 provider 條目合併至既有 opencode.json，不覆寫其他供應商設定。
2. 使用 @ai-sdk/openai-compatible 連接 Chat Completions；Responses 須改用對應適配器並另行驗證。
3. 在啟動終端設定 U9AI_API_KEY，替換兩處模型 ID 佔位符；設定僅參照環境變數。
4. 啟動後選擇 u9ai 模型，在臨時專案驗證短對話、串流及工具呼叫。

設定值對照#

{
  "$schema": "https://opencode.ai/config.json",
  "model": "u9ai/YOUR_CHAT_MODEL_ID",
  "provider": {
    "u9ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "U9 AI",
      "options": {
        "baseURL": "https://u9ai.ai/v1",
        "apiKey": "{env:U9AI_API_KEY}"
      },
      "models": {
        "YOUR_CHAT_MODEL_ID": {
          "name": "U9 Chat"
        }
      }
    }
  }
}

此工具的注意事項#

此為 Chat Completions 範本，不以模型名稱含 codex 作為協定依據。上下文與輸出限制應依實際規格填入，請勿套用其他模型數值。

驗收與交接#

先依快速開始執行唯讀 GET /v1/models，確認驗證與目錄。再分別驗收短文字非串流、串流及所需的完整工具呼叫往返。生成測試可能扣款，請保存請求編號並核對消費分析。失敗時在工單提供版本、模型 ID、端點、狀態碼及已遮蔽敏感資訊的錯誤；請勿盲目重送逾時任務。

可將本 MD 交給開發者或 Agent，要求保留原設定、僅替換可用模型並明確回報未驗證項。真實金鑰請勿寫入共享 MD。

官方參考#

OpenCode