Arahkan Aider ke base API OpenAI-compatible.

Jawaban singkat: dua env var dan satu prefix model.

Jalur OpenAI-compatible Aider yang terdokumentasi persis begini: export OPENAI_API_BASE dengan endpoint Anda, export OPENAI_API_KEY dengan key untuknya, dan beri prefix nama model dengan openai/ agar Aider berbicara protokol chat-completions ke base itu. String setelah prefix diteruskan apa adanya ke endpoint, jadi id apa pun yang dilayani gateway sah, termasuk id Claude dan DeepSeek. Itulah seluruh koneksinya. Di Mac dan Linux gunakan export; di Windows gunakan setx dan buka shell baru, karena setx tidak mempengaruhi sesi saat ini. Nilai yang sama bisa hidup di file konfigurasi Aider atau file .env jika Anda lebih suka konfigurasi per-proyek daripada state shell.

export OPENAI_API_BASE=https://api.apisrouter.com/v1
export OPENAI_API_KEY=sk-APIsRouter-...

aider --model openai/claude-sonnet-4-6

Bagaimana Aider me-resolve model dan provider.

Aider (Aider-AI di GitHub, sekitar 47K bintang) adalah pair programmer terminal orisinal: ia memetakan repo git Anda, menerima permintaan perubahan dalam chat, mengedit file langsung, dan commit hasilnya. Di baliknya ia merutekan panggilan model melalui litellm, itulah mengapa prefix openai/ penting: litellm membaca prefix untuk memilih protokol provider, dan openai/ berarti "chat-completions terhadap apa pun yang dikatakan OPENAI_API_BASE." Nama model tanpa prefix di-infer providernya dari ejaannya, yang merutekan id Claude ke API native Anthropic dan ANTHROPIC_API_KEY Anda alih-alih gateway Anda. Ada satu perilaku spesifik-Aider yang layak diketahui sebelum sesi pertama Anda: ia menyimpan registry kemampuan model sendiri, dan model yang tidak dikenalinya memicu peringatan "Unknown context window size and costs, using sane defaults", setelah itu Aider mengasumsikan context window tak terbatas dan biaya nol. Sesinya tetap berfungsi, tapi dua subsistem berguna menurun: budgeting token tidak bisa memperingatkan Anda sebelum benar-benar melewati batas context asli, dan tampilan biaya dalam sesi terbaca nol. Solusinya adalah file metadata kecil, dibahas di bawah, dan sepadan dengan dua menit. Aider juga menjalankan lebih dari satu model per sesi. Model main melakukan coding; model weak menangani pesan commit dan ringkasan chat; dan dalam mode architect, model editor terpisah menerapkan rencananya. Masing-masing menerima prefix openai/ yang sama, jadi ketiganya bisa dirutekan melalui gateway pada satu key.

Setup lengkap: koneksi plus metadata model.

Koneksinya adalah dua variabel di atas. Pemolesannya adalah mendaftarkan metadata agar Aider memperlakukan model gateway sebagai kuantitas yang dikenal. Buat .aider.model.metadata.json di home directory Anda, root repo git, atau working directory (atau lewatkan --model-metadata-file), dengan key berupa nama lengkap termasuk prefix openai/; field litellm_provider harus cocok dengan prefix itu. Dengan max_input_tokens terdaftar, budgeting context Aider bekerja terhadap window asli model alih-alih mengasumsikannya tak terbatas. File opsional kedua, .aider.model.settings.yml, menyetel perilaku per model: edit_format mengontrol bagaimana Aider meminta perubahan kode (varian diff untuk model yang bisa menanganinya, whole-file untuk yang tidak), dan use_repo_map mengontrol penyertaan repo-context. Aider tidak bisa menyimpulkan format edit terbaik untuk model yang tidak dikenalinya, jadi mendeklarasikannya adalah bedanya antara model terlihat medioker dan tampil sesuai levelnya.

