Arahkan Aider ke asas API serasi OpenAI.

Updated 2026-07-29

Aider menyambung ke endpoint serasi OpenAI dengan dua pembolehubah persekitaran dan satu awalan model. Tetapkan OPENAI_API_BASE ke https://api.apisrouter.com/v1, jalankan aider --model openai/<model-id>, dan sesi pair programming dihalakan melalui satu kunci dengan setiap model katalog boleh dicapai.

Jawapan pantas: dua env var dan satu awalan model.

Laluan serasi OpenAI Aider yang didokumentasikan adalah tepat begini: eksport OPENAI_API_BASE dengan endpoint anda, eksport OPENAI_API_KEY dengan kunci untuknya, dan awalkan nama model dengan openai/ supaya Aider bertutur protokol chat-completions kepada asas itu. Rentetan selepas awalan diteruskan kepada endpoint, jadi mana-mana id yang dilayani gateway adalah adil, termasuk id Claude dan DeepSeek. Itulah keseluruhan sambungan. Pada Mac dan Linux guna export; pada Windows guna setx dan buka shell baharu, kerana setx tidak menjejaskan sesi semasa. Nilai yang sama boleh berada dalam fail konfigurasi Aider atau fail .env jika anda lebih suka konfigurasi per-projek berbanding keadaan 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 menyelesaikan model dan penyedia.

Aider (Aider-AI di GitHub, lebih kurang 47K bintang) ialah pair programmer terminal asal: ia memetakan repo git anda, menerima permintaan perubahan dalam sembang, mengedit fail secara terus, dan melakukan commit hasilnya. Di sebalik tabir ia menghalakan panggilan model melalui litellm, itulah sebab awalan openai/ penting: litellm membaca awalan untuk memilih protokol penyedia, dan openai/ bermaksud "chat-completions terhadap apa sahaja yang dinyatakan OPENAI_API_BASE." Nama model tanpa awalan disimpulkan penyedianya daripada ejaannya, yang menghalakan id Claude ke arah API asli Anthropic dan ANTHROPIC_API_KEY anda dan bukan gateway anda. Ada satu tingkah laku khusus Aider yang berbaloi diketahui sebelum sesi pertama anda: ia menyimpan daftar keupayaan modelnya sendiri, dan model yang tidak dikenalinya mencetuskan amaran "Unknown context window size and costs, using sane defaults", selepas itu Aider menganggap tetingkap konteks tanpa had dan kos sifar. Sesi masih berfungsi, tetapi dua subsistem berguna merosot: belanjawan token tidak dapat memberi amaran sebelum anda melebihi had konteks sebenar, dan paparan kos dalam sesi menunjukkan sifar. Penyelesaiannya ialah fail metadata kecil, dirangkumi di bawah, dan ia berbaloi dua minit itu. Aider juga menjalankan lebih daripada satu model setiap sesi. Model utama melakukan pengekodan; model lemah mengendalikan mesej commit dan ringkasan sembang; dan dalam mod arkitek, model editor berasingan melaksanakan pelan. Setiap satu menerima awalan openai/ yang sama, jadi ketiga-tiganya boleh dihalakan melalui gateway pada satu kunci.

Persediaan penuh: sambungan ditambah metadata model.

Sambungan ialah dua pembolehubah di atas. Kemasannya ialah mendaftarkan metadata supaya Aider menganggap model gateway sebagai kuantiti diketahui. Cipta .aider.model.metadata.json dalam direktori rumah anda, punca repo git, atau direktori kerja (atau lulus --model-metadata-file), berkunci dengan nama layak penuh termasuk awalan openai/; medan litellm_provider harus sepadan dengan awalan itu. Dengan max_input_tokens didaftarkan, belanjawan konteks Aider berfungsi terhadap tetingkap sebenar model dan bukan menganggap ia tanpa had. Fail kedua yang pilihan, .aider.model.settings.yml, melaraskan tingkah laku per model: edit_format mengawal bagaimana Aider meminta perubahan kod (varian diff untuk model yang mengendalikannya, fail-penuh untuk yang tidak), dan use_repo_map mengawal kemasukan konteks repo. Aider tidak dapat menyimpulkan format edit terbaik untuk model yang tidak dikenalinya, jadi mengisytiharkannya adalah perbezaan antara model kelihatan sederhana dan berfungsi pada tahapnya.

