ドキュメント

ドキュメント

Obsidian向けCopilot

CopilotのBYOKタブでは、3つのフィールドを使ってカスタムのOpenAI互換プロバイダーを設定できます。設定したモデルがどの機能で使えるかについては、ドキュメントに明確な記載があります。このページでもその範囲を正確に説明し、プラグイン全体で使えるとは断言しません。

Settings → Copilot → BYOK → Add a custom provider:Display name、キー、https://api.kunavo.com/v1を設定 — Quick Chatでは常に利用でき、プロバイダーが表示される場合はopencode配下のAgent Chatでも利用できます。

Settings → Copilot → BYOK → Add a provider → Add a custom provider
Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint
ここではベースURLに/v1のサフィックスを付けます。ドキュメントでは文章による規則ではなく例によって確認できます。説明は「カスタムのOpenAI互換プロバイダーにはBase URLが必要です」のみですが、付属する2つのOpenAI互換テンプレートのデフォルトURLはどちらも末尾が/v1です。Ollamaはhttp://localhost:11434/v1、LM Studioはhttp://localhost:1234/v1で、さらに「モデルの検出にはエンドポイントの/v1/modelsレスポンスを使用します」と記載されています。モデルが見つからない場合は、まずこの2点を見直してください。
BYOKプロバイダーはプラグインのすべての機能で使えるわけではなく、ドキュメントにも明記されています。「キーを追加しても、Claude CodeまたはCodexが提供するモデルは変わりません。」付属の表では、BYOKモデルはQuick Chatで利用でき、Agent Chatではopencodeバックエンドの場合に限り、「そこにプロバイダーが表示されている場合」に利用できるとされています。これは条件であって、常に利用できるという意味ではありません。また、「opencodeがルーティングできないモデルはopencodeの一覧から除外されますが、Quick Chatでは引き続き使える場合があります。」ClaudeまたはCodexバックエンドを使う場合は、代わりに各CLIの環境設定を変更します。/docs/integrations/claude-codeを参照してください。
Enable CORSは妥協を伴う設定であり、常時オンにしておく解決策ではありません。ドキュメントにはこうあります。「Testは成功するのにQuick Chatからメッセージを送信できない場合は、プロバイダーを編集してEnable CORSをオンにしてください。応答はトークンごとにストリーミングされず、完了後に表示されます。」また、この設定はopencodeのルーティングには影響しないとも記載されています。つまり、Quick Chatを修復するためにオンにすると、トークンごとの出力が失われるのはQuick Chatだけです。
Copilot 4.xでは埋め込みプロバイダーは不要です。セマンティック検索は別サービスのMiyoに移行しており、BYOKダイアログにも該当するフィールドはありません。これは当然のことで、Kunavoは埋め込みモデルを提供していません。このページでも、埋め込みモデルがあるかのような説明はしません。
Kunavoでは、このプラグインを実行環境でテストしていません。上記の各フィールドと引用は、下記の日付時点でCopilot独自のドキュメントを確認したものです。設定ページが公開されていても、実際にテストしたことにはなりません。ワークフローを移行する前に、Quick Chatから実際のタスクを1つ送信してください。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Obsidian向けCopilot設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. ObsidianでSettings → Copilot → BYOKを開き、Add a providerをクリックします。
  3. プロバイダー名の選択肢やSelf Hostテンプレートではなく、Add a custom providerを選択します。
  4. 前述のとおり、Display name、API key、Base URLを入力します。ひとまずEnable CORSはオフのままにします。
  5. モデルを1つ以上追加します。Model ID → Addの下にIDを入力するか、GET /v1/modelsから取得したモデル一覧が表示されるSearch available modelsから選択します。TestをクリックしてからSaveをクリックします。モデルとルーティング可能なエンドポイントの両方が揃うまで保存できません。
  6. Basic → Agents → Quick ChatとBasic → Agents → opencodeで、モデルを表示する場所を調整します。それぞれに独自のDefault modelがあります。新しいチャットモデルは、デフォルトで両方の機能で有効になります。

CopilotのModel SourcesとBYOKのページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — は実際にトークンの料金が発生するCopilotのバックエンドにあります。

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

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

