Strona główna / Poradniki / Aider z darmowym API LLM

Aider z darmowym API LLM

Aider to programista w parze o otwartym kodzie źródłowym, działający w terminalu. Edytuje pliki w repozytorium git i tworzy commity. Ten poradnik łączy Aider z darmowymi modelami przez FreeLLMAPI. Pokazuje też ustawienia Aidera, które są ważne dla darmowych modeli: format edycji, słaby model i rozmiar mapy repozytorium.

Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.

Krok 1: Zainstaluj FreeLLMAPI

FreeLLMAPI to brama o otwartym kodzie źródłowym. Działa na Twoim komputerze w Dockerze. Łączy darmowe poziomy 45 dostawców za jednym kluczem zgodnym z OpenAI.

Instalacja na macOS lub Linux

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

Otwórz http://localhost:3001. Dodaj co najmniej dwa darmowe klucze dostawców na stronie Keys. Skopiuj swój ujednolicony klucz z tej samej strony.

Krok 2: Połącz Aider

Polecenie konfiguracji zapisuje ~/.aider.conf.yml. Najpierw tworzy kopię zapasową istniejącego pliku.

Jedno polecenie

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

Plik zapisany przez polecenie wygląda tak:

~/.aider.conf.yml

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

Prefiks openai/ jest wymagany. Mówi Aiderowi, żeby wysłał nazwę modelu do API zgodnego z OpenAI. Aby użyć zmiennych środowiskowych bez pliku, zrób tak:

Tylko zmienne środowiskowe

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

Aider szuka .aider.conf.yml w katalogu domowym, potem w katalogu głównym repozytorium git, a na końcu w bieżącym katalogu. Plik wczytany ostatni ma pierwszeństwo. Plik projektu może więc zmienić model dla jednego repozytorium.

Krok 3: Wybierz modele

Aider wysyła Twoje pliki i mapę repozytorium w każdym żądaniu. Do swojej głównej pętli edycji nie potrzebuje wywoływania narzędzi, bo odczytuje edycje z tekstu modelu. Ważniejsze są duże okno kontekstu i dobre wykonywanie instrukcji. Tabela pokazuje darmowe modele z co najmniej 128K kontekstu na dziś.

Darmowe modele dla Aidera: kontekst 128K+, według inteligencji
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
GLM 5.3APINex, UnoRouter1M5 żądań/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
TakNie
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 więcej1M40 żądań/min
40 RPM
TakTak
Gemini 3.8 FlashAPINex, Google AI Studio1M5 żądań/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
TakTak
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceTakNie
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditTakTak
Deepseek V4.1 FlashAPINex1M5 żądań/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NieNie
Gemini 3.7 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditTakTak
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 żądań/min
50 żądań/dzień
50 req/day account-wide (1,000 after a $10 purchase)
TakTak
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 żądań/min
50 żądań/dzień
Shared rate limit
TakNie
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetNieNie
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 więcej262K30 żądań/min
250 żądań/dzień
70,000 tokenów/min
~6M
TakTak

Pokazano 12 z 184 pasujących darmowych modeli. Zobacz wszystkie modele.

Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.

Użyj openai/auto, aby router wybrał model. Użyj openai/auto:smart, aby preferować modele o najwyższej inteligencji. Aby przypiąć jeden model, użyj openai/ i identyfikatora z katalogu z GET /v1/models.

Modele dla jednej sesji możesz ustawić też w linii poleceń. Ten przykład używa najmocniejszych modeli do edycji. Do komunikatów commitów i streszczeń historii czatu używa szybkich modeli:

Modele dla jednej sesji

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

Dla zaplanowanego profilu utwórz łańcuch zapasowy w panelu FreeLLMAPI, na przykład łańcuch o nazwie coding. Następnie użyj --model openai/auto:coding. Nieznana nazwa profilu zwraca błąd 400, więc żądanie nie trafi bez ostrzeżenia do innego łańcucha.

Ustawienia Aidera dla darmowych modeli

Aider zna ustawienia znanych modeli. Model bramy, taki jak auto, nie jest znany, więc te wartości ustawiasz sam.

