opencode

opencode.json内の1つのプロバイダーブロック — チャット補完には@ai-sdk/openai-compatible、/v1/responsesサーフェスを使う場合は@ai-sdk/openai。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 200000, "output": 64000 }
        },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    }
  }
}

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. 次の値をエクスポートします。export KUNAVO_API_KEY=sk-kn-...
3. プロバイダーブロックをopencode.jsonに追加します。すべてのプロジェクトに適用する場合はグローバル設定の~/.config/opencode/opencode.jsonに、現在のリポジトリだけに適用する場合はプロジェクトルートにあるファイルに追加します。
4. opencodeを起動し、モデル一覧からモデルを選択します。プロバイダーは、指定したnameの下に表示されます。
5. 後からモデルを追加する場合は、modelsの下に別のキーを追加します。IDは実際のリクエストで使われ、nameはラベルとしてのみ使われます。

opencodeのプロバイダーに関するドキュメントで2026年9月6日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがopencodeで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。