Oh My Pi

Blok provider di ~/.omp/agent/models.yml — baseUrl, api, apiKey — mengarahkan Oh My Pi ke Kunavo, dan discovery mengisi daftar model dari GET /v1/models.

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: ...

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Ekspor sebagai KUNAVO_API_KEY di shell yang menjalankan omp. omp terlebih dahulu menafsirkan apiKey sebagai nama variabel lingkungan, lalu jika tidak ditemukan, menganggap teks tersebut sebagai kunci literal. Jadi, salah ketik pada nama variabel akan terbaca tanpa pesan kesalahan, lalu gagal pada permintaan pertama. Nilai yang diawali ! justru dijalankan sebagai perintah shell — itulah cara penggunaan 1Password.
3. Letakkan blok di atas di ~/.omp/agent/models.yml. Id penyedia — kunavo dalam contoh ini — Anda tentukan sendiri dan menjadi bagian pertama dari setiap pemilih.
4. Jalankan omp models kunavo untuk memuat berkas dan hanya menampilkan penyedia ini. Masalah YAML atau skema akan mencetak models.yml validation failed beserta kolom yang gagal; omp models refresh kunavo memaksa pemanggilan penemuan baru, alih-alih menggunakan katalog yang tersimpan di cache.
5. Uji dengan pemilih persis: omp -p --model kunavo/claude-sonnet-5 "Reply with only OK". Lalu jalankan omp, ketik /model, dan tetapkan id yang diinginkan sebagai Default — pusat model memuat ulang models.yml saat dibuka. /switch hanya mengubah sesi saat ini.

Diperiksa terhadap Halaman Penyedia omp pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Oh My Pi.

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

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Penemuan: jenis apa yang digunakan, dan apa yang muncul di pemilih

omp menyediakan enam nilai discovery.type, dan dua di antaranya tampak cocok untuk gateway. Hanya satu yang benar. proxy didokumentasikan untuk “proksi campuran OpenAI/Anthropic yang baris modelnya menyatakan supported_endpoint_types”, lalu menentukan protokol wire setiap model dari kolom tersebut. GET /v1/models milik Kunavo tidak menyediakannya, jadi dengan proxy, setiap baris akan menggunakan api pada tingkat penyedia — atau, jika tidak diatur, akan dihapus. openai-models-list, yang didokumentasikan sebagai “endpoint generik GET /v1/models yang kompatibel dengan OpenAI”, adalah jenis yang harus digunakan. Itulah sebabnya blok di atas tetap menyertakan api: openai-completions: menurut aturan omp, “kecuali untuk proxy, penemuan memerlukan api pada tingkat penyedia”.

Ada satu konsekuensi yang perlu diketahui sebelum membuka pemilih. Daftar model Kunavo mencakup seluruh katalog yang diaktifkan, sehingga penyedia yang ditemukan akan menampilkan id gambar, video, dan musik bersama id chat, padahal transport chat tidak dapat memanggilnya. Kunavo mencantumkan context_length pada baris chat — yaitu kolom yang dibaca oleh penemuan generik omp setelah max_model_len, menurut dokumentasi modelnya — tetapi tidak mencantumkannya pada baris media. Karena itu, baris-baris tersebut akan memakai nilai default omp, yaitu 128,000 token, bukan jumlah yang sebenarnya. Jika Anda menginginkan pemilih yang ringkas dan akurat, hapus blok penemuan dan cantumkan tiga atau empat id yang benar-benar Anda gunakan.

omp juga dapat menggunakan anthropic-messages, dan Kunavo menerima /v1/messages. Halaman ini tidak menyertakan blok konfigurasi untuk pasangan tersebut: kedua halaman yang dirujuk di sini menjelaskan format URL dasar untuk rute yang kompatibel dengan OpenAI, tetapi tidak menjelaskan cara penanganan /v1 di akhir rute Anthropic. Padahal, tujuan blok konfigurasi adalah agar pembaca dapat langsung menyalinnya. Jika memilih rute tersebut,disableStrictTools: true adalah jawaban yang didokumentasikan untuk panggilan alat yang gagal dengan 400 pada endpoint yang kompatibel dengan Anthropic.