Pi

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

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com/v1",
      "api": "openai-completions",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-haiku-4-5",
          "name": "Claude Haiku 4.5",
          "input": ["text", "image"],
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Ortam değişkenine KUNAVO_API_KEY olarak ekleyin. Pi, apiKey alanında "$NAME" veya "${NAME}" değerini, ayrıca doğrudan bir değeri ya da başında !command bulunan bir değeri çözümler. Değişken adının ardından sabit metin geliyorsa süslü parantezli biçimi kullanın.
3. ~/.pi/agent/models.json dosyasını oluşturun veya düzenleyin ve yukarıdaki bloğu yapıştırın. Yerleşik olmayan bir sağlayıcı için baseUrl ve sağlayıcı ya da model düzeyinde bir api değeri gerekir — Pi'nin kaynak kodu bunlar olmadan modeli yüklemeyi reddeder — diğer her şey isteğe bağlıdır. /model açıldığında dosya yeniden yüklenir.
4. pi programını başlatın, /model komutunu çalıştırın ve tanımladığınız kimliklerden birini seçin. Listede görünmüyorlarsa JSON'dan önce anahtarı kontrol edin — yukarıdaki çözümleme sırası notuna bakın.
5. Gerçek bir dosyayı okuyup düzenlemesini gerektiren bir görev verin. Pi neredeyse yaptığı her şey için araç çağrımına dayanır; bu nedenle dosya sistemine dokunan ilk çalıştırma, bir selamlaşmadan çok daha fazla bilgi verir. Ayrıca akış veya araç şeması uyumsuzluğunu ortaya çıkaracak çalıştırma da budur; Kunavo'nun sizin için test etmediği şeyler tam olarak bu tür sorunlardır.

Pi'nin Model Seçme belgeleri ile 1 Ekim 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 Pi 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ış.

Diğer seçenek: anthropic-messages

22 Eylül 2026 tarihli güncellemeye kadar Pi, özel sağlayıcının api alanı için dört değer belgeliyordu: openai-completions, openai-responses, anthropic-messages ve google-generative-ai. Güncellenen modeller sayfasında bunların hiçbiri listelenmiyor: bir örnekte openai-completions gösteriliyor ve durum “OpenAI, Anthropic veya Google uyumlu bir uç nokta” olarak açıklanıyor. Pi'nin v0.99.2 kaynak kodunda bu alan serbest bir metin olarak tanımlanıyor ve on yerleşik uygulamadan eşleşene yönlendiriliyor — söz konusu dört uygulamanın yanı sıra openai-codex-responses, azure-openai-responses, google-vertex, mistral-conversations, bedrock-converse-stream ve pi-messages. Özel sağlayıcı için yalnızca bu dört değer belgelenmişti; diğer altı değerin hiçbiri burada test edilmedi. Bu sayfadaki hiçbir ifade bunlardan herhangi birinin üçüncü taraf bir uç noktada çalıştığını söylemiyor.

anthropic-messages, belgelenmiş dört değerden biridir ve Kunavo, OpenAI uyumlu arayüzün yanı sıra Anthropic Messages arayüzünü de destekler. Dolayısıyla bu rota yapılandırılabilir. Ancak bu sayfada, kopyalayıp yapıştıracağınız bloğa bir temel URL yazılmayacak: Pi'nin belgeleri bu api alanını hiçbir zaman kesinleştirmedi. 22 Eylül'e kadar bu alan iki farklı şekilde gösteriliyordu: bir örnekte https://proxy.example.com/v1, diğerinde yalın https://proxy.example.com. O günkü belge güncellemesi birini seçmek yerine ikisini de kaldırdı. Bu rotayı seçerseniz önce birini deneyin; ilk çağrı 401 yerine 404 dönerse değiştirmeniz gereken satır budur.

Bu api için Pi'nin compat şemasındaki üç alanı bilmeniz yararlı olur (kaynak kodu, v0.99.2). Belgelerde bu alanların tümü için belirtilen tek kuralı önce aktarmakta fayda var: uyumluluk ayarları “uç noktanın istek veya yanıt davranışındaki doğrulanmış farklılıkları açıklamalıdır. Bir uç nokta yalnızca OpenAI veya Anthropic uyumluluğu sunduğunu belirtiyor diye bu ayarları etkinleştirmeyin.”

1. compat.supportsEagerToolInputStreaming — araç başına girdi akışının önceden başlatılmasını reddeden bir arka uç için.
2. compat.supportsStrictTools — uç noktanın katı JSON şemalı araç tanımlarını kabul edip etmediğini belirtir; özel bir model, yerleşik Anthropic modelinin tanımladığı değeri devralmaz.
3. compat.supportsMidConvoEffort — konuşma sırasında akıl yürütme düzeyini değiştirmek için. Bu uç noktanın uygun olup olmadığı çalışma zamanında belirlenir; Kunavo bunu herhangi bir şey çalıştırarak doğrulamadı.

Sayfanın üstündeki openai-completions bloğu bu üç ayardan da kaçınır. İddia edilen daha iyi performans değil, buradan başlamanın dürüst gerekçesi budur.