Pi Coding Agent model ayarları: /login, models.json ve özel Provider

Pi kodlama ajanının model ayarları üç katmana ayrılır: yerleşik sağlayıcılarda /login ile oturum açın (abonelik veya API anahtarı) ya da ortam değişkeni ayarlayın; Pi'de yerleşik olmayan ancak OpenAI, Anthropic veya Google API'leriyle uyumlu uç noktaları ~/.pi/agent/models.json içine yazın; yalnızca özel kimlik doğrulama veya protokol gerektiren hizmetler için eklenti yazmanız gerekir. Seçtikten sonra /model ile geçiş yapın.Bu yazı, Pi'nin 22 Eylül 2026'daki yeniden düzenlemeden sonraki belgelerine ve 30 Eylül 2026'da yayımlanan v0.99.2 kaynak koduna dayanarak her katmanın nasıl ayarlanacağını, anahtarların okunma sırasını (yeniden düzenlemeden sonra değişti), özel modellerde sessizce hataya yol açan üç varsayılan değeri ve OpenAI uyumlu bir uç noktaya bağlanmanın eksiksiz örneğini açıklar.

Önce hangi Pi olduğunu doğrulayın. Bu sayfa, Earendil şirketinin pi.dev adresinde yayımladığı terminal kodlama aracısı ve earendil-works/pi kitaplığı (eski adı badlogic/pi-mono) hakkında; lisansı MIT'tir. Inflection'ın sohbet botu Pi'si (pi.ai), Pi Network coin'i, Raspberry Pi veya başka bir yazarın Oh My Pi'si değildir.

Bağlantı yöntemini seçin

Pi'ninmodel belgeleri şu karşılaştırmayla başlar:

Pi, yerleşik bir model kataloğu içerir ve pi.dev üzerinden daha yeni katalog verileriyle genişletilebilir; çevrimdışıyken önbelleği kullanır. Zorla güncellemek için pi update --models çalıştırabilirsiniz. Özel model ayarı yalnızca Pi'de istediğiniz provider veya uç nokta yoksa gereklidir.

Pi'de model seçme

• /model: Model arayın ve seçin. Yalnızca provider'ın kullanılabilir kimlik doğrulamasına sahip modelleri listelenir.
• Model üzerinde Ctrl+S'ye basın: yeni çalışma oturumlarının varsayılan modeli olarak kaydedin.
• /thinking: Mevcut modelin düşünme düzeyini seçin. Pi yalnızca modelin desteklediği düzeyleri listeler; Ctrl+S'ye aynı şekilde basarak başlangıç varsayılanı olarak kaydedin.
• Ctrl+P: Kullanılabilir modeller arasında geçiş yapın; /scoped-models geçiş listesini denetler ve kaydeder.

Çalışma oturumu, model ve düşünme düzeyi değişikliklerini kaydeder. Oturumu geri yüklerken bunları geri yükler, ancak yeni çalışma oturumunun varsayılanlarını değiştirmez.

Anahtarların okunma sırası (yeniden düzenlemeden sonra değişti)

Birden fazla anahtar kaynağı aynı anda ayarlanmışsa Pi belgelerindeki sıra şöyledir: çalışma zamanındaki --api-key → auth.json içinde kayıtlı kimlik bilgileri → models.json içindeki apiKey → provider'ın ortam değişkenleri (veya bulut platformunun ortam kimlik bilgileri). Bu nedenle /login ile kaydedilmiş eski anahtar, dosyaya az önce yazdığınız anahtara göre öncelikli olarak kullanılır; bu, “ayarı değiştirdim ama hâlâ eski hesap kullanılıyor” sorununun en yaygın nedenidir. Kayıtlı kimlik bilgilerini kaldırmak için /logout kullanılabilir. 22 Eylül'deki yeniden düzenlemeden önce belgelerde ortam değişkenlerinin models.json önünde olduğu yazıyordu; internetteki eski kılavuzlar hâlâ eski sırayı kullanıyor olabilir.

