Dokümantasyon
Entegrasyonlar
Kunavo, ciddi her istemcinin zaten desteklediği iki kablolu iletişim biçimini sunar; bu nedenle entegrasyon için bir SDK yerine Base URL ve anahtar yeterlidir. Her istemciye özel kurulum aşağıda.
Kunavo, bağımsız ve OpenAI uyumlu bir AI API ağ geçididir: Tek bir API anahtarı ve kullandıkça öde bakiyesiyle Claude, GPT ve görüntü, video ve ses modellerine, sağlayıcı başına hesap gerekmeksizin erişebilirsiniz. Kunavo SDK’sı yüklemeniz gerekmez: Base URL alanı olan her istemci çalışır. OpenAI uyumlu bir istemciyi https://api.kunavo.com/v1 adresine veya Anthropic tarzı bir istemciyi https://api.kunavo.com adresine yönlendirin ve bir Kunavo anahtarı girin.
/v1 konusunda bilerek farklıdır: OpenAI SDK bunu base_url içinde ister; Anthropic istemcileri ise /v1/messages değerini kendileri eklediğinden yalnızca kaynak adresini ister. Bunu ters yapmak, kurulumda en sık karşılaşılan hatadır — bkz. ANTHROPIC_BASE_URL sayfası. Aşağıdaki her sayfada ilgili istemcinin hangi biçimi istediği ve yapılandırmasının istemcinin kendi belgelerine göre en son hangi tarihte kontrol edildiği belirtiliyor.Kodlama ajanları, düzenleyiciler ve CLI’lar
Bunların her birinde özel sağlayıcı alanı bulunur ve her biri “OpenAI uyumlu” veya “Anthropic” ifadelerini satıcı değil, bir protokol olarak ele alır. Bu nedenle OpenAI uyumlu bir sağlayıcıya Claude model kimliği girmek amaçlanan kullanımdır, geçici bir çözüm değildir.
~/.openclaw/openclaw.json içindeki tek bir models.providers girdisi — baseUrl https://api.kunavo.com, api "anthropic-messages" — sürekli çalışan bir OpenClaw ajanını Claude'a bağlar; özel bir Anthropic uç noktası, bu ayar yapılana kadar hiçbir önbellek işaretçisi almadığı için cacheRetention da bu girdinin yanına eklenir.
~/.hermes/config.yaml içindeki adlandırılmış bir sağlayıcı — api https://api.kunavo.com, transport anthropic_messages, provider: custom:kunavo ile seçilir — Hermes Agent'ı Messages protokolü üzerinden Claude'a bağlar; Hermes Agent bu bağlantıda kendi önbellek işaretçilerini ve çıktı sınırını gönderir.
İki ortam değişkeni — ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN — kurulumu değiştirmeden Claude Code'u kullandıkça öde modeline geçirir.
Providers → Custom provider → OpenAI Compatible, /v1 içeren temel URL ve yazılmış Claude model kimliği — Kilo Code arkasındaki satıcının kim olduğunu asla öğrenmez.
OpenAI Compatible sağlayıcısını seçin, temel URL'yi ve anahtarı yapıştırın; Roo Code'un kendi bütçelemesinin doğru olması için modelin bağlam penceresini ve maksimum çıktısını ayarlayın.
Cline'ın OpenAI Compatible sağlayıcısı bir temel URL, anahtar ve model kimliği ile birlikte çalışan oturum maliyetini göstermek için kullandığı model başına fiyatları alır.
Anahtarın ortamda kalması ve yapılandırma dosyasına hiç girmemesi için ~/.codex/config.toml içinde env_key içeren bir [model_providers.kunavo] bloğu.
opencode.json içinde tek bir sağlayıcı bloğu — sohbet tamamlamaları için @ai-sdk/openai-compatible, /v1/responses yüzeyini istediğinizde @ai-sdk/openai.
CCR artık config.json olmayan bir masaüstü uygulamasıdır: Kunavo'yu özel API uç noktası olarak ekleyin, ardından yönlendirme kurallarının her istek sınıfını farklı bir modele göndermesine izin verin.
settings.json içindeki language_models.openai_compatible bloğu uç noktayı ve modellerini tanımlar; anahtar Agent Panel arayüzüne girilir, dosyaya asla yazılmaz.
Continue'un `openai` sağlayıcısı bir satıcıyı değil, protokolü adlandırır: ona bir apiBase verin; her model — sohbet, düzenleme, otomatik tamamlama — config.yaml içinde bir girdidir.
OPENAI_API_BASE ve OPENAI_API_KEY, ardından `aider --model openai/<id>` — kimliği Aider'ın sağlayıcı tablosu yerine uç noktanıza yönlendiren önek budur.
Kunavo'yu Custom Configuration olarak ekleyin: uç nokta olarak hizmet kökü, kimlik doğrulama alanı olarak ANTHROPIC_AUTH_TOKEN ve Anthropic'e özgü Messages biçimi — böylece Claude Code tarafında yerel yönlendirme gerekmez.
base_url seçeneği yoktur — SDK, Claude Code CLI'yi çalıştırır ve tüm ortamınızı iletir; bu nedenle ANTHROPIC_BASE_URL yönlendirir veya bunu istemci başına ClaudeAgentOptions(env=...) yapar.
Amp'in Model Routing bölümündeki Custom URL bağlantısı — API formatı chat-completions, temel URL https://api.kunavo.com/v1, anahtar bearer token olarak — seçeneğin bulunduğu segmentlerde eşlenen modelleri tek anahtara taşır.
Dört ortam değişkeni — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY ve COPILOT_MODEL — Copilot CLI'yi kendi uç noktanıza taşır; GitHub, BYOK için GitHub girişinin gerekmediğini belgeliyor.
Crush'ın yapılandırması Bash'tir — crushrc içine tek bir `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` komutu Charm'ın terminal aracısını Claude ve GPT üzerinde çalıştırır.
Settings → Models → “Add model provider” → “Custom model API” beş alan alır — Provider ID, display name, base URL, API protocol ve API key — ve Claude ile GPT'yi yerleşik DeepSeek kartıyla aynı seçiciye koyar.
Dyad, Settings → AI Providers → Add Custom Provider üzerinden her OpenAI uyumlu uç noktayı alır: API Base URL https://api.kunavo.com/v1, sağlayıcının kendi sayfasındaki anahtar ve ardından model kimliği başına bir Add Custom Model satırı.
~/.factory/settings.json içindeki özelModels girdisi — model, baseUrl ve provider — Droid'i Anthropic Messages veya OpenAI Chat Completions konuşan herhangi bir uç noktaya bağlar.
Settings → Models → Configure providers → OpenAI: Host URL, goose istek yolunu (v1/chat/completions) kendisi eklediği için yalnızca temel origin'i alır.
Tek bir `jan config set --base-url https://api.kunavo.com/v1` satırı Kunavo'yu ~/.jan/config.toml dosyasına yazar; çıkarım motoru içermeyen Jan Agent önizleme CLI'sı bu anahtarla çalışır.
Junie CLI, özel uç noktayı $JUNIE_HOME/models/ içindeki JSON profili olarak alır; baseUrl eksiksiz uç nokta URL'sidir ve fasterModel yardımcı trafiğinin nereye gideceğini belirler.
Kimi Code, sağlayıcıları ~/.kimi-code/config.toml içinde tutar — providers.<name>.base_url değerini type = "openai" ile https://api.kunavo.com/v1 olarak ayarlayın; CLI, Claude ve GPT kimliklerini tek anahtarla çalıştırır.
mini-SWE-agent'de temel URL ortam değişkeni yoktur — uç nokta YAML yapılandırmasında model.model_kwargs.api_base altına girer; mini bunu doğrudan litellm.completion'a iletir.
.vibe/config.toml içindeki beş satırlık [[providers]] bloğu — api_base, api_key_env_var, api_style — Vibe CLI'yi Kunavo'ya yönlendirir; anahtar dosyada değil, ortam değişkeninde tutulur.
Settings > Model Providers bir Base URL ve API anahtarı alır — belgelenen beş alandan ikisini Msty Go'nun kendi belgeleri test ederek belirlemenizi ister.
agents.config.json içinde nanocoder.providers altında bir Custom Provider girdisi — name, baseUrl, apiKey, models — varsayılanı openai-compatible olduğundan sdkProvider satırı gerekmez.
~/.omp/agent/models.yml içindeki bir sağlayıcı bloğu — baseUrl, api, apiKey — Oh My Pi'yi Kunavo'ya yönlendirir; keşif, model listesini GET /v1/models üzerinden doldurur.
~/.openinterpreter/config.toml içinde tek bir [model_providers.kunavo] tablosu — base_url, env_key, wire_api = "chat" — Rust terminal aracısını anahtarın eriştiği herhangi bir modelde çalıştırır.
Settings → LLM → Advanced üç alan alır — Custom Model, Base URL, API Key — model kimliğinde openai/ öneki bulunur ve temel URL /v1'i korur.
~/.pi/agent/models.json içindeki özel sağlayıcı bloğu — baseUrl, api ve model kimlikleri — Earendil'in Pi terminal kodlama aracısını tek anahtarla Claude ve GPT üzerinde çalıştırır.
Qoder Settings → Models → + Add → Provider → Custom, OpenAI uyumlu bir Base URL, API Key ve elle girilen Model IDs alır — böylece bağımsız Qoder masaüstü uygulaması Claude ve GPT'ye ulaşır; ikisi de kendi kataloğunda bulunmaz.
Qwen Code uç noktalarını ~/.qwen/settings.json içindeki modelProviders'tan okur — baseUrl ve envKey içeren tek bir girdi, Claude ve GPT'yi /model seçicisine koyar.
ai-features.openAiCustom.customOpenAiModels içindeki tek bir girdi — model, url ve apiKey — Kunavo'yu Theia Coder, Architect ve satır içi tamamlamanın arkasına koyar.
twinny'de temel URL alanı yoktur — Add provider → OpenAI-compatible server, ardından Protocol https, Hostname api.kunavo.com, Port boş ve API path /v1; sohbet paneli anahtarınızla çalışır.
Sohbet istemcileri ve kendi sunucunuzda barındırılan arayüzler
Tek bir model seçicinin arkasında satıcı başına ayrı hesaplar yerine tek anahtar ve tek bakiye sunan masaüstü uygulamaları ve kendi sunucunuzda barındırdığınız arayüzler.
Yönetici Ayarları altında tek bir OpenAI bağlantısı veya kapsayıcı başlangıcında OPENAI_API_BASE_URL ve OPENAI_API_KEY — ikisi de aynı /v1'de sonlanır.
Settings → Model Services → özel sağlayıcı: anahtarı ve API adresini yapıştırın, Get Model List'e tıklayın ve tüm katalog seçicide doldurulsun.
API Host'u hizmet köküne ayarlanmış OpenAI API Compatible türünde bir sağlayıcı ekleyin — Chatbox /v1/chat/completions yolunu kendisi ekler.
Üç ortam değişkeni — OPENAI_API_KEY, OPENAI_PROXY_URL ve OPENAI_MODEL_LIST — Claude ve GPT'yi tek bir kendi barındırdığınız LobeChat seçicisine koyar.
SillyTavern'in Chat Completion kaynağını özel uç nokta ve tek API anahtarıyla Kunavo'ya yönlendirin — Claude ve GPT aynı model açılır listesindedir.
API Settings → Proxy → Add Configuration: Proxy URL tam /v1/chat/completions yoludur ve Model Name katalog kimliğiyle birebir aynı olmalıdır.
Ollama'nın OpenAI uyumlu yüzeyi ile Kunavo'nunki aynı biçimdedir; bu nedenle yerel Ollama için yazılmış araçlar temel URL değiştirilerek aktarılabilir.
AnythingLLM, adlandırılmış sağlayıcısı olmayan bir uç noktaya Generic OpenAI adlı tek seçenek üzerinden ulaşır — /v1 içeren Base URL, anahtar ve kendiniz yazdığınız model kimliği; çünkü liste getirmez.
Settings → Providers → "+", üç alandan özel sağlayıcı oluşturur — Provider name, https://api.kunavo.com/v1 olarak ayarlanmış API Base URL ve API Key — ardından Fetch model listesini uç noktadan okur.
Tek zorunlu alan — OpenAI-API-compatible eklentisinin Add Model formundaki API Base URL — bir Dify çalışma alanındaki her LLM düğümünü Kunavo'ya yönlendirir.
LibreChat, bir ağ geçidini librechat.yaml içinde endpoints.custom bloğu olarak alır — dört zorunlu alan, .env'den anahtar ve seçicide görünmeden önce yeniden başlatma.
Model Hub > Model Providers > Add Provider > Open AI Compatible: https://api.kunavo.com/v1 değerinde bir API Key ve Inference Endpoint — uygulamanın kendi notu, OpenAI uyumlu uç noktaların çoğunda /v1 gerektiğini söylüyor.
OpenAI kimlik bilgisinin Base URL alanına https://api.kunavo.com/v1 yazılması ve /v1'in korunması, bir n8n iş akışındaki her OpenAI Chat Model'i Kunavo'ya yönlendirir; model düğümünün kendisinde uç nokta alanı yoktur.
Üç ortam değişkeni — OPENAI_API_KEY, BASE_URL (yalnızca origin) ve CUSTOM_MODELS — kendi barındırdığınız bir NextChat'i tek anahtarla Claude ve GPT'ye bağlar.
Settings → Copilot → BYOK → Add a custom provider: Display name, anahtarınız ve https://api.kunavo.com/v1 — Quick Chat her zaman, Agent Chat ise sağlayıcı orada gösterildiğinde opencode altında kullanılabilir.
Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, /v1'i koruyan bir Base URL ve anahtar — ardından Page Assist'in kendisi getirdiği listeden model kimliklerini işaretleyin.
Models → Add custom model: tam Endpoint URL https://api.kunavo.com/v1/chat/completions, Bearer ve anahtarınızı içeren bir Authorization başlığı, Model ID ve bağlam uzunluğu — her model için bir girdi, doğrudan tarayıcınızdan çağrılır.
Diğer seçenekler
Burada listelenmeyen bir istemci de büyük olasılıkla çalışır. Ölçüt, uç noktayı değiştirmenize izin verip vermediğidir: “base URL”, “custom endpoint” veya “OpenAI-compatible provider” ayarı varsa Kunavo’yu buraya girebilirsiniz. Önce hızlı başlangıç kılavuzuyla başlayın; ardından istemcinin kullandığı biçime göre sohbet tamamlamaları veya Messages API sayfasına geçin. Model kimlikleri GET /v1/models adresinden alınır; bu adres, model açılır listesi bulunan istemcilerde listeyi de doldurur. Makine tarafından okunabilen sözleşmenin tamamı, çoğu istemci oluşturucusunun ve ajan çatısının doğrudan kullanabildiği OpenAPI 3.1 tanımıdır.