メインコンテンツまでスキップ

OpenCode / カスタムプロバイダー連携

api.aicu.ai は OpenAI 互換です。ベース URL とキーを差し替えるだけで、OpenCode・Cline・Continue など OpenAI 互換のコーディングツールから、kimi-k2.7-code（コーディング特化）や OpenAI 系モデルをそのまま使えます。

✅ 動作確認済み — Kimi-K2.7-Code（Powered by Sakura AI Engine, kimi-k2.7-code）を OpenCode v1.18.9 から api.aicu.ai 経由で実行し、コード生成の正常動作を確認しました（2026-07-29）。

接続情報​

項目値
ベース URLhttps://api.aicu.ai/v1
API キーaicu_live_xxx（ダッシュボードで発行。必須）
おすすめモデルkimi-k2.7-code（コーディング）、gpt-4o-mini、gpt-5.4-mini

認証は Bearer 方式です。OpenAI SDK / 各ツールが Authorization: Bearer <API キー> を自動で付与するので、API キー欄は必ず入力してください（空だと 401 になります）。

OpenCode（opencode.json）​

OpenCode は AI SDK の @ai-sdk/openai-compatible でカスタムプロバイダーを追加できます。プロジェクト直下（または ~/.config/opencode/）の opencode.json に AICU を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicu": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AICU API",
      "options": {
        "baseURL": "https://api.aicu.ai/v1",
        "apiKey": "{env:AICU_API_KEY}"
      },
      "models": {
        "kimi-k2.7-code": { "name": "Kimi-K2.7-Code (SAKURA)" },
        "gpt-4o-mini":    { "name": "GPT-4o mini" },
        "gpt-5.4-mini":   { "name": "GPT-5.4 mini" }
      }
    }
  }
}

キーの登録は TUI から行うのが簡単です。/connect を実行し、一覧の一番下 Other を選び、プロバイダー ID に aicu、続けて API キー（aicu_live_...）を貼り付けます。

$ opencode
> /connect        # Other → id: aicu → API キーを貼り付け
> /models         # aicu/kimi-k2.7-code などが選択肢に出る

{env:AICU_API_KEY} を使う場合は環境変数でも渡せます。

export AICU_API_KEY=aicu_live_xxx
opencode

モデル ID は GET /v1/chat/models が返す id と一致させてください。最新一覧はいつでも curl https://api.aicu.ai/v1/chat/models で確認できます。詳細な設定項目は OpenCode 公式ドキュメント（Custom provider）を参照してください。

画像入力を有効にする（マルチモーダル）​

kimi-k2.7-code はマルチモーダル対応ですが、OpenCode の @ai-sdk/openai-compatible 経由では、モデルの capabilities が自動取得できないため、デフォルトで画像入力が無効になっています。画像を添付しようとすると、this model does not support image input のようなエラーになります。

画像入力を使う場合は、各モデルに modalities を明示します。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicu": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AICU API",
      "options": {
        "baseURL": "https://api.aicu.ai/v1",
        "apiKey": "{env:AICU_API_KEY}"
      },
      "models": {
        "kimi-k2.7-code": {
          "name": "Kimi-K2.7-Code (SAKURA)",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "sakura-kimi": {
          "name": "Sakura Kimi (Kimi-K2.6)",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "gpt-4o-mini": { "name": "GPT-4o mini" },
        "gpt-5.4-mini": { "name": "GPT-5.4 mini" }
      }
    }
  }
}

modalities.input に image を含めると、OpenCode の read ツールで画像ファイルを読み込めるようになり、チャットへの画像添付も可能になります。output は現状 text のみが実用的です。

この設定が必要な理由：AICU API のモデル一覧（GET /v1/chat/models）は description に「マルチモーダル」と書いていますが、OpenCode が機械的に解釈できる modalities / capabilities 構造を返していないため、OpenCode は安全側に倒して「画像非対応」と判定します。AICU API 側でモデル一覧に modalities を追加できれば、ユーザーが個別に設定しなくても画像入力が有効になります。

アプリ版（カスタムプロバイダー設定）​

「OpenAI 互換のプロバイダーを設定」する UI では、以下のように入力します。

設定項目入力値
プロバイダーIDaicu（小文字・数字・ハイフン・アンダースコア）
表示名AICU API
ベースURLhttps://api.aicu.ai/v1
APIキーaicu_live_xxx（入力必須。空にしない）
モデル IDkimi-k2.7-code
モデル 名前Kimi-K2.7-Code
ヘッダー（オプション）不要（Authorization は自動付与）

UI の「APIキーは空のままでOK」という注記は、リクエストヘッダーを自前で管理する場合の説明です。api.aicu.ai は Bearer 認証なので、この欄にキーを入れてください。

料金の目安​

  • kimi-k2.7-code: α/preview 期間中は無料（熊本地震 支援、〜2026-10-31）。GA後の予定単価は 入力 11 / 出力 101 AP per 1K tokens。
  • OpenAI 系（gpt-4o-mini ほか）も α期間中は実課金なし。単価は LLM API の料金表を参照。

© 2026 AICU Inc.