UstawienieCo robiZalecana wartość dla darmowych modeli
edit-formatFormat, którego model używa do wysyłania edycji: whole, diff, diff-fenced albo udiffdiff dla mocnych modeli. whole dla słabych modeli, bo jest prostszy, ale wysyła więcej tokenów.
weak-modelModel do komunikatów commitów i streszczeń historii czatuopenai/auto:fast, aby małe zadania nie zużywały limitu mocnego modelu
map-tokensLiczba tokenów dla mapy repozytorium. 0 wyłącza ją.1024 lub mniej na małych darmowych poziomach
architectJeden model planuje zmianę, a model edytora pisze edycjeOpcjonalnie. Podwaja liczbę żądań.

~/.aider.conf.yml z ustawieniami dla darmowych modeli

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

Aby podać Aiderowi okno kontekstu modelu bramy, dodaj plik .aider.model.metadata.json. Kluczem jest pełna nazwa modelu. Aider szuka tego pliku w tych samych miejscach co pliku konfiguracji.

~/.aider.model.metadata.json

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

Limity szybkości i przełączanie awaryjne

Darmowe poziomy mają limity na minutę i na dzień. FreeLLMAPI liczy użycie każdego klucza. Gdy dostawca zwróci błąd 429, router wysyła żądanie do następnego modelu w łańcuchu. Aider nie widzi błędu i działa dalej.

  • Dodaj klucze od czterech lub więcej dostawców. Więcej dostawców daje więcej żądań dziennie.
  • Dodawaj tylko te pliki, które chcesz zmienić, przez /add. Każdy plik jest w każdym żądaniu.
  • Używaj /clear między zadaniami, aby wysyłać krótszą historię czatu. Krótka historia obniża też tokeny na minutę.
  • Użyj /drop, aby usunąć pliki, które nie są już potrzebne.

Rozwiązywanie problemów

ProblemPrzyczynaRozwiązanie
Komunikat "Model openai/auto: Unknown context window size and costs, using sane defaults."Aider nie zna modelu bramyTo ostrzeżenie zwykle jest nieszkodliwe. Aby je usunąć, dodaj .aider.model.metadata.json.
Edycja nie została zastosowanaModel nie trzymał się formatu edycjiUżyj --edit-format whole albo mocniejszego modelu
401 "Invalid API key"Aider wysyła inny klucz, na przykład z innego pliku konfiguracjiSprawdź pliki konfiguracji w katalogu domowym, w katalogu głównym git i w bieżącym katalogu
Aider wywołuje api.openai.comUżyto prefiksu openai/, ale base URL nie jest ustawionyUstaw openai-api-base albo OPENAI_API_BASE
Komunikat "All models rate-limited after N attempts"Wszystkie klucze są na limicieDodaj klucze od kolejnych dostawców albo zmniejsz map-tokens
Używaj wszystkich tych modeli przez jeden klucz. FreeLLMAPI to router o otwartym kodzie, uruchamiany na własnym serwerze. Łączy wszystkie te darmowe plany za jednym punktem końcowym zgodnym z OpenAI i przełącza się na inny dostawcę, gdy limit zostanie przekroczony. Przeglądaj katalog lub uruchom.

Najczęstsze pytania

Czy mogę używać Aidera za darmo?

Tak. Aider ma otwarty kod źródłowy. Skieruj go na FreeLLMAPI przez openai-api-base i prefiks modelu openai/. Brama używa darmowych poziomów dostawców, więc wnioskowanie kosztuje 0 USD.

Jak używać Aidera z API zgodnym z OpenAI?

Ustaw OPENAI_API_BASE i OPENAI_API_KEY, a potem uruchom aider --model openai/. Prefiks openai/ jest wymagany. Te same wartości możesz wpisać do .aider.conf.yml.

Którego formatu edycji używać z darmowymi modelami?

Używaj diff dla mocnych modeli, bo wysyła mniej tokenów. Jeśli edycje się nie stosują, użyj whole. Jest prostszy dla słabych modeli, ale za każdym razem wysyła cały plik.

Co oznacza 'Unknown context window size and costs, using sane defaults'?

Aider nie zna nazwy modelu, więc używa wartości domyślnych. Ostrzeżenie zwykle jest nieszkodliwe. Aby je usunąć, dodaj .aider.model.metadata.json z oknem kontekstu.

Który darmowy model jest najlepszy dla Aidera?

Użyj modelu z dużym oknem kontekstu i dobrym wykonywaniem instrukcji. Tabela na tej stronie pokazuje dziś najmocniejsze darmowe modele z kontekstem 128K lub większym.

Powiązane poradniki

Źródła

Wszystkie poradniki · Przeglądaj wszystkie darmowe modele