Dokümantasyon

goose

goose uç noktayı iki parçaya ayırır: Host URL ve kendisinin eklediği istek yolu. Yalın kaynak adresini verip yolu olduğu gibi bırakın; yerleşik OpenAI sağlayıcısı tek bir anahtarla Claude ve GPT ile iletişim kurar.

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.

Sağlayıcıları yapılandırın → OpenAI veya ortam

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

Host URL alanına /v1 eklemeyin. goose, OPENAI_BASE_PATH değerini “ana makineye eklenen istek yolu (varsayılanı v1/chat/completions)” olarak belgeliyor ve proxy kullanıcılarına OPENAI_HOST değerini “proxy'nizin kök yolu (sonunda yol olmadan)” olarak ayarlamalarını söylüyor. Biçimi bu iki bilgi belirliyor: alana kaynak adresi girilir, /v1 varsayılan yolla eklenir. https://api.kunavo.com/v1 girmek /v1/v1/chat/completions isteği oluşturur; aynı sayfaya göre 404, anahtarla değil yolla ilgili bir sorundur.

Bu yapılandırma, aşağıda belirtilen tarihte goose'un kendi belgelerinden derlendi. Kunavo, goose'u kendi uç noktasına karşı çalıştırmadı — oturum, akışlı bir tur veya araç gidiş dönüşü test edilmedi. Yayımlanmış bir kurulum sayfası test sayılmaz ve buradaki hiçbir ifade test edilmiş olarak yorumlanmamalıdır. Aşağıdaki curl on saniyede kontrol edebileceğiniz kısımdır; istemcinin davranışı sizinle goose arasındadır.

Kunavo hiçbir gömme, metinden konuşmaya veya konuşmadan metne modeli sunmadığından bu uç nokta yalnızca sohbet tamamlamalarını yanıtlar. Ses dökümü alan veya vektör dizini oluşturan goose yapılandırmanızdaki her şey, mevcut sağlayıcı anahtarını kullanmaya devam eder; OpenAI sağlayıcısını buraya yönlendirmek bu çağrıları taşımaz.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli goose kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
goose Desktop'ta: kenar çubuğu → Ayarlar → Modeller → Sağlayıcıları yapılandır → OpenAI. CLI'de: goose configure → Sağlayıcıları yapılandır → OpenAI.
API Key ve Host URL alanlarını doldurun. Organization ID ve Project alanlarını boş bırakın; goose bunları OpenAI'nin kendi hesaplarında kullanım takibi ve kaynak yönetimi için belgeliyor, Kunavo'da bu alanlara girilecek bir karşılık yok. Gönder'e tıklayın.
Modeli seçin. goose'un notunda açıkça, goose configure “özel model adlarının girilmesini desteklemez” deniyor. İstediğiniz kimlik dönen listede yoksa goose Desktop'ta yazın veya config.yaml içinde GOOSE_MODEL ayarlayın; bu değer, o süreç için dosyadakini geçersiz kılar.
Bir oturum başlatıp dosyaya dokunan bir görev verin. goose yaptığı işlerin neredeyse tamamında araç çağrısına dayanır. Kendi sağlayıcı sayfası, araç çağrısı olmayan bir modelin “yalnızca sohbet tamamlaması yapabildiği” ve bunun için eklentilerin devre dışı bırakılması gerektiği konusunda uyarıyor. Bu nedenle ilk denemede bir şeyi okuyup düzenlemek, selamlaşmadan daha fazla bilgi verir.

goose'un Configure LLM Provider sayfası ile 29 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar goose içinde çalışır.

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

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	goose içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	dosyaları düzenleyen oturumlar için varsayılan çalışma modeli
`claude-opus-5`	$3.50 / $17.50	yanlış yapmanın pahalıya mal olacağı bir değişikliği planlama
`claude-haiku-4-5`	$0.70 / $3.50	ucuz turlar — önceliklendirme, özetler, gün boyu çalışan döngü
`gpt-5-6-sol`	$2.00 / $12.00	başka bir aileden ikinci bir seçenek; aynı anahtar ve aynı Host URL

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Diğer yol: Kunavo'nun sağlayıcı dosyası

goose ayrıca custom_providers dizinindeki JSON dosyalarından sağlayıcı tanımlarını yükler. Bu yolla eklenen sağlayıcının seçicide kendi girişi, kendi anahtarı ve kayıtlı model listesi olur; OpenAI adlı yuvayı kullanması gerekmez. Kunavo, kunavo.com/goose/kunavo.json adresinde bir dosya yayımlıyor. Dosya canlı katalogdan oluşturulduğundan model listesi Kunavo'nun bugün sunduğu modelleri içerir; anahtarın kendisi yerine anahtar değişkeninin adını taşır:

terminal

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Windows'ta dizin %APPDATA%\Block\goose\config\custom_providers\ konumundadır. goose Desktop'ta sağlayıcı, Sağlayıcıları yapılandır altında Kunavo olarak görünür; burada anahtar ortam değişkeni yerine anahtarlığa kaydedilebilir.

Uç nokta. Dosya, base_url değerini https://api.kunavo.com/v1 olarak ayarlar. goose belgeleri, bu alanın /v1 temel adresini mi yoksa örneklerinde gösterilen tam /v1/chat/completions değerini mi istediğini açıklamıyor; kaynak kodu bunu belirliyor: derive_base_path her ikisini de aynı v1/chat/completions yoluna dönüştürüyor.
GPT kimlikleri Responses API'yi kullanır. goose, gpt-5 veya gpt-6 ile başlayan model kimliklerini /v1/responses adresine, diğer tüm kimlikleri ise /v1/chat/completions adresine gönderir. Kunavo her ikisini de sunduğundan dosyadaki Claude ve GPT kimlikleri tek anahtarla çalışır.
Yalnızca araç çağrısını destekleyen modeller listelenir. goose neredeyse her turda araçlara dayanır; bu yüzden aynı anahtarla çağrılabilseler de görsel, video ve ses modelleri dosyaya alınmamıştır.

Bu sayfanın geri kalanındaki uyarı burada da geçerlidir: bu yapılandırma goose'un belgeleri ve kaynak kodundan derlendi, çalıştırılarak test edilmedi. Sağlayıcıyı elle mi yazmak istersiniz? Sağlayıcıları yapılandır → Özel Sağlayıcı Ekle aynı bilgileri ister: tür OpenAI Compatible, API URL https://api.kunavo.com/v1, sk-kn- anahtarınız ve virgülle ayrılmış model listesi.

Sık sorulan sorular

goose'u özel bir OpenAI uyumlu API'ye nasıl yönlendiririm?

Yerleşik OpenAI sağlayıcısını kullanıp bir ana bilgisayar adresi verin. goose Desktop'ta bu, Ayarlar → Modeller → Sağlayıcıları yapılandır → OpenAI yolundadır; alanlar API Key, Host URL, Organization ID ve Project olarak görünür. CLI'de goose configure → Sağlayıcıları yapılandır → OpenAI komutları aynı değerleri sorar. Ortam değişkenleri olarak OPENAI_API_KEY ve OPENAI_HOST kullanılır. Birden fazla uç noktayı aynı anda kullanmanız gerekiyorsa goose'un Özel Sağlayıcı Ekle akışı her uç noktaya sağlayıcı listesinde ayrı bir giriş oluşturur.

goose Host URL alanının sonunda /v1 olmalı mı?

Hayır; eklemek isteği bozar. goose, OPENAI_BASE_PATH değerini ana bilgisayara eklenen istek yolu olarak belgeliyor ve varsayılanını v1/chat/completions olarak belirtiyor. Proxy kullanıcılarına OPENAI_HOST değerini, sonunda yol olmadan proxy'nin kök adresine ayarlamalarını söylüyor. Bu nedenle alana yalın kaynak adresi — https://api.kunavo.com — girilir; /v1 varsayılan yoldan gelir. Sonunda /v1 bulunan bir ana bilgisayar adresi /v1/v1/chat/completions isteğine yol açar; bu da kimlik doğrulama hatası yerine 404 döndürür.

Özel bir ana bilgisayar ayarladıktan sonra goose neden 404 döndürüyor?

goose'un kendi yanıtına göre 404 hatası genellikle temel yolun uç noktayla eşleşmediği anlamına gelir: proxy'lerin çoğu v1/chat/completions, bazıları ise v1 olmadan chat/completions sunar; ayarladığınız değer buna uymalıdır. Kunavo v1/chat/completions sunar; bu, goose'un varsayılanıdır. Dolayısıyla Kunavo'da 404 hatasının en olası nedeni /v1 değerinin ana bilgisayar adresine de yazılması ve böylece iki kez eklenmesidir. API anahtarının gönderilmediğini belirten 401 hatası ise başka bir sorundur; goose, config.yaml dosyasına konan anahtarın yok sayıldığını belgeliyor.

goose, OpenAI uyumlu bir uç nokta üzerinden Claude modellerini kullanabilir mi?

Evet. Sağlayıcı türü satıcıyı değil, iletişim protokolünü adlandırır: goose yapılandırdığınız ana bilgisayara OpenAI biçiminde bir sohbet tamamlama isteği gönderir ve model kimliğini doğrudan iletir. Böylece Claude kimliği goose'un içinde değil, uç noktada çözümlenir. goose araç çağrısını yoğun biçimde kullanır; sağlayıcı sayfasına göre araç çağrısı olmayan bir model yalnızca sohbet tamamlaması yapabilir ve eklentiler devre dışı bırakılmalıdır. Bu nedenle araçları destekleyen kimlikleri seçin.

Kunavo bu yapılandırmayı test etti mi?

Hayır. Kontrol edilenler, goose'un kendi belgeleridir (21 ve 29 Eylül 2026): alan adları, sıraları ve ana bilgisayar ile yol kuralı bu belgelerden aktarılmıştır. Sağlayıcı dosyası için goose'un sağlayıcı kaynak kodu da incelenmiştir (29 Eylül). Kunavo, goose oturumunu kendi uç noktasına karşı çalıştırmadı; bu istemcide akış, araç gidiş dönüşleri veya eklenti davranışları hakkında bir iddiada bulunmuyor. Tek başına doğrulayabileceğiniz şey uç noktanın ve anahtarın çalışıp çalışmadığıdır; bu sayfadaki curl komutu bunu kontrol eder.

goose için hazır Kunavo sağlayıcı dosyası var mı?

Evet: https://kunavo.com/goose/kunavo.json. Dosyayı goose'un custom_providers dizinine kaydedin (macOS ve Linux'ta ~/.config/goose/custom_providers/, Windows'ta %APPDATA%\Block\goose\config\custom_providers\), KUNAVO_API_KEY değerini ayarlayın; Kunavo, model kimlikleri önceden doldurulmuş olarak sağlayıcı listesinde görünür. Dosya canlı katalogdan oluşturulur, bu nedenle yalnızca Kunavo'nun şu anda sunduğu modelleri listeler ve anahtar içermez.