Laras RouterDocs

Integrasi

Pi

Coding agent untuk terminal dengan provider kustom di models.json. Panduan setup langkah demi langkah dengan Laras Router.

Di halaman ini

Panduan ini menghubungkan Pi ke Laras Router. Setiap langkah sudah dicek dengan dokumentasi Pi.

Anda memerlukan API key (lr_live_…) dan saldo yang sudah diisi. Baru mengenal Laras Router? Mulai dari Quickstart.

Setup

Pasang Pi

Pasang Pi dengan npm. Perintahnya adalah pi.

Shell
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Simpan API key Anda

Simpan kunci Anda di variabel lingkungan.

Shell
export LARAS_API_KEY="lr_live_your_key_here"

Tambahkan provider

Buat ~/.pi/agent/models.json. Pi membaca folder itu secara default. Atur PI_CODING_AGENT_DIR untuk memakai folder lain.

~/.pi/agent/models.json
{
  "$schema": "https://pi.dev/schemas/models.schema.json",
  "providers": {
    "laras": {
      "baseUrl": "https://api.larasrouter.com/v1",
      "api": "openai-completions",
      "apiKey": "$LARAS_API_KEY",
      "models": [
        {
          "id": "deepseek-flash",
          "name": "DeepSeek-V4.1-Flash",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

Pilih model

Ekspor LARAS_API_KEY di terminal tempat Anda menjalankan Pi. Pi hanya menampilkan provider yang punya autentikasi yang bisa dipakai. Jalankan pi, ketik /model, lalu pilih DeepSeek-V4.1-Flash dari provider laras. Membuka /model memuat ulang models.json, jadi Anda bisa mengubah file tanpa memulai ulang Pi.

Perlu diketahui

  • contextWindow menyatakan context window penuh 1.000.000 token. Tanpa pengaturan ini, Pi memakai context window bawaannya yang lebih kecil.
  • maxTokens adalah batas output yang diminta Pi di setiap request. Batas ini juga menentukan berapa saldo yang harus ditahan selama request berjalan, jadi nilai yang lebih besar membutuhkan saldo lebih banyak. 8.192 adalah batas output default.
  • input hanya berisi text. deepseek-flash tidak menerima input gambar, jadi jangan kirim gambar ke model ini.
  • "$LARAS_API_KEY" membaca variabel dari lingkungan Anda, sehingga kunci itu sendiri tidak ikut tersimpan di file.
  • Buat API key terpisah untuk Pi dengan anggaran bulanan, supaya Anda bisa melihat dan membatasi pengeluarannya.

Pengaturan dan tampilan bisa berubah antarversi. Jika ada yang berbeda, periksa dokumentasi Pi. Untuk tool lain, lihat semua integrasi.