Pi

Blok provider khusus di ~/.pi/agent/models.json — baseUrl, api, dan model ids — menempatkan agen coding terminal Pi milik Earendil pada Claude dan GPT melalui satu key.

{
  "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
        }
      ]
    }
  }
}

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Simpan di environment sebagai KUNAVO_API_KEY. Pi memproses "$NAME" atau "${NAME}" di field apiKey, serta nilai literal atau awalan !command. Gunakan bentuk kurung kurawal jika teks literal mengikuti nama variabel.
3. Buat atau edit ~/.pi/agent/models.json, lalu tempel blok di atas. Provider nonbawaan memerlukan baseUrl dan nilai api di tingkat provider atau model—sumber Pi menolak memuat model tanpa keduanya—dan semua yang lain bersifat opsional. Membuka /model akan memuat ulang file.
4. Jalankan pi, jalankan /model, lalu pilih salah satu ID yang Anda deklarasikan. Jika ID tersebut tidak tercantum, periksa key sebelum JSON—lihat catatan urutan resolusi di atas.
5. Berikan tugas yang membaca dan mengedit file sungguhan. Pi mengandalkan pemanggilan alat untuk hampir semua hal yang dilakukannya, jadi uji coba pertama yang menyentuh sistem file memberi Anda jauh lebih banyak informasi daripada sekadar sapaan—dan uji coba inilah yang dapat mengungkap ketidakcocokan streaming atau skema alat, persis jenis hal yang belum diuji Kunavo untuk Anda.

Diperiksa terhadap Dokumentasi Pi tentang Pemilihan Model pada 1 Oktober 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 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.

Rute lainnya: anthropic-messages

Sebelum pembaruan dokumentasinya pada 22 September 2026, Pi mendokumentasikan empat nilai untuk api pada provider kustom: openai-completions, openai-responses, anthropic-messages, dan google-generative-ai. Halaman models yang diperbarui tidak mencantumkan satu pun: halaman itu menampilkan openai-completions dalam satu contoh dan menjelaskan kasusnya sebagai “Endpoint yang kompatibel dengan OpenAI, Anthropic, atau Google”. Sumber Pi v0.99.2 mendefinisikan field tersebut sebagai string bebas dan meneruskannya ke salah satu dari sepuluh implementasi bawaan yang cocok—empat nilai tadi ditambah openai-codex-responses, azure-openai-responses, google-vertex, mistral-conversations, bedrock-converse-stream, dan pi-messages. Hanya empat nilai yang pernah didokumentasikan untuk provider kustom, dan tidak satu pun dari enam nilai lainnya diuji di sini; halaman ini tidak menyatakan bahwa salah satunya berfungsi dengan endpoint pihak ketiga.

anthropic-messages adalah salah satu dari empat nilai yang didokumentasikan, dan Kunavo melayani antarmuka Anthropic Messages maupun yang kompatibel dengan OpenAI. Jadi, rute ini dapat dinyatakan dalam konfigurasi. Halaman ini tidak akan menuliskan base URL untuk rute tersebut ke dalam blok yang bisa Anda tempel: dokumentasi Pi belum pernah menetapkan field itu untuk api ini. Hingga 22 September, dokumentasi menampilkannya dalam dua bentuk—https://proxy.example.com/v1 pada satu contoh dan https://proxy.example.com tanpa tambahan pada contoh lain—lalu pembaruan dokumentasi pada hari itu menghapus keduanya tanpa memilih salah satunya. Jika Anda memilih rute ini, coba salah satunya; jika panggilan pertama menghasilkan 404, bukan 401, ubah baris itulah.

Tiga field dalam skema compat Pi untuk api ini perlu Anda ketahui sebelum sampai ke sana (sumber, v0.99.2), dan satu aturan dokumentasi tentang ketiganya layak dikutip terlebih dahulu: pengaturan kompatibilitas “seharusnya menjelaskan perbedaan perilaku permintaan atau respons endpoint yang telah diverifikasi. Jangan aktifkan hanya karena endpoint menyatakan kompatibel dengan OpenAI atau Anthropic.”

1. compat.supportsEagerToolInputStreaming — untuk backend yang menolak streaming input eager per alat.
2. compat.supportsStrictTools — apakah endpoint menerima definisi alat dengan skema JSON yang ketat; model kustom tidak mewarisi deklarasi model Anthropic bawaan.
3. compat.supportsMidConvoEffort — mengubah tingkat penalaran di tengah percakapan. Apakah endpoint ini memenuhi syarat merupakan pertanyaan runtime, dan Kunavo belum menjawabnya dengan menjalankan apa pun.

Blok openai-completions di bagian atas halaman ini tidak menggunakan ketiganya; itulah alasan yang jujur untuk memulai dari sana, bukan klaim bahwa hasilnya lebih baik.