ドキュメント
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でも利用できます。
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/v1のサフィックスを付けます。ドキュメントでは文章による規則ではなく例によって確認できます。説明は「カスタムのOpenAI互換プロバイダーにはBase URLが必要です」のみですが、付属する2つのOpenAI互換テンプレートのデフォルトURLはどちらも末尾が/v1です。Ollamaはhttp://localhost:11434/v1、LM Studioはhttp://localhost:1234/v1で、さらに「モデルの検出にはエンドポイントの/v1/modelsレスポンスを使用します」と記載されています。モデルが見つからない場合は、まずこの2点を見直してください。/docs/integrations/claude-codeを参照してください。sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Obsidian向けCopilot設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- ObsidianでSettings → Copilot → BYOKを開き、Add a providerをクリックします。
- プロバイダー名の選択肢やSelf Hostテンプレートではなく、Add a custom providerを選択します。
- 前述のとおり、Display name、API key、Base URLを入力します。ひとまずEnable CORSはオフのままにします。
- モデルを1つ以上追加します。Model ID → Addの下にIDを入力するか、
GET /v1/modelsから取得したモデル一覧が表示されるSearch available modelsから選択します。TestをクリックしてからSaveをクリックします。モデルとルーティング可能なエンドポイントの両方が揃うまで保存できません。 - Basic → Agents → Quick ChatとBasic → Agents → opencodeで、モデルを表示する場所を調整します。それぞれに独自のDefault modelがあります。新しいチャットモデルは、デフォルトで両方の機能で有効になります。
CopilotのModel SourcesとBYOKのページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。
クライアントをデバッグする前に確認すること
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で、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | Obsidian向けCopilotでの位置付け |
|---|---|---|
claude-haiku-4-5 | $0.70 / $3.50 | ノートについての短い質問を日常的に行うQuick Chat |
claude-sonnet-5 | $1.40 / $7.00 | Agent 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を利用できます。