Dokumentasi
Integrasi
Kunavo mendukung dua format wire yang sudah didukung setiap klien serius, sehingga integrasi hanya memerlukan Base URL dan kunci, bukan SDK. Berikut panduan penyiapan untuk setiap klien.
Kunavo adalah gateway API AI independen yang kompatibel dengan OpenAI: satu kunci API dan satu saldo bayar sesuai pemakaian memungkinkan Anda mengakses model Claude, GPT, serta model gambar, video, dan audio, tanpa memerlukan akun terpisah untuk setiap penyedia. Anda tidak perlu memasang SDK Kunavo: semua klien yang memiliki kolom Base URL dapat digunakan. Arahkan klien yang kompatibel dengan OpenAI ke https://api.kunavo.com/v1, atau klien bergaya Anthropic ke https://api.kunavo.com, lalu masukkan kunci Kunavo.
/v1: SDK OpenAI menginginkannya di base_url, sedangkan klien Anthropic menambahkan /v1/messages sendiri sehingga hanya memerlukan origin. Membalik format ini adalah penyebab paling umum kegagalan penyiapan—lihat halaman ANTHROPIC_BASE_URL. Setiap halaman di bawah menjelaskan format yang diperlukan klien tersebut dan tanggal konfigurasi terakhir kali diperiksa terhadap dokumentasi klien itu sendiri.Agen coding, editor, dan CLI
Semua klien ini memiliki kolom untuk penyedia kustom, dan semuanya memperlakukan “kompatibel dengan OpenAI” atau “Anthropic” sebagai protokol, bukan vendor—itulah sebabnya id model Claude yang dimasukkan ke penyedia kompatibel dengan OpenAI merupakan kombinasi yang memang dimaksudkan, bukan solusi sementara.
Satu entri models.providers di ~/.openclaw/openclaw.json — baseUrl https://api.kunavo.com, api "anthropic-messages" — menghubungkan agen OpenClaw yang selalu aktif ke Claude; cacheRetention ditetapkan bersamanya, karena endpoint Anthropic khusus tidak menerima penanda cache sebelum pengaturan itu diisi.
Penyedia bernama di ~/.hermes/config.yaml — api https://api.kunavo.com, transport anthropic_messages, dipilih dengan provider: custom:kunavo — menghubungkan Hermes Agent ke Claude melalui protokol Messages, dengan penanda cache dan batas output yang dikirimnya sendiri.
Dua variabel lingkungan — ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN — mengalihkan Claude Code ke sistem bayar sesuai pemakaian tanpa mengubah instalasi.
Providers → Custom provider → OpenAI Compatible, base URL dengan /v1, dan model id Claude yang diketik — Kilo Code tidak pernah mengetahui vendor di baliknya.
Pilih provider OpenAI Compatible, tempel base URL dan key, lalu atur context window dan max output model agar penganggaran Roo Code sendiri akurat.
Provider OpenAI Compatible milik Cline menerima base URL, key, dan model id, ditambah harga per model yang digunakan untuk menampilkan biaya sesi berjalan.
Blok [model_providers.kunavo] di ~/.codex/config.toml dengan env_key, sehingga key tetap berada di lingkungan dan tidak pernah masuk ke file konfigurasi.
Satu blok provider di opencode.json — @ai-sdk/openai-compatible untuk chat completions, @ai-sdk/openai saat Anda menginginkan permukaan /v1/responses.
CCR kini merupakan aplikasi desktop, bukan config.json: tambahkan Kunavo sebagai endpoint API khusus, lalu biarkan aturan routing-nya mengirim setiap kelas permintaan ke model yang berbeda.
Blok language_models.openai_compatible di settings.json mendeklarasikan endpoint dan modelnya; key dimasukkan di UI Agent Panel, tidak pernah di file.
Provider `openai` milik Continue menamai protokol, bukan vendor: berikan apiBase dan setiap model — chat, edit, autocomplete — menjadi satu entri dalam config.yaml.
OPENAI_API_BASE ditambah OPENAI_API_KEY, lalu `aider --model openai/<id>` — prefiks tersebut mengarahkan id ke endpoint Anda, bukan tabel provider Aider.
Tambahkan Kunavo sebagai Custom Configuration: root layanan sebagai endpoint, ANTHROPIC_AUTH_TOKEN sebagai field autentikasi, Anthropic Messages native — sehingga sisi Claude Code tidak memerlukan routing lokal.
Tidak ada opsi base_url — SDK menjalankan Claude Code CLI dan meneruskan seluruh lingkungan Anda, sehingga ANTHROPIC_BASE_URL merutekannya, atau ClaudeAgentOptions(env=...) melakukannya per klien.
Koneksi Custom URL di Amp's Model Routing — format API chat-completions, base URL https://api.kunavo.com/v1, key sebagai bearer token — memindahkan model yang dipetakan ke satu key, pada tingkat yang menyediakan opsi tersebut.
Empat variabel lingkungan — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY, dan COPILOT_MODEL — mengalihkan Copilot CLI ke endpoint Anda sendiri, dan GitHub mendokumentasikan bahwa BYOK tidak memerlukan login GitHub.
Konfigurasi Crush berbasis Bash — satu `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` dalam crushrc menempatkan agen terminal Charm pada Claude dan GPT.
Settings → Models → “Add model provider” → “Custom model API” menerima lima field — Provider ID, display name, base URL, API protocol, dan API key — lalu menempatkan Claude dan GPT dalam pemilih yang sama dengan kartu DeepSeek bawaan.
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.
Entri customModels di ~/.factory/settings.json — model, baseUrl, dan provider — menempatkan Droid pada endpoint apa pun yang berbicara Anthropic Messages atau OpenAI Chat Completions.
Settings → Models → Configure providers → OpenAI: Host URL menerima origin tanpa tambahan apa pun, karena goose sendiri menambahkan jalur permintaan (v1/chat/completions).
Satu baris `jan config set --base-url https://api.kunavo.com/v1` menulis Kunavo ke ~/.jan/config.toml, dan CLI pratinjau Jan Agent — yang tidak menyertakan mesin inferensi — berjalan dengan key tersebut.
Junie CLI menerima endpoint khusus sebagai profil JSON di $JUNIE_HOME/models/, dengan baseUrl sebagai URL endpoint lengkap dan fasterModel menentukan tujuan traffic pembantunya.
Kimi Code menyimpan provider di ~/.kimi-code/config.toml — atur providers.<name>.base_url menjadi https://api.kunavo.com/v1 dengan type = "openai", dan CLI menjalankan id Claude serta GPT dengan satu key.
mini-SWE-agent tidak memiliki variabel lingkungan base-URL — endpoint ditempatkan di model.model_kwargs.api_base dalam konfigurasi YAML, yang langsung diteruskan mini ke litellm.completion.
Blok [[providers]] lima baris di .vibe/config.toml — api_base, api_key_env_var, api_style — mengarahkan Vibe CLI ke Kunavo, dengan key disimpan dalam variabel lingkungan, bukan file.
Settings > Model Providers menerima Base URL dan API key — lima field terdokumentasi, dua di antaranya harus Anda tentukan sendiri melalui pengujian.
Entri Custom Provider di bawah nanocoder.providers dalam agents.config.json — name, baseUrl, apiKey, models — tanpa perlu baris sdkProvider karena default-nya openai-compatible.
Blok provider di ~/.omp/agent/models.yml — baseUrl, api, apiKey — mengarahkan Oh My Pi ke Kunavo, dan discovery mengisi daftar model dari GET /v1/models.
Satu tabel [model_providers.kunavo] di ~/.openinterpreter/config.toml — base_url, env_key, wire_api = "chat" — dan agen terminal Rust berjalan pada model apa pun yang dapat dijangkau key tersebut.
Settings → LLM → Advanced menerima tiga field — Custom Model, Base URL, API Key — dengan model id membawa prefiks openai/ dan base URL tetap menyertakan /v1.
Blok provider khusus di ~/.pi/agent/models.json — baseUrl, api, dan model ids — menempatkan agen coding terminal Pi milik Earendil pada Claude dan GPT melalui satu key.
Qoder Settings → Models → + Add → Provider → Custom menerima Base URL yang kompatibel dengan OpenAI, API Key, dan Model IDs yang diketik manual — sehingga aplikasi desktop Qoder mandiri mengakses Claude dan GPT, yang tidak ada dalam katalognya sendiri.
Qwen Code membaca endpoint dari modelProviders di ~/.qwen/settings.json — satu entri dengan baseUrl dan envKey menempatkan Claude dan GPT dalam pemilih /model.
Satu entri di ai-features.openAiCustom.customOpenAiModels — model, url, dan apiKey — menempatkan Kunavo di balik Theia Coder, Architect, dan inline completion.
twinny tidak memiliki field base-URL — Add provider → OpenAI-compatible server, lalu Protocol https, Hostname api.kunavo.com, Port kosong, dan API path /v1; panel chat-nya menggunakan key Anda.
Klien chat dan UI yang di-host sendiri
Aplikasi desktop dan antarmuka front-end yang di-host sendiri, dengan keunggulan berupa satu kunci dan satu saldo untuk satu pemilih model, alih-alih satu akun per vendor.
Satu koneksi OpenAI di Admin Settings, atau OPENAI_API_BASE_URL dan OPENAI_API_KEY saat container dimulai — keduanya berakhir pada /v1 yang sama.
Settings → Model Services → provider khusus: tempel key dan alamat API, klik Get Model List, lalu seluruh katalog mengisi pemilih.
Tambahkan provider bertipe OpenAI API Compatible dengan API Host diatur ke root layanan — Chatbox sendiri menambahkan /v1/chat/completions.
Tiga variabel lingkungan — OPENAI_API_KEY, OPENAI_PROXY_URL, dan OPENAI_MODEL_LIST — menempatkan Claude dan GPT dalam satu pemilih LobeChat yang di-host sendiri.
Arahkan sumber Chat Completion SillyTavern ke Kunavo dengan endpoint khusus dan satu API key — Claude dan GPT dalam dropdown model yang sama.
API Settings → Proxy → Add Configuration: Proxy URL adalah jalur lengkap /v1/chat/completions, dan Model Name harus persis berupa catalog id.
Permukaan OpenAI-compatible Ollama dan Kunavo memiliki bentuk yang sama, sehingga alat yang ditulis untuk Ollama lokal dapat dialihkan hanya dengan mengubah base URL.
AnythingLLM mengakses endpoint yang tidak memiliki provider bernama melalui Generic OpenAI — Base URL dengan /v1, key, dan model id yang Anda ketik sendiri karena tidak mengambil daftar.
Settings → Providers → "+" membuat provider khusus dari tiga field — Provider name, API Base URL yang diatur ke https://api.kunavo.com/v1, dan API Key — lalu Fetch membaca daftar model dari endpoint.
Satu field wajib — API Base URL, dalam formulir Add Model plugin yang kompatibel dengan OpenAI API — mengarahkan setiap node LLM di workspace Dify ke Kunavo.
LibreChat menerima gateway sebagai blok endpoints.custom di librechat.yaml — empat field wajib, key dari .env, dan restart sebelum pemilih menampilkannya.
Model Hub > Model Providers > Add Provider > Open AI Compatible: API Key dan Inference Endpoint https://api.kunavo.com/v1 — catatan aplikasi sendiri menyebutkan bahwa sebagian besar endpoint yang kompatibel dengan OpenAI memerlukan /v1.
Field Base URL pada kredensial OpenAI — https://api.kunavo.com/v1, tetap menyertakan /v1 — menempatkan setiap OpenAI Chat Model dalam alur kerja n8n di Kunavo; node model itu sendiri tidak memiliki field endpoint.
Tiga variabel lingkungan — OPENAI_API_KEY, BASE_URL (origin tanpa tambahan), dan CUSTOM_MODELS — menempatkan NextChat yang di-host sendiri pada Claude dan GPT melalui satu key.
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.
Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, Base URL yang tetap menyertakan /v1, dan key — lalu centang model ids dari daftar yang diambil Page Assist sendiri.
Models → Add custom model: Endpoint URL lengkap https://api.kunavo.com/v1/chat/completions, header Authorization dengan Bearer dan key Anda, Model ID, serta panjang konteksnya — satu entri per model, dipanggil langsung dari browser.
Lainnya
Klien yang tidak tercantum di sini hampir pasti tetap dapat digunakan. Pastikan apakah endpoint-nya dapat diubah: jika klien memiliki pengaturan “Base URL”, “endpoint kustom”, atau “penyedia yang kompatibel dengan OpenAI”, Kunavo dapat digunakan. Mulailah dengan panduan mulai cepat, lalu pilih chat completions atau Messages API, sesuai format yang digunakan klien. Id model tersedia di GET /v1/models, yang juga mengisi menu tarik-turun model pada klien yang memilikinya. Kontrak lengkap yang dapat dibaca mesin tersedia dalam deskripsi OpenAPI 3.1, yang dapat langsung digunakan oleh sebagian besar generator klien dan kerangka kerja agen.