Goose'u özel bir OpenAI uyumlu endpoint üzerinde çalıştırın.

Hızlı yanıt: openai sağlayıcısını tutun, host'u geçersiz kılın.

Goose, belgelenmiş bir özel-endpoint yolu sunar: GOOSE_PROVIDER'ı openai olarak tutun ve o sağlayıcının işaret ettiği yeri geçersiz kılın. OPENAI_HOST, varsayılan api.openai.com host'unun yerini alır, OPENAI_API_KEY kimlik doğrular ve GOOSE_MODEL modeli tam id ile seçer. İstek yolu ayrıdır: OPENAI_BASE_PATH varsayılan olarak v1/chat/completions'a ayarlıdır ve normalde değişiklik gerektirmez. Şekli dikkatlice not edin, çünkü bu sınıftaki çoğu aracın tersidir: OPENAI_HOST, çıplak host'u alır, https://api.apisrouter.com, /v1 soneki olmadan. /v1/chat/completions kısmı OPENAI_BASE_PATH'te yaşar. Host'a /v1 eklemek yolu ikiye katlar ve bozuk bir gateway gibi görünen 404'ler üretir.

export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://api.apisrouter.com   # bare host, no /v1
export OPENAI_API_KEY=sk-APIsRouter-...
export GOOSE_MODEL=claude-sonnet-4-6

goose session

Goose sağlayıcısıyla nasıl konuşur.

