Dokumentasi

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.

Kedua konvensi itu memang berbeda dalam hal /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.

OpenClawAnthropic

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.

Hermes AgentAnthropic

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.

Claude CodeAnthropic

Dua variabel lingkungan — ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN — mengalihkan Claude Code ke sistem bayar sesuai pemakaian tanpa mengubah instalasi.

Kilo CodeOpenAI

Providers → Custom provider → OpenAI Compatible, base URL dengan /v1, dan model id Claude yang diketik — Kilo Code tidak pernah mengetahui vendor di baliknya.

Roo CodeOpenAI

Pilih provider OpenAI Compatible, tempel base URL dan key, lalu atur context window dan max output model agar penganggaran Roo Code sendiri akurat.

ClineOpenAI

Provider OpenAI Compatible milik Cline menerima base URL, key, dan model id, ditambah harga per model yang digunakan untuk menampilkan biaya sesi berjalan.

Codex CLIOpenAI

Blok [model_providers.kunavo] di ~/.codex/config.toml dengan env_key, sehingga key tetap berada di lingkungan dan tidak pernah masuk ke file konfigurasi.

opencodeOpenAI

Satu blok provider di opencode.json — @ai-sdk/openai-compatible untuk chat completions, @ai-sdk/openai saat Anda menginginkan permukaan /v1/responses.

Claude Code RouterAnthropic

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.

ZedOpenAI

Blok language_models.openai_compatible di settings.json mendeklarasikan endpoint dan modelnya; key dimasukkan di UI Agent Panel, tidak pernah di file.

ContinueOpenAI

Provider `openai` milik Continue menamai protokol, bukan vendor: berikan apiBase dan setiap model — chat, edit, autocomplete — menjadi satu entri dalam config.yaml.

AiderOpenAI

OPENAI_API_BASE ditambah OPENAI_API_KEY, lalu `aider --model openai/<id>` — prefiks tersebut mengarahkan id ke endpoint Anda, bukan tabel provider Aider.

CC SwitchAnthropic

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.

Claude Agent SDKAnthropic

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.

AmpOpenAI

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.

GitHub Copilot CLIOpenAI

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.

CrushOpenAI

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.

DeepSeek HarnessOpenAI

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.

DyadOpenAI

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.

Factory DroidAnthropic

Entri customModels di ~/.factory/settings.json — model, baseUrl, dan provider — menempatkan Droid pada endpoint apa pun yang berbicara Anthropic Messages atau OpenAI Chat Completions.

gooseOpenAI

Settings → Models → Configure providers → OpenAI: Host URL menerima origin tanpa tambahan apa pun, karena goose sendiri menambahkan jalur permintaan (v1/chat/completions).

Jan AgentOpenAI

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 CLIOpenAI

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 CodeOpenAI

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-agentOpenAI

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.

Mistral Vibe CLIOpenAI

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.

Msty GoOpenAI

Settings &gt; Model Providers menerima Base URL dan API key — lima field terdokumentasi, dua di antaranya harus Anda tentukan sendiri melalui pengujian.

NanocoderOpenAI

Entri Custom Provider di bawah nanocoder.providers dalam agents.config.json — name, baseUrl, apiKey, models — tanpa perlu baris sdkProvider karena default-nya openai-compatible.

Oh My PiOpenAI

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.

Open InterpreterOpenAI

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.

OpenHandsOpenAI

Settings → LLM → Advanced menerima tiga field — Custom Model, Base URL, API Key — dengan model id membawa prefiks openai/ dan base URL tetap menyertakan /v1.

PiOpenAI

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.

QoderOpenAI

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 CodeOpenAI

Qwen Code membaca endpoint dari modelProviders di ~/.qwen/settings.json — satu entri dengan baseUrl dan envKey menempatkan Claude dan GPT dalam pemilih /model.

Theia IDEOpenAI

Satu entri di ai-features.openAiCustom.customOpenAiModels — model, url, dan apiKey — menempatkan Kunavo di balik Theia Coder, Architect, dan inline completion.

twinnyOpenAI

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.

Open WebUIOpenAI

Satu koneksi OpenAI di Admin Settings, atau OPENAI_API_BASE_URL dan OPENAI_API_KEY saat container dimulai — keduanya berakhir pada /v1 yang sama.

Cherry StudioOpenAI

Settings → Model Services → provider khusus: tempel key dan alamat API, klik Get Model List, lalu seluruh katalog mengisi pemilih.

ChatboxOpenAI

Tambahkan provider bertipe OpenAI API Compatible dengan API Host diatur ke root layanan — Chatbox sendiri menambahkan /v1/chat/completions.

LobeChatOpenAI

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.

SillyTavernOpenAI

Arahkan sumber Chat Completion SillyTavern ke Kunavo dengan endpoint khusus dan satu API key — Claude dan GPT dalam dropdown model yang sama.

Janitor AIOpenAI

API Settings → Proxy → Add Configuration: Proxy URL adalah jalur lengkap /v1/chat/completions, dan Model Name harus persis berupa catalog id.

OllamaOpenAI

Permukaan OpenAI-compatible Ollama dan Kunavo memiliki bentuk yang sama, sehingga alat yang ditulis untuk Ollama lokal dapat dialihkan hanya dengan mengubah base URL.

AnythingLLMOpenAI

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.

ChatWiseOpenAI

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.

DifyOpenAI

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.

LibreChatOpenAI

LibreChat menerima gateway sebagai blok endpoints.custom di librechat.yaml — empat field wajib, key dari .env, dan restart sebelum pemilih menampilkannya.

Msty StudioOpenAI

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.

n8nOpenAI

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.

NextChatOpenAI

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.

Copilot for ObsidianOpenAI

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.

Page AssistOpenAI

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.

TypingMindOpenAI

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.