OpenCode AI Gateway：通過一個API連接多個LLM

一個OpenCode AI閘道俾你喺你嘅終端工作流程同你真正想用嘅模型之間提供一個穩定嘅API層。如果你要處理唔同供應商嘅密鑰、唔同嘅賬單頁面同唔同嘅可用性風險，呢個額外層可以令OpenCode每日運行更加容易。.

ShareAI好適合呢個角色，因為佢俾你一個API去連接150+模型，加埋智能路由、故障切換同市場可見性。OpenCode已經支持自定義OpenAI兼容供應商，所以設置主要係指向OpenCode嘅正確基礎URL同添加你想用嘅模型。.

呢份指南係我哋 洞察 關於AI路由、模型訪問同生產準備集成嘅文章。.

點解一開始要用OpenCode AI閘道？

OpenCode設計係支持多個供應商，佢嘅公開文檔顯示支持自定義供應商配置、自定義 baseURL 值同OpenAI兼容端點。呢個靈活性好強大，但亦意味住你可能需要分開管理每個供應商，而你真正想要嘅只係一個乾淨嘅編碼工作流程。.

• 一個API密鑰代替每個模型供應商一個密鑰。.
• 一個賬單界面代替多個儀表板。.
• 更乾淨嘅模型切換，用於快速編輯、長上下文任務或者更重嘅重構。.
• 一個路由層可以幫助當供應商速度慢、不可用或者唔再適合呢份工作嘅時候。.

對於想要靈活性但唔想維護分開供應商管道嘅開發者，通常呢個時候AI閘道開始顯示佢嘅價值。.

OpenCode點樣支持呢個設置

根據官方嘅 OpenCode供應商文檔, ，你可以通過自定義供應商設置 opencode.json, ，設置一個自定義 baseURL, ，並使用 @ai-sdk/openai-compatible 用於兼容OpenAI嘅供應商。公開嘅 OpenCode GitHub 儲存庫 都記錄咗佢嘅配置路徑，並確認咗呢個工具係為供應商層面嘅靈活性而設計嘅。.

呢即係話你唔需要一個特別嘅ShareAI集成包就可以開始使用。你可以添加ShareAI作為自定義供應商，將API密鑰保存在環境變量中，然後選擇你想要OpenCode調用嘅具體模型。.

第一步：創建你嘅ShareAI API密鑰並選擇一個模型

首先喺 創建一個API密鑰. 中生成憑證。然後瀏覽 來自ShareAI模型市場 去決定邊個模型應該支持你嘅OpenCode工作流程。.

一個實用嘅模式係選擇一個默認模型用於日常編碼任務，並記住一兩個備選方案，以應對你需要更低延遲、更低成本或者更強推理模型嘅情況。.

第二步：喺opencode.json中添加ShareAI作為自定義供應商

OpenCode 俾你可以用 OpenAI 兼容嘅端點嚟定義自訂供應商。一個簡單嘅起始模板係咁樣嘅：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

替換 你嘅-shareai-模型 用你想喺 ShareAI 模型目錄入面用嘅準確模型識別碼。唔好將 API key 放喺文件入面，改用環境變量嚟載入。.

export SHAREAI_API_KEY="your_api_key_here"

如果你想要更廣泛嘅請求格式同認證詳情， API 參考 涵蓋咗核心嘅 ShareAI API 流程。.

第三步：喺唔需要重建設置嘅情況下切換模型

一旦 ShareAI 成為供應商層，模型更改就會變得更加輕鬆。你唔需要每次想測試唔同模型時都重新處理供應商認證。相反，你可以保持相同嘅 API 表面，然後改變 OpenCode 指向嘅模型。.

呢個特別適合當你嘅編碼工作流程因應任務而改變嘅時候。你可能會想要一個模型嚟快速編輯，另一個嚟處理較大嘅倉庫推理，第三個喺成本或者延遲比峰值能力更重要嘅時候作為備選。你可以喺 模型市場 比較選項，並喺 遊樂場 進行合理性檢查行為，然後再鎖定一個默認值。.

當直接供應商密鑰仍然有意義嘅時候

仲有啲情況直接使用係合理嘅。如果你依賴供應商特定嘅測試功能、私人企業協議或者嚴格嘅供應商內部治理設置，你可能會想保持嗰條路徑分開。.

但對於主要希望 OpenCode 保持靈活、可移植同易於操作嘅團隊嚟講，使用 OpenCode AI 閘道通常係更清晰嘅默認選擇。佢減少咗賬戶分散，並俾你可以根據性能同適合度嚟評估模型，而唔係根據你最近配置嘅供應商登錄。.

最後嘅重點

OpenCode AI gateway唔係為咗加多啲工具而加，而係保持一個編碼工作流程，同時畀自己空間去改變模型、比較供應商，喺基礎模型環境改變時繼續前進。如果呢個係你喺OpenCode想要嘅，ShareAI通過一個API畀你一個實際嘅方法去做到。.