Bir başka yaygın yanlış anlama: Bir modelin /model içinde görünmemesi çoğunlukla JSON hatası değil, kimlik doğrulama sorunudur. Belgeler, özel modellerin models.json üzerinden yüklenebileceğini söylüyor; ancak Pi kimlik bilgilerini çözümleyene kadar model “kullanılamaz” durumda kalır.

models.json: OpenAI uyumlu uç noktaya bağlanmanın eksiksiz örneği

Pi'nin kendi örneği yerel Ollama'dır — dummy anahtarı yalnızca modeli kullanılabilir hâle getirir; Ollama bunu denetlemez:

{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "ollama",
      "models": [{ "id": "qwen2.5-coder:7b" }]
    }
  }
}

Kunavo gibi kimlik doğrulaması gerektiren bir uç noktaya bağlanmak şöyle görünü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
        }
      ]
    }
  }
}

• baseUrl ve api zorunludur. Bunlar provider katmanında veya model katmanında yazılabilir; v0.99.2 kaynak koduna göre ikisinden biri eksikse Pi modeli yüklemez.
• api yalnızca dört seçenekle sınırlı değildir. 22 Eylül'deki yeniden düzenlemeden önce Pi belgeleri özel provider için dört değer listeliyordu: openai-completions, openai-responses, anthropic-messages, google-generative-ai. Yeniden düzenlemeden sonraki belgelerde liste kaldırıldı; yalnızca yukarıdaki karşılaştırma tablosunda “OpenAI, Anthropic veya Google uyumlu uç noktalar” ifadesi yer alıyor ve örneklerde yalnızca openai-completions kullanılıyor. v0.99.2 kaynak kodu api'yi herhangi bir dize olarak tanımlar ve on yerleşik uygulamadan karşılık gelenine aktarır — yukarıdaki dördüne ek olarak openai-codex-responses, azure-openai-responses, google-vertex, mistral-conversations, bedrock-converse-stream, pi-messages. Yalnızca ilk dört değer daha önce belgelerde özel provider kullanımı olarak yer alıyordu; diğer altısı burada test edilmedi ve bu sayfa bunların üçüncü taraf uç noktalarına bağlanabildiğini iddia etmiyor.
• openai-completions türü için baseUrl değeri /v1 içermelidir. Belgeler bunu tek cümleyle kural hâline getirmiyor, ancak uyumlu uç nokta örneklerinin tümünde sürüm yolu var. /v1 eksik olursa kimlik doğrulama hatası değil 404 alırsınız.
• Anahtarı sabit kodlamayın.apiKey ve header değerleri için $NAME veya ${NAME} ile ortam değişkenine başvurabilir, değeri doğrudan yazabilir ya da !指令 kullanabilirsiniz; belgelerde models.json içindeki komutun her istekte çalıştırıldığı ve önbelleğe alınmadığı belirtiliyor. auth.json ve anahtar alan tüm komutları gizli tutun.
• Değişiklikten sonra yeniden başlatmak gerekmez. /model açıldığında dosya yeniden okunur. models içindeki aynı ID'ye sahip öğeler provider'ın modeline eklenir veya onun yerini alır; yerleşik modelin meta verilerini tüm listeyi değiştirmeden değiştirmek için modelOverrides kullanın.

Sessizce hataya yol açan üç varsayılan değer

22 Eylül'deki belge yenilemesi alan tablosunu kaldırdı, ancak varsayılan değerler kaynak kodunda hâlâ mevcut (v0.99.2'de provider-composer.ts). Özel bir model için alan doldurulmazsa şu değerler uygulanır:

Ayrıca reasoning varsayılan olarak false, input ise varsayılan olarak yalnızca metindir. Yukarıdaki Kunavo örneğinde bağlam ve çıktı sınırları fiyatlandırma tablosuna göre doldurulmuştur; cost eklenmedi, çünkü dosyaya sabitlenen fiyatlar kısa sürede güncelliğini yitirir. Alt çubukta maliyet göstermek istiyorsanız milyon token başına fiyatları fiyatlandırma tablosuna göre kendiniz girin. Pi ayrıca promptCache özelliğini destekler (sağlayıcının önbelleğinin yaşam süresini saniye cinsinden belirtir ve önbelleği ısıtmak için kullanılır); belgeler, yayımlanan aralığın daha temkinli ucundaki değerin seçilmesini önerir.

