OpenCode AIゲートウェイ：1つのAPIで複数のLLMを接続

OpenCode AIゲートウェイは、ターミナルワークフローと実際に使用したいモデルの間に安定したAPI層を提供します。別々のプロバイダーキー、別々の請求ページ、別々の可用性リスクを管理している場合、その追加層によりOpenCodeを日々の運用でより簡単に使用できるようになります。.

ShareAIはその役割に適しており、150以上のモデルに対応する1つのAPIを提供し、スマートルーティング、フェイルオーバー、マーケットプレイスの可視性を備えています。OpenCodeはすでにカスタムOpenAI互換プロバイダーをサポートしているため、セットアップは主にOpenCodeを適切なベースURLに向け、使用したいモデルを追加することに関するものです。.

このガイドは私たちの 開発者 AIルーティング、モデルアクセス、そして本番環境対応の統合に関する記事の一部です。.

そもそもなぜOpenCode AIゲートウェイを使用するのか？

OpenCodeは多くのプロバイダーと連携するよう設計されており、その公開ドキュメントではカスタムプロバイダー設定、カスタム baseURL 値、そしてOpenAI互換エンドポイントのサポートを示しています。その柔軟性は強力ですが、実際にはクリーンなコーディングワークフローを求めている場合、すべてのプロバイダーを個別に管理することになりかねません。.

• モデルベンダーごとにキーを持つ代わりに1つのAPIキー。.
• 複数のダッシュボードの代わりに1つの請求画面。.
• モデル間の切り替えがよりスムーズになり、迅速な編集、長いコンテキストタスク、または大規模なリファクタリングが可能。.
• プロバイダーが遅い、利用不可、またはそのジョブに最適でなくなった場合に役立つルーティング層。.

別々のプロバイダー管理を維持せずに柔軟性を求める開発者にとって、AIゲートウェイがその価値を発揮し始めるのは通常この段階です。.

OpenCodeがこのセットアップをサポートする方法

公式によると OpenCodeプロバイダーのドキュメント, 、プロバイダー設定をカスタマイズするには opencode.json, 、カスタムを設定し baseURL, 、そして使用する @ai-sdk/openai-compatible OpenAI互換プロバイダー用に。公開されている OpenCode GitHubリポジトリ には、その構成パスが記載されており、ツールがプロバイダーレベルの柔軟性を備えていることが確認されています。.

つまり、特別なShareAI統合パッケージを使用せずに開始できます。ShareAIをカスタムプロバイダーとして追加し、APIキーを環境変数に保持して、OpenCodeが呼び出すモデルを正確に選択できます。.

ステップ1: ShareAI APIキーを作成し、モデルを選択する

まず、で資格情報を生成します APIキーを作成する. 。次に、を閲覧して ShareAIモデルマーケットプレイスから OpenCodeワークフローをサポートするモデルを決定します。.

実用的なパターンとしては、日常のコーディングタスク用に1つのデフォルトモデルを選び、低遅延、低コスト、またはより強力な推論モデルが必要な場合に備えて1つまたは2つの代替案を考慮することです。.

ステップ2: 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キーはファイル自体に含めず、代わりに環境変数を通じて読み込むようにしてください。.

export SHAREAI_API_KEY="your_api_key_here"

より広範なリクエスト形式と認証の詳細が必要な場合、 APIリファレンス コアShareAI APIフローをカバーしています。.

ステップ3: セットアップを再構築せずにモデルを切り替える

ShareAIがプロバイダー層になると、モデル変更が非常に軽量化されます。異なるモデルをテストするたびにベンダー認証を再構築する必要がなくなります。同じAPI表面を維持し、OpenCodeが指すモデルを変更するだけです。.

これは、タスクによってコーディングワークフローが変化する場合に特に便利です。簡単な編集には1つのモデル、大規模なリポジトリの推論には別のモデル、コストや遅延がピーク能力よりも重要な場合には第3のモデルを使用することができます。オプションを比較するには、 モデルマーケットプレイス 動作を確認するには、 プレイグラウンド デフォルトを確定する前に行うことができます。.

直接プロバイダーキーがまだ有効な場合

直接利用が合理的な場合もあります。プロバイダー固有のベータ機能、プライベート企業契約、または厳格なプロバイダー内ガバナンス設定に依存している場合、そのパスを分離して保持することを検討してください。.

しかし、OpenCodeを柔軟性、移植性、操作の容易さを維持したいと主に考えるチームにとって、OpenCode AIゲートウェイを使用することがしばしば最適な選択肢となります。これによりアカウントの乱立を減らし、最後に設定したベンダーログインではなく、性能や適合性でモデルを評価することができます。.

最終的なまとめ

OpenCode AIゲートウェイは、単にツールを追加することを目的としたものではありません。一つのコーディングワークフローを維持しながら、モデルを変更したり、プロバイダーを比較したり、基盤となるモデルの状況が変化した際にも進み続ける余地を与えることを目的としています。もしそれがOpenCodeに求めるものであれば、ShareAIは1つのAPIを通じてそれを実現する実用的な方法を提供します。.