Головна / Посібники / Aider з безкоштовним LLM API

Aider з безкоштовним LLM API

Aider це парний програміст з відкритим кодом для термінала. Він редагує файли у вашому репозиторії git і створює коміти. Цей посібник підключає Aider до безкоштовних моделей через FreeLLMAPI. Він також показує параметри Aider, які важливі для безкоштовних моделей: формат правок, слабка модель і розмір карти репозиторію.

Код, назви моделей і мітки живого каталогу показано англійською.

Крок 1: встановіть FreeLLMAPI

FreeLLMAPI це шлюз з відкритим кодом. Він працює на вашому комп'ютері в Docker. Він об'єднує безкоштовні рівні 45 провайдерів за одним ключем, сумісним з OpenAI.

Встановлення на macOS або Linux

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

Відкрийте http://localhost:3001. Додайте щонайменше два безкоштовні ключі провайдерів на сторінці Keys. Скопіюйте свій уніфікований ключ з тієї самої сторінки.

Крок 2: підключіть Aider

Команда налаштування записує ~/.aider.conf.yml. Спочатку вона створює резервну копію наявного файлу.

Одна команда

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

Файл, який записує команда, виглядає так:

~/.aider.conf.yml

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

Префікс openai/ є обов'язковим. Він каже Aider надсилати назву моделі до API, сумісного з OpenAI. Щоб використовувати змінні середовища без файлу, зробіть так:

Лише змінні середовища

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

Aider шукає .aider.conf.yml у вашому домашньому каталозі, потім в корені репозиторію git, потім у поточному каталозі. Файл, який завантажується останнім, має пріоритет. Тому файл проєкту може змінити модель для одного репозиторію.

Крок 3: оберіть моделі

Aider надсилає ваші файли і карту репозиторію в кожному запиті. Для основного циклу правок йому не потрібен tool calling, бо він читає правки з тексту моделі. Важливіші великі вікна контексту і добре виконання інструкцій. Таблиця показує безкоштовні моделі з контекстом щонайменше 128K на сьогодні.

Безкоштовні моделі для Aider: контекст 128K+, за інтелектом
МодельБезкоштовно наКонтекстБезкоштовні ліміти (найкращі)ІнструментиЗображення
GLM 5.3APINex, UnoRouter1M5 запитів/хв
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
ТакНі
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +ще 11M40 запитів/хв
40 RPM
ТакТак
Gemini 3.8 FlashAPINex, Google AI Studio1M5 запитів/хв
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
ТакТак
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceТакНі
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditТакТак
Deepseek V4.1 FlashAPINex1M5 запитів/хв
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
НіНі
Gemini 3.7 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditТакТак
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 запитів/хв
50 запитів/добу
50 req/day account-wide (1,000 after a $10 purchase)
ТакТак
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 запитів/хв
50 запитів/добу
Shared rate limit
ТакНі
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetНіНі
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +ще 3262K30 запитів/хв
250 запитів/добу
70,000 токенів/хв
~6M
ТакТак

Показано 12 із 184 відповідних безкоштовних моделей. Переглянути всі моделі.

Дані в реальному часі з каталогу FreeLLMAPI (версія 2026.11.19, перевірено 2026-11-19). Безкоштовні ліміти часто змінюються. Каталог перевіряється щодня.

Використовуйте openai/auto, щоб маршрутизатор обирав модель. Використовуйте openai/auto:smart, щоб надавати перевагу моделям з найвищим інтелектом. Щоб закріпити одну модель, використовуйте openai/ і ID з каталогу з GET /v1/models.

Ви також можете задати моделі для однієї сесії в командному рядку. Цей приклад використовує найсильніші моделі для правок. Він використовує швидкі моделі для повідомлень комітів і підсумків історії чату:

Моделі для однієї сесії

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

Для запланованого профілю створіть ланцюжок резервних моделей на панелі керування FreeLLMAPI, наприклад ланцюжок з назвою coding. Потім використовуйте --model openai/auto:coding. Невідома назва профілю повертає помилку 400, тож запит не піде на інший ланцюжок без попередження.

Параметри Aider для безкоштовних моделей

Aider знає параметри для відомих моделей. Модель шлюзу, як-от auto, не відома, тож ці значення задайте самі.

