Laman utama / Panduan / Guna Aider dengan API LLM percuma

Guna Aider dengan API LLM percuma

Aider ialah pasangan pengaturcara sumber terbuka untuk terminal. Ia menyunting fail dalam repositori git anda dan membuat commit. Panduan ini menyambungkan Aider kepada model percuma melalui FreeLLMAPI. Ia juga menunjukkan tetapan Aider yang penting untuk model percuma: format sunting, model lemah dan saiz peta repo.

Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.

Langkah 1: Pasang FreeLLMAPI

FreeLLMAPI ialah gerbang sumber terbuka. Ia berjalan pada komputer anda dalam Docker. Ia menghimpunkan peringkat percuma 45 pembekal di belakang satu kunci yang serasi dengan OpenAI.

Pasang pada macOS atau Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Buka http://localhost:3001. Tambah sekurang-kurangnya dua kunci pembekal percuma pada halaman Keys. Salin kunci bersatu anda daripada halaman yang sama.

Langkah 2: Sambungkan Aider

Arahan persediaan menulis ~/.aider.conf.yml. Ia membuat sandaran fail sedia ada dahulu.

Satu arahan

npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider

Fail yang ditulis oleh arahan itu kelihatan seperti ini:

~/.aider.conf.yml

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"

Awalan openai/ diperlukan. Ia memberitahu Aider untuk menghantar nama model kepada API yang serasi dengan OpenAI. Untuk guna pembolehubah persekitaran dan tanpa fail, buat begini:

Pembolehubah persekitaran sahaja

export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/auto

Aider mencari .aider.conf.yml dalam direktori rumah anda, kemudian dalam akar repositori git anda, kemudian dalam direktori semasa. Fail yang dimuatkan paling akhir mempunyai keutamaan. Oleh itu, fail projek boleh menukar model untuk satu repositori.

Langkah 3: Pilih model

Aider menghantar fail anda dan peta repo dalam setiap permintaan. Ia tidak memerlukan panggilan alat untuk gelung sunting utamanya, kerana ia membaca sunting daripada teks model. Tetingkap konteks yang besar dan ikutan arahan yang baik lebih penting. Jadual menunjukkan model percuma dengan sekurang-kurangnya konteks 128K hari ini.

Model percuma untuk Aider: konteks 128K+, mengikut kecerdasan
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
GLM 5.3APINex, UnoRouter1M5 permintaan/minit
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
YaTidak
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 lagi1M40 permintaan/minit
40 RPM
YaYa
Gemini 3.8 FlashAPINex, Google AI Studio1M5 permintaan/minit
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
YaYa
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceYaTidak
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditYaYa
Deepseek V4.1 FlashAPINex1M5 permintaan/minit
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
TidakTidak
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/minit
50 permintaan/hari
Shared rate limit
YaTidak
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetTidakTidak
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 lagi262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa

Memaparkan 12 daripada 184 model percuma yang sepadan. Lihat semua model.

Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.

Guna openai/auto untuk membenarkan penghala memilih model. Guna openai/auto:smart untuk mengutamakan model dengan kecerdasan tertinggi. Untuk memin satu model, guna openai/ dan ID katalog daripada GET /v1/models.

Anda juga boleh menetapkan model untuk satu sesi pada baris arahan. Contoh ini menggunakan model terkuat untuk sunting. Ia menggunakan model pantas untuk mesej commit dan ringkasan sejarah sembang:

Model untuk satu sesi

aider --model openai/auto:smart --weak-model openai/auto:fast

Untuk profil yang dirancang, buat rantai sandaran pada papan pemuka FreeLLMAPI, contohnya rantai bernama coding. Kemudian guna --model openai/auto:coding. Nama profil yang tidak diketahui memulangkan ralat 400, jadi permintaan tidak pergi ke rantai lain tanpa notis.

Tetapan Aider untuk model percuma

Aider mengetahui tetapan untuk model yang terkenal. Model gerbang seperti auto tidak diketahui, jadi tetapkan nilai ini sendiri.