# 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で、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Obsidian向けCopilotでの位置付け
claude-haiku-4-5$0.70 / $3.50ノートについての短い質問を日常的に行うQuick Chat
claude-sonnet-5$1.40 / $7.00Agent Chatのopencodeバックエンド — デフォルトの作業用モデル
claude-opus-5$3.50 / $17.50多数のノートを横断する長い要約。誤読した場合の影響が大きい用途
gpt-5-6-sol$2.00 / $12.00同じキー、同じプロバイダー設定で、別系統のモデルからセカンドオピニオンを得る
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

Obsidian CopilotではAPIキーをどこに入力しますか?

Settings → Copilot → BYOK → Add a providerを開き、組み込み一覧にないエンドポイントの場合は「Add a custom provider」を選びます。ダイアログではDisplay name、API key、Base URL、任意のEnable CORSスイッチを設定します。また、検出された一覧から選ぶかIDを入力して、少なくとも1つのモデルを追加してからSaveをクリックします。Copilotのドキュメントによると、プロバイダーキーはvaultのdata.jsonではなく、そのデバイスのObsidian Keychainに保存されます。そのため、vaultを同期しても認証情報は別のコンピューターに引き継がれません。

Obsidian CopilotのベースURLの末尾に/v1は必要ですか?

末尾に/v1を付けてください。Kunavoの場合はhttps://api.kunavo.com/v1です。ドキュメントは規則を一文で説明していません。カスタムのOpenAI互換プロバイダーにはBase URLが必要であること、モデルの検出ではエンドポイントの/v1/modelsレスポンスを使うこと、付属する2つのOpenAI互換テンプレートのデフォルトがhttp://localhost:11434/v1とhttp://localhost:1234/v1であることを記載しています。付属するデフォルト値はどちらもサフィックス付きで、これはドキュメントが示す最も強い根拠です。ベースURLが間違っている場合、通常は認証エラーではなく、モデル一覧が空になるかTestが失敗します。

Obsidian Copilotでは、ベンダーのキーの代わりにOpenRouterやKunavoのようなゲートウェイを使えますか?

Quick Chatでは使えます。Agent Chatでは条件付きで使えます。Copilotのドキュメントでは、BYOKを「AIプロバイダー、互換ゲートウェイ、またはコンピューター上のモデルサーバーに直接接続すること」と説明しており、「Add a custom provider」では、任意のOpenAI互換ベースURLとモデルIDを設定できます。そのモデルソース表では、BYOKモデルはQuick Chatで利用でき、Agent Chatではopencodeバックエンドの場合に限り、「そこにプロバイダーが表示されている場合」に利用できます。ClaudeとCodexのバックエンドではBYOKキーを使えません。ドキュメントには、キーを追加しても各バックエンドが提供するモデルは変わらないと記載されています。

Obsidian Copilotのvault検索には埋め込みモデルが必要ですか?

チャットプロバイダーのものは必要ありません。Copilot 4.xでは、プラグイン内で独自のインデックスを作成しなくなりました。ドキュメントによると、セマンティック検索とRelevant Notesは別のローカルまたはリモートサービスであるMiyoが提供し、BYOKダイアログにその種のモデル用フィールドはありません。Kunavoも埋め込みモデルを提供していないため、ここで埋め込みモデルを提供すると受け取れる説明はありません。Copilotのチャットプロバイダー設定で支払われるのはチャット分のみです。

KunavoのキーでCopilot LiteまたはPlusのライセンスを置き換えられますか?

いいえ。両者は意図的に別枠です。Copilotのドキュメントでは、ライセンスとBYOKは異なるモデルソースとして扱われています。ライセンスではBrevilabsがプランに応じて課金するCopilotホストのモデルが提供され、BYOKでは独自のエンドポイントにリクエストを送り、課金はそのプロバイダー側に発生します。ここでキーを使っても、ライセンスの利用枠は補充されず、ロックされたCopilotホストのモデルは解除されず、ライセンスが必要なサービスも変わりません。反対に、ライセンスなしで無料プランからBYOKを利用できます。