ПараметрЩо він робитьРекомендоване значення для безкоштовних моделей
edit-formatФормат, який модель використовує для надсилання правок: whole, diff, diff-fenced або udiffdiff для сильних моделей. whole для слабких моделей, бо він простіший, але надсилає більше токенів.
weak-modelМодель для повідомлень комітів і підсумків історії чатуopenai/auto:fast, щоб малі завдання не витрачали квоту вашої сильної моделі
map-tokensКількість токенів для карти репозиторію. 0 вимикає її.1024 або менше на малих безкоштовних рівнях
architectОдна модель planує зміну, а модель-редактор пише правкиНеобов'язково. Це подвоює кількість запитів.

~/.aider.conf.yml з параметрами для безкоштовних моделей

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

Щоб передати Aider вікно контексту моделі шлюзу, додайте файл .aider.model.metadata.json. Ключ це повна назва моделі. Aider шукає цей файл у тих самих місцях, що й файл конфігурації.

~/.aider.model.metadata.json

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

Ліміти частоти і резервний перехід

Безкоштовні рівні мають ліміти за хвилину і за день. FreeLLMAPI рахує використання кожного ключа. Коли провайдер надсилає помилку 429, маршрутизатор передає запит наступній моделі у вашому ланцюжку. Aider не бачить помилку і продовжує роботу.

  • Додайте ключі від чотирьох або більше провайдерів. Більше провайдерів дають більше запитів на день.
  • Додавайте лише файли, які хочете змінити, командою /add. Кожен файл є в кожному запиті.
  • Використовуйте /clear між завданнями, щоб надсилати коротшу історію чату. Коротка історія також знижує токени за хвилину.
  • Використовуйте /drop, щоб видалити файли, які вам більше не потрібні.

Усунення несправностей

ПроблемаПричинаРішення
Попередження: "Model openai/auto: Unknown context window size and costs, using sane defaults."Aider не знає модель шлюзуЦе попередження зазвичай безпечне. Щоб його прибрати, додайте .aider.model.metadata.json.
Правка не застосуваласяМодель не дотрималася формату правокВикористовуйте --edit-format whole або сильнішу модель
401 "Invalid API key"Aider надсилає інший ключ, наприклад з іншого файлу конфігураціїПеревірте файли конфігурації в домашньому каталозі, корені git і поточному каталозі
Aider викликає api.openai.comВикористано префікс openai/, але базову адресу не заданоВстановіть openai-api-base або OPENAI_API_BASE
Помилка: "All models rate-limited after N attempts"Усі ключі досягли свого лімітуДодайте ключі від більшої кількості провайдерів або зменште map-tokens
Використовуйте кожну з цих моделей через один ключ. FreeLLMAPI це маршрутизатор з відкритим кодом, який ви розгортаєте самі. Він об'єднує всі ці безкоштовні тарифи за однією кінцевою точкою, сумісною з OpenAI, і переходить до наступного, коли один з них досягає ліміту. Переглянути каталог або або почніть роботу.

Часті запитання

Чи можна використовувати Aider безкоштовно?

Так. Aider має відкритий код. Вкажіть на FreeLLMAPI через openai-api-base і префікс моделі openai/. Шлюз використовує безкоштовні рівні провайдерів, тож вартість інференсу становить $0.

Як використовувати Aider з API, сумісним з OpenAI?

Встановіть OPENAI_API_BASE і OPENAI_API_KEY, потім запустіть aider --model openai/. Префікс openai/ є обов'язковим. Ті самі значення можна записати в .aider.conf.yml.

Який формат правок використовувати з безкоштовними моделями?

Використовуйте diff для сильних моделей, бо він надсилає менше токенів. Якщо правки не застосовуються, використовуйте whole. Він простіший для слабких моделей, але щоразу надсилає повний файл.

Що означає попередження 'Unknown context window size and costs, using sane defaults'?

Aider не знає назву моделі, тож використовує типові значення. Попередження зазвичай безпечне. Щоб його прибрати, додайте .aider.model.metadata.json з вікном контексту.

Яка безкоштовна модель найкраща для Aider?

Використовуйте модель з великим вікном контексту і добрим виконанням інструкцій. Таблиця на цій сторінці показує найсильніші безкоштовні моделі з контекстом 128K або більше на сьогодні.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі