Dokumentasi

Dyad

Dyad menerima endpoint apa pun yang kompatibel dengan OpenAI melalui Add Custom Provider: tiga kolom, satu kunci di halaman provider, lalu satu baris untuk setiap id model yang ingin Anda tampilkan di pemilih.

Dyad menerima endpoint yang kompatibel dengan OpenAI melalui Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, key pada halaman provider sendiri, lalu satu baris Add Custom Model untuk setiap model id.

Pengaturan → Penyedia AI → Tambahkan Penyedia Kustom

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

URL dasar tetap memakai /v1 — tetapi bukan karena dokumentasinya mengatakan demikian. Halaman model kustom hanya menyebut “You can usually find the API Base URL in the provider's documentation” dan tidak memberikan contoh, jadi hal itu tidak menjawab pertanyaan. Dua hal dalam aplikasi yang dirilis menjelaskannya: placeholder pada dialog itu sendiri berbunyi E.g., https://api.example.com/v1, dan provider kustom dibuat sebagai klien yang kompatibel dengan OpenAI dengan nilai Anda digunakan sebagai baseURL tanpa perubahan — Dyad menambahkan rutenya, bukan /v1. Setiap endpoint kompatibel OpenAI yang ditetapkan langsung di Dyad berakhir dengan cara yang sama. URL dasar tanpa itu akan gagal dengan 404, bukan karena kunci ditolak.

Ada dua kolom yang tidak tercantum di halaman dokumentasi. Dialog yang dirilis menyebut kolom pertama Provider ID, bukan ID, dan menambahkan Environment Variable (Optional) — nama variabel seperti KUNAVO_API_KEY, yang hanya dibaca jika tidak ada kunci yang tersimpan di pengaturan. Kuncinya sendiri tidak ada di dialog tersebut: buat provider terlebih dahulu, buka provider itu, lalu gunakan kotak Set Kunavo API Key pada halamannya.

Masukkan Context Window; jangan biarkan kosong. Satu-satunya peringatan Dyad adalah bahwa kolom kosong akan menggunakan “default values, which may be smaller than optimal”. Nilai default saat ini adalah 128,000 token, dan Dyad meringkas percakapan saat mencapai nilai yang lebih rendah antara batas per provider dan context window dikurangi 25,000. Provider kustom disimpan dengan id custom::, jadi batas yang berlaku bukan batas Google atau OpenAI, melainkan 250,000. Jika dibiarkan kosong, model dengan jendela satu juta token akan mulai diringkas pada 103,000 token, bukan 250,000 — lebih banyak tahap peringkasan untuk pekerjaan yang sama, tanpa alasan.

Konfigurasi ini ditinjau dari dokumentasi Dyad sendiri dan kode sumber yang dirilis pada tanggal di bawah. Kunavo belum menjalankan Dyad menggunakan endpoint-nya — belum ada build, edit streaming, ataupun pertukaran bolak-balik alat dalam mode Agent — dan hal yang sama berlaku untuk setiap klien dalam keluarga ini. Halaman penyiapan yang dipublikasikan bukanlah uji kompatibilitas. Tetap sediakan rute yang saat ini berfungsi saat Anda mencoba yang ini, lalu jalankan satu fitur dengan cakupan terbatas sebelum memindahkan proyek ke sana.