TetapanFungsinyaNilai yang disyorkan untuk model percuma
edit-formatFormat yang digunakan model untuk menghantar sunting: whole, diff, diff-fenced atau udiffdiff untuk model yang kuat. whole untuk model lemah, kerana ia lebih mudah tetapi menghantar lebih banyak token.
weak-modelModel untuk mesej commit dan ringkasan sejarah sembangopenai/auto:fast, supaya tugas kecil tidak menggunakan kuota model kuat anda
map-tokensBilangan token untuk peta repo. 0 mematikannya.1024 atau kurang pada peringkat percuma yang kecil
architectSatu model merancang perubahan dan model editor menulis suntingPilihan. Ia menggandakan bilangan permintaan.

~/.aider.conf.yml dengan tetapan untuk model percuma

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024

Untuk memberi Aider tetingkap konteks model gerbang, tambah fail .aider.model.metadata.json. Kuncinya ialah nama model penuh. Aider mencari fail ini di tempat yang sama dengan fail konfigurasi.

~/.aider.model.metadata.json

{
  "openai/auto": {
    "max_input_tokens": 128000,
    "max_output_tokens": 8192,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Had kadar dan failover

Peringkat percuma mempunyai had seminit dan sehari. FreeLLMAPI mengira penggunaan setiap kunci. Apabila pembekal menghantar ralat 429, penghala menghantar permintaan itu kepada model seterusnya dalam rantai anda. Aider tidak melihat ralat itu dan terus berjalan.

  • Tambah kunci daripada empat pembekal atau lebih. Lebih banyak pembekal memberikan lebih banyak permintaan sehari.
  • Tambah hanya fail yang anda mahu ubah dengan /add. Setiap fail ada dalam setiap permintaan.
  • Guna /clear antara tugas untuk menghantar sejarah sembang yang lebih pendek. Sejarah yang pendek juga mengurangkan token seminit.
  • Guna /drop untuk membuang fail yang tidak diperlukan lagi.

Penyelesaian masalah

MasalahPuncaPenyelesaian
"Model openai/auto: Saiz tetingkap konteks dan kos tidak diketahui, menggunakan nilai lalai yang munasabah."Aider tidak mengetahui model gerbang ituAmaran ini biasanya tidak membahayakan. Untuk membuangnya, tambah .aider.model.metadata.json.
Sunting tidak digunakanModel tidak mengikut format suntingGuna --edit-format whole, atau model yang lebih kuat
401 "Invalid API key"Aider menghantar kunci lain, contohnya daripada fail konfigurasi lainSemak fail konfigurasi dalam direktori rumah, akar git dan direktori semasa
Aider memanggil api.openai.comAwalan openai/ digunakan, tetapi base URL tidak ditetapkanTetapkan openai-api-base atau OPENAI_API_BASE
"Semua model mencapai had kadar selepas N percubaan"Semua kunci telah mencapai hadTambah kunci daripada lebih banyak pembekal, atau kurangkan map-tokens
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

Soalan lazim

Bolehkah saya guna Aider secara percuma?

Boleh. Aider ialah sumber terbuka. Tunjukkan ia kepada FreeLLMAPI dengan openai-api-base dan awalan model openai/. Gerbang menggunakan peringkat pembekal percuma, jadi kos inferens ialah $0.

Bagaimana saya guna Aider dengan API yang serasi dengan OpenAI?

Tetapkan OPENAI_API_BASE dan OPENAI_API_KEY, kemudian jalankan aider --model openai/. Awalan openai/ diperlukan. Anda boleh meletakkan nilai yang sama dalam .aider.conf.yml.

Format sunting manakah patut saya guna dengan model percuma?

Guna diff untuk model yang kuat, kerana ia menghantar lebih sedikit token. Jika sunting gagal digunakan, guna whole. Ia lebih mudah untuk model lemah tetapi menghantar fail penuh setiap kali.

Apakah maksud 'Unknown context window size and costs, using sane defaults'?

Aider tidak mengetahui nama model, jadi ia menggunakan nilai lalai. Amaran ini biasanya tidak membahayakan. Tambah .aider.model.metadata.json dengan tetingkap konteks untuk membuangnya.

Model percuma manakah terbaik untuk Aider?

Guna model dengan tetingkap konteks yang besar dan ikutan arahan yang baik. Jadual pada halaman ini menunjukkan model percuma terkuat dengan konteks 128K atau lebih hari ini.

Panduan berkaitan

Sumber

Semua panduan · Lihat semua model percuma