Oh My Pi

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

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1
    api: openai-completions
    apiKey: KUNAVO_API_KEY       # an env-var name; literal text also works
    discovery:
      type: openai-models-list   # reads GET /v1/models

# Prefer a fixed list to a discovered one? Drop the discovery block and
# declare ids instead. Omitted metadata defaults to a 128,000-token context
# window and a 16,384-token output limit, so set the real numbers from
# /models when they differ.
#
#     models:
#       - id: claude-sonnet-5
#         name: Claude Sonnet 5
#         contextWindow: ...
#         maxTokens: ...

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. omp'yi başlatan kabukta KUNAVO_API_KEY olarak dışa aktarın. omp, önce apiKey değerini ortam değişkeni adı olarak çözümler; değişken bulunamazsa metni doğrudan anahtar olarak kullanır. Bu nedenle değişken adındaki bir yazım hatası sessizce yüklenir ve ilk istekte başarısız olur. ! ile başlayan değer ise kabuk komutu olarak çalıştırılır; bu, 1Password tarzı yöntemdir.
3. Yukarıdaki bloğu ~/.omp/agent/models.yml içine koyun. Sağlayıcı kimliğini — burada kunavo — kendiniz seçersiniz; bu kimlik her seçicinin ilk bölümünü oluşturur.
4. Dosyayı yüklemek ve yalnızca bu sağlayıcıyı listelemek için omp models kunavo komutunu çalıştırın. YAML veya şema sorunu varsa models.yml validation failed ve başarısız olan alan yazdırılır; omp models refresh kunavo ise önbelleğe alınmış kataloğu kullanmak yerine yeni bir keşif çağrısını zorlar.
5. Bunu tam bir seçiciyle deneyin: omp -p --model kunavo/claude-sonnet-5 "Reply with only OK". Ardından omp programını başlatın, /model komutunu yazın ve istediğiniz kimliği Default olarak atayın; model merkezi açıldığında models.yml dosyasını yeniden yükler. /switch, yalnızca geçerli oturumu değiştirir.

omp'nin Sağlayıcılar sayfası ile 21 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 Oh My 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ış.

Keşif: hangi tür seçilmeli ve seçicide ne görünür?

omp altı discovery.type değeri sunar ve bunlardan ikisi bir ağ geçidi için uygun görünür. Ancak yalnızca biri uygundur. proxy, “model satırlarında supported_endpoint_types bilgisi sunan, OpenAI ve Anthropic'i birlikte destekleyen bir proxy” için belgelenmiştir ve her modelin iletişim biçimini bu alana göre belirler. Kunavo GET /v1/models değerini yayımlamadığından proxy kullanıldığında tüm satırlar sağlayıcı düzeyindeki api değerine döner; bu değer de ayarlanmamışsa satırlar listeden çıkarılır. “Genel bir OpenAI uyumlu GET /v1/models uç noktası” olarak belgelenen openai-models-list kullanılması gereken seçenektir; yukarıdaki bloğun api: openai-completions içermesinin nedeni de budur: omp'nin kuralına göre “proxy dışında, keşif için sağlayıcı düzeyinde api gerekir”.

Seçiciyi açmadan önce bilmeniz gereken bir sonuç var. Kunavo'nun model listesi, etkin kataloğun tamamını içerir; bu nedenle keşfedilen bir sağlayıcıda sohbet modellerinin yanında görüntü, video ve müzik kimlikleri de görünür, ancak sohbet aktarımı bunları çağıramaz. Kunavo, sohbet satırlarında context_length değerini yayımlar. omp'nin modellerle ilgili belgelerine göre genel keşif bu alanı max_model_len alanından sonra okur; medya satırlarında ise bu alan bulunmaz. Bu nedenle bu satırlar gerçek bir değer yerine omp'nin varsayılan 128,000 belirteç değeriyle gelir. Kısa ve doğru bir seçici istiyorsanız keşif bloğunu kaldırın ve gerçekten kullandığınız üç veya dört kimliği tanımlayın.

omp ayrıca anthropic-messages protokolünü kullanabilir ve Kunavo /v1/messages rotasındaki isteklere yanıt verir. Bu sayfada bu ikili için bir yapılandırma bloğu sunulmuyor: burada atıf yapılan iki sayfada OpenAI uyumlu rota için temel URL biçimi açıklanıyor, ancak Anthropic rotasında sondaki /v1 bölümünün nasıl ele alındığı belirtilmiyor. Bir yapılandırma bloğunun amacı, okuyucunun onu kopyalayıp kullanabilmesidir. Bu yolu izlerseniz, Anthropic uyumlu bir uç noktada araç çağrıları 400 hatası verdiğinde belgelerde önerilen çözüm disableStrictTools: true ayarıdır.