Dokumentasi

Copilot untuk Obsidian

Tab BYOK Copilot menerima penyedia khusus yang kompatibel dengan OpenAI melalui tiga kolom. Dokumentasinya menjelaskan secara spesifik antarmuka mana yang dapat menggunakan model tersebut, dan halaman ini mempertahankan ketepatan itu alih-alih menjanjikan bahwa seluruh plugin dapat menggunakannya.

Settings → Copilot → BYOK → Add a custom provider: Display name, key Anda, dan https://api.kunavo.com/v1 — Quick Chat selalu tersedia, Agent Chat melalui opencode saat provider ditampilkan di sana.

Pengaturan → Copilot → BYOK → Tambahkan penyedia → Tambahkan penyedia kustom

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 dasar tetap menggunakan sufiks /v1 di sini, dan dokumentasi memastikannya melalui contoh, bukan kalimat langsung: dokumentasi hanya menyatakan "A custom OpenAI-compatible provider must have a Base URL", tetapi kedua templat kompatibel dengan OpenAI yang disertakan secara default menggunakan URL yang diakhiri /v1 — http://localhost:11434/v1 untuk Ollama dan http://localhost:1234/v1 untuk LM Studio — serta menyatakan bahwa "Model discovery uses the endpoint's /v1/models response". Jika hasil penemuan model kosong, pasangan itulah yang pertama perlu diperiksa kembali.

Penyedia BYOK tidak menjangkau semua bagian plugin, dan dokumentasinya menyatakannya dengan tegas: "Menambahkan kunci tidak mengubah model yang disediakan oleh Claude Code atau Codex." Tabelnya menyebutkan bahwa model BYOK tersedia di Quick Chat, dan di Agent Chat hanya dengan backend opencode, "saat penyedia ditampilkan di sana" — ini adalah syarat, bukan ketentuan umum, dan "Model yang tidak dapat dirutekan oleh opencode tidak ditampilkan dalam daftar opencode, tetapi mungkin tetap berfungsi di Quick Chat." Jika Anda menggunakan backend Claude atau Codex, pengaturannya ada di lingkungan CLI masing-masing: lihat /docs/integrations/claude-code.

Aktifkan CORS adalah kompromi, bukan perbaikan yang sebaiknya dibiarkan aktif. Dokumentasi menyatakan: "Jika Test berhasil tetapi Quick Chat tidak dapat mengirim pesan, edit penyedia dan aktifkan Enable CORS. Respons kemudian muncul setelah selesai, bukan mengalir token demi token." Dokumentasi juga mencatat bahwa pengaturan ini tidak mengubah perutean opencode. Jadi, mengaktifkannya untuk memperbaiki Quick Chat membuat keluaran token demi token hilang di sana, dan tidak mengubah bagian lain.

Copilot 4.x tidak memerlukan penyedia embedding: pencarian semantiknya kini ditangani Miyo, layanan terpisah, dan dialog BYOK tidak memiliki kolom untuk itu — memang tepat demikian, karena Kunavo tidak menyediakan model embedding dan halaman ini tidak akan menyiratkan sebaliknya.

Kunavo belum menguji plugin ini saat dijalankan. Semua kolom dan kutipan di atas diambil dari dokumentasi Copilot sendiri pada tanggal di bawah ini; halaman penyiapan yang dipublikasikan bukanlah uji coba. Kirim satu tugas sungguhan melalui Quick Chat sebelum memindahkan alur kerja ke sana.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Copilot untuk Obsidian.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di Obsidian, buka Pengaturan → Copilot → BYOK lalu klik Tambahkan penyedia.
Pilih Tambahkan penyedia khusus, bukan penyedia bernama tertentu atau templat Self Host.
Isi Nama tampilan, Kunci API, dan URL dasar seperti di atas. Untuk saat ini, biarkan Aktifkan CORS nonaktif.
Tambahkan setidaknya satu model — ketik id di Model ID → Tambahkan atau pilih dari Cari model yang tersedia, yang diisi dari GET /v1/models. Klik Uji, lalu Simpan; penyimpanan akan terhalang sampai model dan endpoint yang dapat dirutekan tersedia.
Atur model-model tersebut pada Basic → Agents → Quick Chat dan Basic → Agents → opencode, masing-masing dengan Model default. Secara default, model obrolan baru diaktifkan untuk keduanya.

Diperiksa terhadap Halaman Sumber Model dan BYOK Copilot pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di backend Copilot mana yang benar-benar membayar token.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Copilot untuk Obsidian.

# 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 model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Copilot untuk Obsidian
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, tempat permintaan singkat pada catatan dijalankan sepanjang hari
`claude-sonnet-5`	$1.40 / $7.00	backend opencode di Agent Chat — model kerja default
`claude-opus-5`	$3.50 / $17.50	sintesis panjang dari banyak catatan, saat kesalahan pemahaman berdampak mahal
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain, dengan kunci dan baris penyedia yang sama

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Di mana saya memasukkan kunci API di Obsidian Copilot?

Pengaturan → Copilot → BYOK → Tambahkan penyedia, lalu pilih "Tambahkan penyedia khusus" untuk endpoint yang tidak ada dalam daftar bawaan. Dialog tersebut meminta Nama tampilan, kunci API, URL dasar, sakelar Aktifkan CORS yang opsional, serta setidaknya satu model yang ditambahkan melalui id atau dipilih dari daftar hasil penemuan, lalu klik Simpan. Dokumentasi Copilot menyatakan bahwa kunci penyedia disimpan di Obsidian Keychain pada perangkat tersebut, bukan di data.json vault. Karena itu, menyinkronkan vault tidak memindahkan kredensial ke komputer lain.

Apakah URL dasar Obsidian Copilot perlu diakhiri dengan /v1?

Gunakan format /v1 — untuk Kunavo, https://api.kunavo.com/v1. Dokumentasi tidak menyatakan aturannya dalam satu kalimat; dokumentasi menyebutkan bahwa penyedia khusus yang kompatibel dengan OpenAI harus memiliki URL dasar, penemuan model menggunakan respons /v1/models dari endpoint, dan kedua templat kompatibel dengan OpenAI yang disertakan secara default menggunakan http://localhost:11434/v1 dan http://localhost:1234/v1. Kedua nilai default tersebut memiliki sufiks itu, dan itulah petunjuk terkuat yang diberikan dokumentasi. URL dasar yang salah biasanya tampak sebagai daftar model kosong atau Test yang gagal, bukan sebagai kesalahan autentikasi.

Bisakah Obsidian Copilot menggunakan gateway seperti OpenRouter atau Kunavo, bukan kunci vendor?

Bisa untuk Quick Chat, dan dengan syarat tertentu untuk Agent Chat. Dokumentasi Copilot sendiri menjelaskan bahwa BYOK menghubungkan "langsung ke penyedia AI, gateway yang kompatibel, atau server model di komputer Anda", dan fitur "Tambahkan penyedia khusus" menerima URL dasar apa pun yang kompatibel dengan OpenAI beserta id model. Tabel sumber modelnya menyebutkan bahwa model BYOK selalu tersedia di Quick Chat dan hanya tersedia di Agent Chat dengan backend opencode, "saat penyedia ditampilkan di sana". Backend Claude dan Codex sama sekali tidak menerima kunci BYOK — dokumentasi menyatakan bahwa menambahkan kunci tidak mengubah model yang disediakan keduanya.

Apakah saya memerlukan model embedding untuk pencarian vault Obsidian Copilot?

Bukan dari penyedia chat Anda. Copilot 4.x tidak lagi menjalankan indeksnya sendiri di dalam plugin: dokumentasi menyatakan bahwa pencarian semantik dan Relevant Notes disediakan oleh Miyo, layanan terpisah yang dapat berjalan secara lokal atau jarak jauh, dan dialog BYOK tidak memiliki kolom untuk model seperti itu. Kunavo juga tidak menyediakan model embedding, jadi informasi di sini tidak boleh ditafsirkan sebagai penawaran model tersebut — baris penyedia chat di Copilot hanya membayar chat.

Apakah kunci Kunavo menggantikan lisensi Copilot Lite atau Plus?

Tidak, keduanya memang merupakan jalur terpisah. Dokumentasi Copilot memperlakukan lisensi dan BYOK sebagai sumber model yang berbeda: lisensi menyediakan model yang di-host Copilot, ditagihkan oleh Brevilabs berdasarkan paket Anda, sedangkan BYOK mengirim permintaan ke endpoint Anda sendiri dan penagihannya tetap ditangani penyedia tersebut. Kunci di sini tidak menambah kuota lisensi, tidak membuka baris model Copilot yang terkunci, dan tidak mengubah layanan yang memerlukan lisensi; sebaliknya, Anda dapat menggunakan BYOK pada paket gratis tanpa lisensi sama sekali.