anthropic-messages: bağlanabilir, ancak baseUrl kesin değil

anthropic-messages, yeniden düzenleme öncesi belgelerde özel provider için listelenen dört değerden biridir; Kunavo da Anthropic Messages arayüzü sunduğundan api: "anthropic-messages" yolu mevcuttur. Ancak Pi belgeleri bu tür için baseUrl değerinin /v1 içerip içermemesi gerektiğini hiçbir zaman açıkça belirtmedi: yeniden düzenleme öncesinde bir örnekte https://proxy.example.com/v1, diğerinde ise yol içermeyen https://proxy.example.com kullanılıyordu; yeniden düzenlemeden sonra iki örnek de kaldırıldı ve konu hâlâ netleşmedi. Bu yolu kullanacaksanız önce seçeneklerden birini deneyin; ilk istek 404 döndürürse (401 değil) bu satırı değiştirin. compat içinde asıl sağlayıcıya ait olmayan uç noktalar için özel olarak tasarlanmış bazı anahtarlar da bulunur (örneğin supportsEagerToolInputStreaming, supportsStrictTools), ancak belgeler uyumluluk ayarlarının “doğrulanmış davranış farklarını” açıklaması gerektiğini ve uç nokta OpenAI veya Anthropic ile uyumlu olduğunu iddia ediyor diye bu anahtarların açılmaması gerektiğini hatırlatır. Yukarıdaki openai-completions örneği bu sorunlardan kaçınır; onunla başlamanın önerilmesinin gerçek nedeni budur, daha hızlı olması değil.

Açık sözlülük ve ödeme

Yukarıdakiler Pi belgeleri ve kaynak kodunun incelenmesiyle hazırlanmış bir ayar referansıdır; Kunavo kendi uç noktasını Pi ile fiilen çalıştırmadı — çalışma oturumu, akış veya araç çağrısı gidiş-gelişi çalıştırılmadı ve isteğin sonunda hangi modele ulaşıldığı doğrulanmadı. Şu anda çalışan yolunuzu koruyun ve Pi'ye gerçek dosyaları okuyup yazan bir görev vererek deneyin; Pi neredeyse her adımda araç çağrısına dayandığından, ilk çalıştırma akış veya araç biçimi uyumsuzluklarını ortaya çıkarmak için en iyi testtir. İngilizce tam ayar sayfası Pi integration guide, çeşitli ücretli seçeneklerin (Earendil'in kendi Radius ağ geçidi dâhil) karşılaştırması ise Pi coding agent pricing adresindedir.

Kunavo ön ödemeli yükleme modeliyle çalışır; token başına ücretlendirilir ve aylık ücret yoktur. Minimum yükleme $10 tutarındadır; ödeme Stripe üzerinden yapılır ve Tayvan'da kredi kartları (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ve Link kullanılabilir. JKO Pay ve LINE Pay desteklenen yöntemler arasında değildir. Ayrıntılar için faturalandırma açıklamasına bakın; hazır olduğunuzda hesap oluşturabilir ve anahtar üretebilirsiniz.

Sık sorulan sorular

1 Ekim 2026'da doğrulandı: pi.dev/docs/latest/models (Choose a Model) ve providers sayfaları, earendil-works/pi v0.99.2 etiketi altındaki src/core/model-config.ts ve provider-composer.ts ile GitHub API sürüm bilgileri. Aynı gün api alanı ayrıca doğrulandı: models sayfasında şu anda hangi değerlerin listelendiği (yalnızca Ollama örneğindeki openai-completions), v0.99.2 model-config.ts içindeki api türü (herhangi bir dize, 191. ve 233. satırlar), provider-composer.ts'de özel model yönlendirmesi (579. satır) ve packages/ai/src/compat.ts içindeki BUILTIN_APIS (180. satır, toplam on tür). Kunavo kendi uç noktasını Pi ile fiilen çalıştırmadı.