Goose (GitHub'da block, kabaca 51K yıldız), Block'un görevleri planlayan, dosyaları düzenleyen, shell komutları çalıştıran ve MCP tabanlı uzantıları yöneten otonom mühendislik agent'ıdır. Bunların hepsi tek bir model konuşmasında oturur: döngünün her adımı, ekli tool tanımlarıyla bir /v1/chat/completions isteğidir, bu yüzden sağlayıcı yapılandırması tüm agent'ın nerede çalıştığına karar verir. Yapılandırma katmanlıdır. Etkileşimli yol goose configure'dur; openai sağlayıcısı için API anahtarını ve isteğe bağlı bir özel host'u sorar, ardından GOOSE_PROVIDER ve GOOSE_MODEL gibi sır olmayan ayarları ~/.config/goose/config.yaml'a yazar; masaüstü uygulaması aynı sağlayıcı ayarlarını kendi arayüzü üzerinden sunar. Sırlar ayrı ele alınır: anahtarlar sistem anahtar zincirine gider veya ortam değişkenlerinden gelir ve config.yaml'a doğrudan yapıştırılmış bir anahtar okunmak yerine yok sayılır. Ortam değişkenleri dosyayı geçersiz kılar; bu, yukarıdaki env yolunu bir dizüstünün shell'inden bir CI runner'ına kadar her yerde çalışır kılan şeydir. Goose, GOOSE_MODEL'i düz bir string olarak ilettiğinden, id, OPENAI_HOST'un arkasındaki endpoint'in sunduğu herhangi bir şey olabilir: bugün bir Claude id'si, yarın bir Kimi veya Qwen id'si, tek bir değişken uzağında.

Bildirimsel yol: özel bir sağlayıcı dosyası.

Env geçersiz kılmasının ötesinde, güncel Goose belgeleri ayrıca bildirimsel özel sağlayıcıları da tanımlar: ~/.config/goose/custom_providers/ içine bırakılan (Windows'ta platform başına yapılandırma dizini) ve yerleşiklerin yanına adlandırılmış bir sağlayıcı kaydeden bir JSON dosyası. Dosya, motoru (chat-completions endpoint'leri için openai), hangi ortam değişkeninin anahtarı tuttuğunu, endpoint URL'sini ve sağlayıcının sunduğu modelleri bildirir. Buradaki URL kuralına dikkat edin, çünkü tekrar tersine döner: OPENAI_HOST'un aksine, özel sağlayıcının base_url'si, yol dahil tam istek URL'sidir, https://api.apisrouter.com/v1/chat/completions. Her models girdisi, Goose'un paketleyebileceği pencereyi bilmesi için bir context_limit taşır. Bildirimsel dosya, gateway'in openai slotunu işgal etmek yerine Goose'un sağlayıcı listesinde kendi anahtar değişkeniyle kendi adlandırılmış sağlayıcısı olarak görünmesini istediğinizde daha iyi uyar. Env geçersiz kılması, CI ve hızlı geçiş için daha iyi uyar. Her ikisi de aynı endpoint'te sona erer; birini seçin ve onları üst üste yığmaktan kaçının.

{
  "name": "apisrouter",
  "display_name": "APIsRouter",
  "engine": "openai",
  "api_key_env": "APISROUTER_API_KEY",
  "base_url": "https://api.apisrouter.com/v1/chat/completions",
  "models": [
    { "name": "claude-sonnet-4-6", "context_limit": 200000 },
    { "name": "claude-opus-4-7",   "context_limit": 200000 },
    { "name": "kimi-k2.7-code",    "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Otonom bir agent için model seçmek.

Pratik iş akışı, görev setinizi sabit tutmak ve GOOSE_MODEL'i birkaç oturum boyunca iki veya üç aday üzerinden döndürmektir. Her aday aynı anahtar üzerinden yönlendirildiğinden, anahtar başına kullanım görünümü tarafınızdan hiçbir muhasebe olmadan her deneyi fiyatlandırır.

• Goose gözetimsiz uzun süreler çalıştırır: planla, düzenle, çalıştır, çıktıyı oku, tekrarla. Tool-çağırma güvenilirliği ham belagattan daha önemlidir; bu yüzden claude-sonnet-4-6 ve claude-opus-4-7, insanların ana döngü için yakınsadığı varsayılanlardır.
• kimi-k2.7-code gibi kodlamaya ayarlı id'ler, refactor ağırlıklı oturumlar için test edilmeye değer; bir gateway üzerinden bu test bir sağlayıcı göçü değil, tek bir GOOSE_MODEL değişikliğidir.
• Uzun oturumlar bağlamı katlar. Bildirimsel yolda context_limit ile dürüstçe bildirilen gerçek 200k'lık bir pencereye sahip bir model, Goose'un özetlemeden önce daha fazla oturum geçmişi taşımasına izin verir.
• Script'lenmiş veya CI kullanımı için, bir orta-katman id (gpt-5.4, qwen3.7-max) genellikle iyi kapsamlanmış görevler için sınır harcamasının bir kesriyle çıtayı geçer; varsayılan olarak yükseltmeden önce kendi görevlerinizde ölçün.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Goose'a özgü hata modları.

OPENAI_HOST'a eklenen /v1. Host değişkeni çıplak host'u alır; yol, zaten varsayılan olarak v1/chat/completions'a ayarlı olan OPENAI_BASE_PATH'te yaşar. Host olarak https://api.apisrouter.com/v1, /v1/v1/... istekleri ve 404'ler üretir. Bu, tam olarak her diğer aracın /v1 sonekini istemesi nedeniyle, tek en yaygın hatadır. Özel sağlayıcı dosyalarındaki tam-URL kuralı. Bildirimsel base_url, /v1/chat/completions dahil tam istek URL'sidir; OPENAI_HOST'un tam tersi kural. Bir özel sağlayıcı dosyasına çıplak bir host kopyalamak, onu tam bir URL'yi OPENAI_HOST'a kopyalamak kadar kesin biçimde bozar. config.yaml'daki anahtarlar kimlik doğrulamaz. Goose sırları anahtar zincirinden veya ortamdan okur ve config.yaml'a yerleştirilen anahtar değerlerini yok sayar. Dosyayı düzenledikten sonra 401 devam ederse, nedeni budur; değişkeni dışa aktarın veya goose configure'u yeniden çalıştırıp istendiğinde anahtarı girin. Masaüstü oturumları shell export'larını görmez. Masaüstü uygulaması terminal profilinizden hiçbir şey devralmaz. Sağlayıcıyı masaüstü ayarları arayüzü üzerinden yapılandırın veya değişkenleri ayarlı bir shell'den başlatın. Üst üste yığılmış yapılandırma kaynakları. Eski bir OPENAI_HOST export'u, config.yaml'da az önce ayarladığınızı geçersiz kılabilir, çünkü ortam dosyaya göre önceliklidir. Yönlendirme yanlış göründüğünde, herhangi bir katmanı suçlamadan önce Goose'u başlatan aynı shell'de ilgili değişkenleri yazdırın.

Goose'u bir gateway üzerinden kim yönlendirir.

• Satıcı başına bir kimlik bilgisi seti yerine Claude, GPT, Kimi ve Qwen'e tek bir anahtarın arkasında ulaşmak isteyen, Goose'u günlük sürücü olarak çalıştıran mühendisler.
• Goose'u CI'ye veya zamanlanmış işlere sokan ekipler. Yalnızca-env yolu, runner'ın tam olarak iki yönlendirme değişkenine ve bir sırra ihtiyaç duyduğu anlamına gelir; enjekte etmesi ve döndürmesi kolaydır.
• Agent modellerini gerçek görevlerde karşılaştıran geliştiriciler. Her aday, anahtar başına kullanımla otomatik olarak fiyatlandırılan aynı endpoint'e karşı tek bir GOOSE_MODEL değeridir.
• Birkaç satıcı panelini mutabakat yapmak yerine agent harcamasını anahtar başına ve model başına görünür isteyen platform ekipleri.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk oturumu hata ayıklayın.

Bir oturum başlatmadan önce gateway'in GOOSE_MODEL'deki id'yi sunduğunu doğrulayın; /v1/models listesi, sürüm sonekleri dahil yetkili yazımdır. İlk oturum başarısızlıkları tutarlıdır. 404, host ve yolun yanlış birleştiği anlamına gelir, neredeyse her zaman OPENAI_HOST'ta /v1. 401, anahtarın Goose'un baktığı yerde olmadığı anlamına gelir: onu başlatan shell'de dışa aktarılmamış, anahtar zincirinde değil veya işe yaramaz biçimde config.yaml'ın içinde oturuyor. Gateway'den bir model-not-found hatası, GOOSE_MODEL'de bir id yazım hatasıdır. Oturum başlarsa ama tool çağrıları tuhaf davranırsa, gerçekten tool kullanımını destekleyen bir modelde olduğunuzu kontrol edin; yukarıdaki tablodaki id'lerin hepsi destekler. Döngü çalıştığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Otonom bir agent, bunun en çok önem taşıdığı iş yüküdür: oturumlar uzundur, tool-çağrısı turları çoktur ve kullanım görünümü, bir öğleden sonraki Goose'un gerçekte neye mal olduğunu gördüğünüz yerdir.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -50

Sık sorulan sorular