{
  "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 utama, lemah, dan editor.

Sesi Aider panjang dan berulang, yang menjadikan perbandingan model luar biasa jujur di sini: jalankan cawangan ciri yang sama dengan dua model utama pada hari berbeza dan perbezaannya muncul dalam kekerapan anda menaip /undo. Satu endpoint menjadikan setiap calon perubahan flag, dan penggunaan per-kunci mengharga setiap eksperimen.

  • Model utama membawa setiap edit. Ia membaca peta repo, menaakul ke atas fail anda, dan menghasilkan diff, jadi di sinilah tempat claude-sonnet-4-6 atau gpt-5.5 tergolong; model yang tersalah sintaks diff mengos anda masa semakan pada setiap perubahan.
  • Model lemah (--weak-model) menulis mesej commit dan meringkaskan sejarah sembang. Ia menembak berterusan dan tidak pernah menyentuh kod, jadi halakan ke id pantas dan murah melalui gateway yang sama dan bukan membiarkannya lalai ke tempat lain.
  • Mod arkitek memisahkan perancangan daripada pengeditan: model utama merancang, model editor (--editor-model) melaksanakan. Penaakul kuat merancang dengan id dilaraskan pengekodan seperti kimi-k2.7-code melaksanakan ialah gandingan yang tidak dapat diungkapkan kunci vendor tunggal.
  • deepseek-v4-pro dan gpt-5.4 berbaloi diuji tanda aras sebagai model utama pemandu harian pada kerja penuh refactor, di mana volum token per sesi menjadikan perbezaan harga berganda.

Bayar mengikut penggunaan · bawah harga rasmi

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

ModelHarga RasmiHarga Kami
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
GPT-5.4$2.50 / $15.00 per M$2.00 / $12.00 per M
DeepSeek V4 Pro$0.43 / $0.87 per M$0.40 / $0.90 per M
Kimi K2.7 Code$0.95 / $4.00 per M$1.00 / $4.00 per M

Mod kegagalan khusus Aider.

Mempercayai "sane defaults." Sandaran model tidak diketahui menganggap konteks tanpa had dan kos sifar. Secara praktikal, itu bermaksud Aider akan gembira membenarkan sesi panjang berkembang melebihi tetingkap sebenar model sehingga gateway menolak permintaan atau model senyap kehilangan konteks awal, dan penjejak kos menunjukkan tiada apa sepanjang masa. Daftarkan metadata; kedua-dua masalah hilang. Menjatuhkan awalan openai/. Tanpanya, litellm menyimpulkan penyedia daripada nama model. Id Claude dihalakan ke arah API Anthropic dan gagal pada ANTHROPIC_API_KEY yang hilang, yang kelihatan seperti masalah kunci sedangkan ia masalah awalan. Metadata yang tidak sepadan. Entri dalam .aider.model.metadata.json berkunci dengan nama layak penuh, termasuk awalan, dan litellm_provider harus bersetuju dengan awalan itu. Kunci id kosong atau medan penyedia tidak sepadan gagal secara senyap untuk terpakai, dan anda kembali ke lalai tanpa ralat menyatakan begitu. Keadaan shell Windows. setx menulis pembolehubah untuk shell masa depan sahaja. Menjalankan aider dalam terminal yang sama di mana anda baru sahaja menjalankan setx menggunakan persekitaran lama, dan 401 yang terhasil adalah isu kitaran hayat shell, bukan isu kelayakan. Format edit yang salah. Model tidak berdaftar mendapat format edit lalai yang mungkin bukan yang dikendalikannya terbaik. Jika model kuat terus menghasilkan edit yang ditolak Aider, tetapkan edit_format secara eksplisit dalam .aider.model.settings.yml sebelum membuat kesimpulan model itu tidak boleh mengekod.

Siapa yang menghalakan Aider melalui gateway.

  • Pengguna Aider harian yang mahu Claude, GPT, dan DeepSeek boleh ditukar per sesi dengan --model, tanpa menyelenggara akaun vendor setiap keluarga model.
  • Pembangun yang menggandingkan model utama frontier dengan model lemah pantas untuk mesej commit, kedua-duanya dibilkan ke satu kunci dengan ketertampakan per sesi.
  • Pengguna mod arkitek mencampur model perancangan dan model pengeditan daripada vendor berbeza dalam sesi yang sama.
  • Pasukan yang mengorientasikan jurutera dengan satu rahsia dan bukan senarai semak kunci vendor, dengan penggunaan per-kunci sebagai laporan perbelanjaan.
  • Pembangun tanpa akses kepada pengebilan vendor tertentu. Akses berasaskan top-up tanpa keperluan kad menghapuskan kebergantungan pendaftaran setiap penyedia.

Sahkan endpoint dan nyahpepijat sesi pertama.

Senaraikan model gateway sebelum bermula; id selepas openai/ mesti sepadan dengan id yang dilayani secara tepat, termasuk akhiran versi. Kegagalan sesi pertama disusun dengan pantas. 401 bermaksud OPENAI_API_KEY tidak kelihatan kepada shell yang melancarkan aider (shell baharu sahaja pada Windows selepas setx; semak echo dalam terminal yang sama). Ralat model-tidak-ditemui daripada gateway adalah kesilapan taip id. Ralat yang menyebut kunci vendor lain bermaksud nama model tanpa awalan dihalakan secara asli. Dan amaran model tidak diketahui semasa permulaan bukan ralat, tetapi ia isyarat anda untuk menambah fail metadata sebelum sesi panjang, bukan selepas mencapai had konteks sebenar. Dalam sesi, bacaan token dan kos Aider sendiri menjadi tepat sebaik sahaja metadata didaftarkan, dan konsol APIsRouter menunjukkan sesi yang sama daripada sisi endpoint: model per permintaan, kiraan token, dan perbelanjaan. Bagi pair programmer sepanjang hari, pandangan per-kunci itu ialah jawapan jujur untuk apa yang benar-benar dikos seminggu Aider.

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

Soalan lazim

Bagaimana saya menyambungkan Aider ke endpoint serasi OpenAI?

Eksport OPENAI_API_BASE dengan URL endpoint dan OPENAI_API_KEY dengan kuncinya, kemudian jalankan aider --model openai/<model-id>. Ini ialah laluan openai-compat Aider yang didokumentasikan; awalan openai/ memberitahu lapisan litellm-nya untuk bertutur chat-completions kepada URL asas anda.

Bolehkah Aider menjalankan model Claude atau DeepSeek melalui persediaan ini?

Ya. Id selepas openai/ diteruskan kepada endpoint sebagai rentetan biasa, jadi mana-mana model yang dilayani gateway berfungsi: aider --model openai/claude-sonnet-4-6 atau openai/deepseek-v4-pro. Kekalkan awalan, atau id akan disimpulkan penyedianya dan dihalakan keluar daripada asas anda.

Apa maksud amaran "Unknown context window size and costs"?

Aider tidak mengenali model itu, jadi ia menganggap tetingkap konteks tanpa had dan kos sifar. Sesi berfungsi, tetapi belanjawan konteks dan paparan kos salah. Daftarkan model dalam .aider.model.metadata.json, berkunci dengan nama openai/ layak penuhnya, dan amaran serta kedua-dua masalah itu hilang.

Adakah model lemah dan model editor turut dihalakan melalui gateway?

Ya, jika anda mengarahkannya ke sana: --weak-model openai/<fast-id> untuk mesej commit dan ringkasan, dan --editor-model openai/<id> dalam mod arkitek. Ketiga-tiga slot menerima awalan, jadi satu kunci boleh merangkumi campuran utama/lemah/editor merentas vendor.

Mengapa Aider masih meminta kunci Anthropic?

Nama model dimasukkan tanpa awalan openai/. litellm menyimpulkan vendor daripada nama itu dan mencuba laluan Anthropic asli, yang mahukan ANTHROPIC_API_KEY. Tambah awalan itu dan permintaan pergi ke OPENAI_API_BASE dengan kunci gateway anda sebaliknya.

Patutkah saya tetapkan edit_format untuk model gateway?

Untuk model yang tidak dikenali Aider, ya. edit_format dalam .aider.model.settings.yml mengawal bagaimana Aider meminta perubahan kod, dan model frontier secara amnya melakukan kerja terbaik dengan format diff. Membiarkan model tidak diketahui pada lalai boleh menjadikan model kuat kelihatan lebih teruk daripada sebenarnya.