pi adalah coding agent minimalis yang jalan di terminal. Tidak ada panel dan tombol berlebihan: kamu mengetik instruksi, pi mengerjakannya langsung di repo kamu.
pi membaca daftar provider dari file models.json. Karena AI Gateway Appverse OpenAI-compatible, menyambungkannya hanya butuh satu file edit tanpa plugin apa pun.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- pi sudah terinstal. Belum? Jalankan npm install -g @mariozechner/pi.
- Satu Model ID dari tabel harga model.
Langkah integrasi
- 1
Ambil API key
Copy API key aktif dari dashboard gateway. Pemilik Token Plan mengambilnya dari halaman Token Plan karena key sudah di-assign ke akun saat pembayaran.
Key tertulis langsung di file konfigurasi. Jangan pernah meng-commit file itu ke git atau membagikannya, dan batasi izin aksesnya di komputer kamu.
- 2
Edit models.json
Buka atau buat file ~/.pi/agent/models.json, lalu tambahkan provider appverse.
Nilai api openai-completions artinya pi memanggil endpoint /v1/chat/completions, format yang dilayani gateway. Key ditulis langsung di field apiKey; file ini ada di folder home kamu, terpisah dari repo project.
~/.pi/agent/models.json { "providers": { "appverse": { "baseUrl": "https://ai.appverse.id/v1", "api": "openai-completions", "apiKey": "API_KEY_KAMU", "models": [ { "id": "MODEL_ID_DARI_DASHBOARD" } ] } } } - 3
Pilih model lewat /model
Jalankan pi, lalu buka menu /model. Model appverse yang tadi didaftarkan akan muncul di daftar.
Membuka /model juga me-reload isi models.json, jadi kamu tidak perlu restart pi setelah mengedit file. Tekan Ctrl+S di model pilihan untuk menjadikannya default sesi berikutnya.
- 4
Uji dengan prompt kecil
Minta pi melakukan edit kecil di satu file. Kalau respons keluar dan file benar-benar berubah, koneksi sudah siap dipakai untuk task lebih besar.
Tips pemakaian
- models.json ada di folder home kamu, terpisah dari repo project, jadi key di dalamnya tidak ikut ter-commit. Tetap jangan menyalin file ini saat membagikan konfigurasi ke orang lain.
- Isi array models dengan beberapa Model ID yang rutin dipakai supaya ganti model cukup dari menu /model.
- Kalau model yang baru ditambahkan tidak muncul, periksa dulu JSON-nya valid (tanpa koma menggantung), lalu buka lagi /model supaya file di-reload.
Pertanyaan yang sering muncul
Model appverse tidak muncul di menu /model. Apa yang salah?
Umumnya file models.json belum valid atau belum di-reload. Cek struktur JSON-nya, lalu tutup dan buka lagi menu /model karena pi me-reload file setiap menu itu dibuka.
Kenapa api-nya openai-completions, bukan format lain?
openai-completions adalah adapter pi untuk format OpenAI Chat Completions yang dilayani gateway di /v1/chat/completions. Format inilah yang paling universal untuk endpoint OpenAI-compatible.
Apakah prompt saya disimpan di gateway?
Tidak. Gateway menerapkan ZDR (Zero Data Retention): prompt dan response tidak disimpan, tidak dibaca, dan tidak dipakai untuk training.
Bagaimana menjadikan model gateway sebagai default?
Buka menu /model di dalam pi, arahkan ke model appverse pilihanmu, lalu tekan Ctrl+S. pi menyimpannya sebagai default untuk sesi berikutnya.