Tumia Aider na API ya bure ya LLM
Aider ni mshirika wa programu wa chanzo huria kwenye terminal. Huhariri faili kwenye hazina yako ya git na kufanya commits. Mwongozo huu unaunganisha Aider na modeli za bure kupitia FreeLLMAPI. Pia unaonyesha mipangilio ya Aider muhimu kwa modeli za bure: muundo wa kuhariri, modeli dhaifu na ukubwa wa ramani ya hazina.
Msimbo, majina ya modeli na lebo za katalogi ya moja kwa moja zinaonyeshwa kwa Kiingereza.
Hatua ya 1: Sakinisha FreeLLMAPI
FreeLLMAPI ni lango la chanzo huria. Inaendeshwa kwenye kompyuta yako kwenye Docker. Inakusanya tabaka za bure za watoa huduma 45 nyuma ya ufunguo mmoja unaoendana na OpenAI.
Sakinisha kwenye macOS au Linux
curl -fsSL https://freellmapi.co/install.sh | bashFungua http://localhost:3001. Ongeza angalau funguo mbili za bure za watoa huduma kwenye ukurasa wa Keys. Nakili ufunguo wako wa umoja kutoka ukurasa huo huo.
Hatua ya 2: Unganisha Aider
Amri ya usanidi huandika ~/.aider.conf.yml. Kwanza hutengeneza nakala ya akiba ya faili lililopo.
Amri moja
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>
aiderFaili ambalo amri hii huandika linaonekana hivi:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"Kiambishi cha openai/ kinahitajika. Kinamwambia Aider kutuma jina la modeli kwa API inayoendana na OpenAI. Ili kutumia vigeu vya mazingira bila faili, fanya hivi:
Vigeu vya mazingira pekee
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider hutafuta .aider.conf.yml kwenye saraka yako ya nyumbani, kisha kwenye mzizi wa hazina yako ya git, kisha kwenye saraka ya sasa. Faili linalopakiwa mwisho lina kipaumbele. Kwa hiyo faili la mradi linaweza kubadilisha modeli kwa hazina moja.
Hatua ya 3: Chagua modeli
Aider hutuma faili zako na ramani ya hazina kwenye kila ombi. Haihitaji tool calling kwa kitanzi chake kikuu cha kuhariri, kwa sababu husoma mabadiliko kutoka kwenye maandishi ya modeli. Dirisha kubwa la muktadha na ufuataji mzuri wa maagizo ni muhimu zaidi. Jedwali linaonyesha modeli za bure zenye muktadha wa angalau 128K leo.
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 maombi/dakika 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Ndiyo | Hapana |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 zaidi | 1M | 40 maombi/dakika 40 RPM | Ndiyo | Ndiyo |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 maombi/dakika 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Ndiyo | Ndiyo |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Ndiyo | Hapana |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Deepseek V4.1 Flash | APINex | 1M | 5 maombi/dakika 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Hapana | Hapana |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 maombi/dakika 50 maombi/siku 50 req/day account-wide (1,000 after a $10 purchase) | Ndiyo | Ndiyo |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 maombi/dakika 50 maombi/siku Shared rate limit | Ndiyo | Hapana |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | Hapana | Hapana |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 zaidi | 262K | 30 maombi/dakika 250 maombi/siku 70,000 tokeni/dakika ~6M | Ndiyo | Ndiyo |
Inaonyesha 12 kati ya 184 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
Tumia openai/auto kuruhusu kipanga njia kuchagua modeli. Tumia openai/auto:smart kupendelea modeli zenye akili ya juu zaidi. Ili kubandika modeli moja, tumia openai/ na kitambulisho cha katalogi kutoka GET /v1/models.
Unaweza pia kuweka modeli za kikao kimoja kwenye mstari wa amri. Mfano huu unatumia modeli zenye nguvu zaidi kwa mabadiliko. Unatumia modeli za haraka kwa ujumbe wa commit na muhtasari wa historia ya gumzo:
Modeli za kikao kimoja
aider --model openai/auto:smart --weak-model openai/auto:fastKwa wasifu uliopangwa, tengeneza mnyororo wa akiba kwenye dashibodi ya FreeLLMAPI, kwa mfano mnyororo wenye jina coding. Kisha tumia --model openai/auto:coding. Jina la wasifu lisilojulikana hurudisha hitilafu 400, kwa hiyo ombi halielekezwi kwenye mnyororo mwingine bila taarifa.
Mipangilio ya Aider kwa modeli za bure
Aider inajua mipangilio ya modeli zinazojulikana. Modeli ya lango kama auto haijulikani, kwa hiyo weka thamani hizi mwenyewe.
| Mpangilio | Kazi yake | Thamani inayopendekezwa kwa modeli za bure |
|---|---|---|
edit-format | Muundo ambao modeli hutumia kutuma mabadiliko: whole, diff, diff-fenced au udiff | diff kwa modeli zenye nguvu. whole kwa modeli dhaifu, kwa sababu ni rahisi zaidi lakini hutuma tokeni zaidi. |
weak-model | Modeli ya ujumbe wa commit na muhtasari wa historia ya gumzo | openai/auto:fast, ili kazi ndogo zisitumie kiwango cha modeli yako yenye nguvu |
map-tokens | Idadi ya tokeni za ramani ya hazina. 0 huizima. | 1024 au chini kwenye tabaka ndogo za bure |
architect | Modeli moja hupanga mabadiliko na modeli ya kuhariri huandika mabadiliko | Si lazima. Inaongeza maradufu idadi ya maombi. |
~/.aider.conf.yml yenye mipangilio ya modeli za bure
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: 1024Ili kumpa Aider dirisha la muktadha la modeli ya lango, ongeza faili la .aider.model.metadata.json. Ufunguo ni jina kamili la modeli. Aider hutafuta faili hili mahali pale pale ilipo faili la mipangilio.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Vikomo vya kasi na failover
Tabaka za bure zina vikomo kwa dakika na kwa siku. FreeLLMAPI huhesabu matumizi ya kila ufunguo. Mtoa huduma anapotuma hitilafu 429, kipanga njia hutuma ombi kwa modeli inayofuata kwenye mnyororo wako. Aider haioni hitilafu hiyo na huendelea.
- Ongeza funguo kutoka kwa watoa huduma wanne au zaidi. Watoa huduma zaidi hutoa maombi zaidi kwa siku.
- Ongeza faili unayotaka kubadilisha pekee kwa
/add. Kila faili huwemo kwenye kila ombi. - Tumia
/clearkati ya kazi ili kutuma historia fupi ya gumzo. Historia fupi pia hupunguza tokeni kwa dakika. - Tumia
/dropkuondoa faili ambazo huhitaji tena.
Utatuzi wa matatizo
| Tatizo | Sababu | Suluhisho |
|---|---|---|
| Onyo linaloonekana: "Model openai/auto: Unknown context window size and costs, using sane defaults." | Aider haijui modeli ya lango | Onyo hili kwa kawaida si hatari. Ili kuliondoa, ongeza .aider.model.metadata.json. |
| Mabadiliko hayakutumika | Modeli haikufuata muundo wa kuhariri | Tumia --edit-format whole, au modeli yenye nguvu zaidi |
401 "Invalid API key" | Aider inatuma ufunguo tofauti, kwa mfano kutoka faili lingine la mipangilio | Angalia faili za mipangilio kwenye saraka ya nyumbani, mzizi wa git na saraka ya sasa |
| Aider inaita api.openai.com | Kiambishi cha openai/ kinatumika, lakini base URL haijawekwa | Weka openai-api-base au OPENAI_API_BASE |
| Ujumbe unaosema "All models rate-limited after N attempts" | Funguo zote zimefika kwenye kikomo chake | Ongeza funguo kutoka kwa watoa huduma zaidi, au punguza map-tokens |
Maswali yanayoulizwa mara kwa mara
Je, ninaweza kutumia Aider bila malipo?
Ndiyo. Aider ni chanzo huria. Ielekeze kwa FreeLLMAPI kwa openai-api-base na kiambishi cha modeli openai/. Lango hutumia tabaka za bure za watoa huduma, kwa hiyo gharama ya inference ni $0.
Ninawezaje kutumia Aider na API inayoendana na OpenAI?
Weka OPENAI_API_BASE na OPENAI_API_KEY, kisha endesha aider --model openai/
Nitumie muundo gani wa kuhariri kwa modeli za bure?
Tumia diff kwa modeli zenye nguvu, kwa sababu hutuma tokeni chache. Mabadiliko yakishindwa kutumika, tumia whole. Ni rahisi kwa modeli dhaifu lakini hutuma faili zima kila mara.
Ina maana gani 'Unknown context window size and costs, using sane defaults'?
Aider haijui jina la modeli, kwa hiyo hutumia thamani chaguo-msingi. Onyo hili kwa kawaida si hatari. Ongeza .aider.model.metadata.json yenye dirisha la muktadha ili kuliondoa.
Modeli ipi ya bure ni bora kwa Aider?
Tumia modeli yenye dirisha kubwa la muktadha na ufuataji mzuri wa maagizo. Jedwali la ukurasa huu linaonyesha modeli za bure zenye nguvu zaidi zenye muktadha wa 128K au zaidi leo.
Miongozo inayohusiana
- Tumia OpenCode kwa free LLM API
- Tumia Codex CLI na modeli bure
- API bora za bure za modeli za msimbo
- Base URL za free API zinazooana na OpenAI
- API ya LLM bure yenye muktadha wa tokeni milioni 1
Vyanzo
- Aider docs: OpenAI-compatible APIs (imekaguliwa 20 November 2026)
- Aider docs: YAML config file (imekaguliwa 20 November 2026)
- Aider docs: options reference (imekaguliwa 20 November 2026)
- Aider docs: edit formats (imekaguliwa 20 November 2026)
- Aider docs: model warnings (imekaguliwa 20 November 2026)
- Aider docs: advanced model settings (imekaguliwa 20 November 2026)
- FreeLLMAPI CLI generators (imekaguliwa 20 November 2026)