Kunavo tidak menyediakan model embedding, text-to-speech, ataupun speech-to-text, sehingga provider kustom yang ditambahkan dengan cara ini hanya menjawab permintaan chat completion. Loop build Dyad tidak meminta tiga jenis model lainnya, jadi hal ini tidak mengurangi fitur yang tersedia di sini — artinya hanya provider yang baru Anda tambahkan ini bukan pengganti langsung untuk stack yang juga memerlukan model-model tersebut.

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 Dyad.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di Dyad, buka Settings, temukan bagian AI Providers, lalu klik Add Custom Provider. Isi ID, Display Name, dan API Base URL seperti di atas. ID tersebut “used internally and cannot be changed later”, jadi pilih nilai yang dapat Anda gunakan seterusnya; Display Name ditampilkan di pemilih dan hanya berfungsi sebagai label.
Buka provider yang baru dibuat, tempelkan kunci ke Set Kunavo API Key, lalu klik Save Key. Jika URL dasar dibiarkan kosong, Dyad langsung menolak permintaan dengan kesalahan missing the API Base URL, bukan karena kegagalan jaringan.
Di halaman yang sama, gulir ke bawah dan klik Add Custom Model. Model ID harus sama persis dengan slug katalog — dokumentasi Dyad menyatakan bahwa id tersebut “must match exactly what's specified in the provider's API documentation. It's the identifier sent to the API” — jadi gunakan claude-sonnet-5, bukan nama tampilan.
Isi Max Output Tokens dan Context Window berdasarkan /models, jangan biarkan kosong. Ulangi langkah Add Custom Model untuk setiap id yang ingin tersedia di pemilih — tidak ada impor massal atau daftar yang diambil otomatis di sini.
Pilih model baru di pemilih model, lalu berikan tugas nyata — misalnya menambahkan komponen, bukan sekadar sapaan. Mode Build adalah loop agentik yang mengirim ulang kumpulan kerja pada setiap langkah, jadi streaming dan pengeditan berulang adalah hal yang sebaiknya diuji saat penggunaan pertama.

Diperiksa terhadap Halaman Custom Models Dyad 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 panduan harga dan biaya API Dyad.

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 Dyad.

# 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 Dyad
`claude-sonnet-5`	$1.40 / $7.00	model default mode Build — kualitas coding per dolar dalam loop yang berjalan sepanjang hari
`claude-opus-5`	$3.50 / $17.50	Mode Plan untuk refaktor yang rencana kelirunya dapat menghabiskan seluruh sesi
`claude-haiku-4-5`	$0.70 / $3.50	Mode Ask dan pertanyaan singkat tentang basis kode, dengan volume sebagai faktor utama
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain — tambahkan sebagai model kustom kedua di provider yang sama
`gpt-5-6-terra`	$0.70 / $4.20	kumpulan kerja berukuran besar, setelah kolom Context Window diisi dengan benar

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.

Tiga batasan yang perlu diketahui sebelum beralih

Ini adalah aturan Dyad sendiri, bukan aturan Kunavo, dan masing-masing memengaruhi hal yang dapat dijangkau oleh kunci pelanggan. Itulah sebabnya halaman ini menjelaskan rute ke model, bukan ke seluruh fitur Dyad.

Mode Pro memang tidak dapat diakses dengan kunci Anda sendiri. FAQ harga Dyad menjawab dengan tegas: mode Pro seperti Smart Context hanya dapat digunakan dengan kredit AI Dyad Pro, bukan dengan kunci API Anda sendiri, karena mode tersebut memerlukan pemrosesan sisi server menggunakan beberapa model. Turbo Edits juga termasuk. Provider kustom memberi Anda akses ke model dan mode biasa, bukan mekanisme tersebut.
Mode Agent dibatasi pada paket gratis. Batasnya adalah 20 pesan Agent dalam rentang 23 jam, terlepas dari kunci yang Anda konfigurasi — Build, Ask, dan Plan tidak dibatasi. Jadi, jika sesi berhenti di tengah jalan secara tak terduga, penyebabnya mungkin kuota Dyad, bukan saldo atau endpoint Anda.
Protokol Anthropic Messages tidak dapat diakses dari Dyad. Provider kustom selalu dibuat sebagai klien chat-completions OpenAI, sedangkan provider Anthropic bawaan tidak menerima penggantian base URL. Karena itu, model Claude diakses di sini melalui antarmuka yang kompatibel dengan OpenAI — itulah yang dilakukan penyiapan di atas dan alasan permintaan verifikasi di halaman ini menggunakan format OpenAI.

Pertanyaan umum

