Dokümantasyon

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.

İki biçim /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.

OpenClawAnthropic

~/.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 AgentAnthropic

~/.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.

Claude CodeAnthropic

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

Kilo CodeOpenAI

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.

Roo CodeOpenAI

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.

ClineOpenAI

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.

Codex CLIOpenAI

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.

opencodeOpenAI

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.

Claude Code RouterAnthropic

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.

ZedOpenAI

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.

ContinueOpenAI

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.

AiderOpenAI

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.

CC SwitchAnthropic

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.

Claude Agent SDKAnthropic

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.

AmpOpenAI

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.

GitHub Copilot CLIOpenAI

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.

CrushOpenAI

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.

DeepSeek HarnessOpenAI

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.

DyadOpenAI

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 DroidAnthropic

~/.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.

gooseOpenAI

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.

Jan AgentOpenAI

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 CLIOpenAI

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 CodeOpenAI

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

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.

Mistral Vibe CLIOpenAI

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

Msty GoOpenAI

Settings &gt; Model Providers bir Base URL ve API anahtarı alır — belgelenen beş alandan ikisini Msty Go'nun kendi belgeleri test ederek belirlemenizi ister.

NanocoderOpenAI

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.

Oh My PiOpenAI

~/.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.

Open InterpreterOpenAI

~/.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.

OpenHandsOpenAI

Settings → LLM → Advanced üç alan alır — Custom Model, Base URL, API Key — model kimliğinde openai/ öneki bulunur ve temel URL /v1'i korur.

PiOpenAI

~/.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.

QoderOpenAI

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 CodeOpenAI

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.

Theia IDEOpenAI

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.

twinnyOpenAI

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.

Open WebUIOpenAI

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.

Cherry StudioOpenAI

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.

ChatboxOpenAI

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.

LobeChatOpenAI

Üç 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.

SillyTavernOpenAI

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.

Janitor AIOpenAI

API Settings → Proxy → Add Configuration: Proxy URL tam /v1/chat/completions yoludur ve Model Name katalog kimliğiyle birebir aynı olmalıdır.

OllamaOpenAI

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.

AnythingLLMOpenAI

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.

ChatWiseOpenAI

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.

DifyOpenAI

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.

LibreChatOpenAI

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.

Msty StudioOpenAI

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.

n8nOpenAI

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.

NextChatOpenAI

Üç 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.

Copilot for ObsidianOpenAI

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.

Page AssistOpenAI

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.

TypingMindOpenAI

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.