{
  "openai/claude-sonnet-4-6": {
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/deepseek-v4-pro": {
    "max_input_tokens": 128000,
    "max_output_tokens": 16000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Memilih model main, weak, dan editor.

Sesi Aider panjang dan iteratif, yang membuat perbandingan model jujur secara tidak biasa di sini: jalankan feature branch yang sama dengan dua model main pada hari berbeda dan perbedaannya muncul di seberapa sering Anda mengetik /undo. Satu endpoint membuat setiap kandidat menjadi perubahan flag, dan penggunaan per-key memberi harga setiap eksperimen.

• Model main mengangkut setiap edit. Ia membaca repo map, bernalar atas file Anda, dan menghasilkan diff, jadi di sinilah claude-sonnet-4-6 atau gpt-5.5 berada; model yang gagap sintaks diff menghabiskan waktu review Anda di setiap perubahan.
• Model weak (--weak-model) menulis pesan commit dan merangkum riwayat chat. Ia menembak terus-menerus dan tidak pernah menyentuh kode, jadi rutekan ke id cepat dan murah melalui gateway yang sama daripada membiarkannya default ke tempat lain.
• Mode architect memisahkan perencanaan dari editing: model main merencanakan, model editor (--editor-model) menerapkan. Reasoner kuat yang merencanakan dengan id yang disetel untuk coding seperti kimi-k2.7-code yang menerapkan adalah pasangan yang tidak bisa diekspresikan key vendor tunggal.
• deepseek-v4-pro dan gpt-5.4 layak di-benchmark sebagai model main daily-driver pada kerja refactor-heavy, di mana volume token per sesi membuat perbedaan harga berlipat.

Bayar sesuai pemakaian · di bawah harga resmi

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Mode kegagalan spesifik Aider.

Mempercayai "sane defaults". Fallback model-tidak-dikenal mengasumsikan context tak terbatas dan biaya nol. Praktisnya, itu berarti Aider akan dengan senang hati membiarkan sesi panjang tumbuh melewati window asli model sampai gateway menolak request atau model diam-diam kehilangan context awal, dan tracker biaya menunjukkan tidak ada apa-apa sepanjang waktu. Daftarkan metadata; kedua masalah hilang. Menjatuhkan prefix openai/. Tanpanya, litellm menyimpulkan provider dari nama model. Id Claude dirutekan ke API Anthropic dan gagal pada ANTHROPIC_API_KEY yang hilang, yang terbaca seperti masalah key padahal masalah prefix. Metadata yang tidak cocok. Entri di .aider.model.metadata.json diberi key nama lengkap, termasuk prefix, dan litellm_provider harus setuju dengan prefix itu. Key id telanjang atau field provider yang tidak cocok diam-diam gagal diterapkan, dan Anda kembali ke default tanpa error yang mengatakannya. State shell Windows. setx menulis variabel hanya untuk shell masa depan. Menjalankan aider di terminal yang sama tempat Anda baru saja menjalankan setx menggunakan environment lama, dan 401 yang dihasilkan adalah masalah siklus-hidup shell, bukan masalah kredensial. Format edit yang salah. Model yang tidak terdaftar mendapat format edit default yang mungkin bukan yang ditanganinya terbaik. Jika model kuat terus menghasilkan edit yang ditolak Aider, atur edit_format secara eksplisit di .aider.model.settings.yml sebelum menyimpulkan model tidak bisa coding.

Siapa yang merutekan Aider melalui gateway.

• Pengguna Aider harian yang ingin Claude, GPT, dan DeepSeek bisa ditukar per sesi dengan --model, tanpa memelihara satu akun vendor per keluarga model.
• Developer yang memasangkan model main frontier dengan model weak cepat untuk pesan commit, keduanya ditagih ke satu key dengan visibilitas per sesi.
• Pengguna mode architect yang mencampur model perencanaan dan model editing dari vendor berbeda dalam sesi yang sama.
• Tim yang mengonboarding engineer dengan satu secret alih-alih checklist key vendor, dengan penggunaan per-key sebagai laporan biaya.
• Developer tanpa akses ke billing vendor tertentu. Akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan sign-up per provider.

Verifikasi endpoint dan debug sesi pertama.

Daftar model gateway sebelum memulai; id setelah openai/ harus cocok persis dengan id yang dilayani, termasuk suffix versi. Kegagalan sesi pertama cepat diurutkan. 401 berarti OPENAI_API_KEY tidak terlihat oleh shell yang meluncurkan aider (hanya shell baru di Windows setelah setx; cek echo di terminal yang sama). Error model-not-found dari gateway adalah salah ketik id. Error yang menyebut key vendor lain berarti nama model tanpa prefix dirutekan secara native. Dan peringatan model-tidak-dikenal saat startup bukan error, tapi itu cue Anda untuk menambahkan file metadata sebelum sesi panjang, bukan setelah mengenai batas context asli. Dalam sesi, pembacaan token dan biaya Aider sendiri menjadi akurat setelah metadata terdaftar, dan konsol APIsRouter menunjukkan sesi yang sama dari sisi endpoint: model per request, hitungan token, dan pengeluaran. Untuk pair programmer sepanjang hari, tampilan per-key itu adalah jawaban jujur untuk berapa biaya seminggu Aider sebenarnya.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -50

Pertanyaan umum