Bagaimana cara menambahkan provider API kustom ke Dyad?

Buka Settings, temukan bagian AI Providers, lalu klik Add Custom Provider. Isi ID, yang digunakan secara internal dan tidak dapat diubah nanti, Display Name untuk pemilih, serta API Base URL endpoint Anda. Simpan, lalu buka provider yang baru saja dibuat dan tempelkan kunci Anda ke kotak "Set <name> API Key" pada halamannya — kunci tersebut bukan bagian dari dialog pembuatan. Terakhir, gulir ke bawah halaman itu dan gunakan Add Custom Model satu kali untuk setiap id model yang ingin tersedia. Dokumentasi Dyad menyatakan persyaratan pada sisi endpoint dengan satu kalimat: provider apa pun dapat digunakan selama menyediakan API yang kompatibel dengan OpenAI.

Apakah API Base URL Dyad harus diakhiri dengan /v1?

Untuk endpoint yang kompatibel dengan OpenAI, ya — contohnya https://api.kunavo.com/v1. Dokumentasi Custom Models Dyad tidak menjawab hal ini: dokumentasi tersebut hanya menyebutkan bahwa API Base URL biasanya dapat ditemukan dalam dokumentasi provider, tanpa memberikan contoh. Jawabannya terlihat dari dialog itu sendiri, yang placeholder-nya berbunyi "E.g., https://api.example.com/v1", dan dari cara Dyad membuat klien — nilai Anda menjadi baseURL klien yang kompatibel dengan OpenAI tanpa perubahan, lalu hanya rutenya yang ditambahkan. URL dasar tanpa /v1 akan menghasilkan 404, bukan kesalahan autentikasi; begitu juga URL yang sudah menyertakan /chat/completions.

Dapatkah saya menggunakan Dyad dengan model Claude tanpa akun Anthropic?

Ya, melalui provider kustom, bukan entri Anthropic bawaan Dyad. Dyad membuat setiap provider kustom sebagai klien chat-completions OpenAI, sehingga id model yang Anda masukkan akan dicari di endpoint yang Anda konfigurasi, bukan di aplikasi, dan id Claude dapat dikirim ke sana. Provider Anthropic bawaan tidak dapat digunakan untuk tujuan ini: provider tersebut dibuat tanpa argumen base URL, jadi tidak ada penggantian bergaya ANTHROPIC_BASE_URL dan provider itu hanya mengakses endpoint Anthropic sendiri.

Apakah provider kustom di Dyad berbeda dari penggunaan OpenRouter?

Perbedaannya hanya pada penyiapan, bukan jenisnya. OpenRouter adalah satu-satunya gateway multi-vendor independen yang memiliki preset bawaan dalam daftar provider Dyad, jadi hanya memerlukan kunci. Gateway lainnya ditambahkan melalui Add Custom Provider, tempat Anda juga harus memasukkan id, Max Output Tokens, dan Context Window setiap model secara manual. Maintainer Dyad menunjuk tepat ke cara tersebut saat sebuah gateway meminta agar ditambahkan sebagai preset. Bandingkan keduanya berdasarkan harga, ketentuan pendanaan, dan model yang benar-benar Anda inginkan, bukan berdasarkan apakah salah satunya memiliki logo di daftar.

Mengapa model kustom Dyad saya mulai meringkas percakapan begitu cepat?

Kemungkinan besar kolom Context Window dibiarkan kosong. Jika kosong, Dyad menggunakan 128,000 token dan meringkas saat mencapai nilai yang lebih rendah antara batas per provider dan context window dikurangi 25,000. Provider kustom menggunakan batas 250,000, bukan batas Google atau OpenAI. Jadi, meskipun model memiliki jendela yang jauh lebih besar, jika kolom dibiarkan kosong, peringkasan akan dimulai sekitar 103,000 token. Masukkan angka sebenarnya dari katalog provider ke Max Output Tokens dan Context Window agar ambangnya mencapai batas tersebut.