Главная / Руководства / 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 отправляет ваши файлы и карту репозитория в каждом запросе. Для основного цикла правок ему не нужен вызов инструментов, потому что он читает правки из текста модели. Важнее большое окно контекста и хорошее следование инструкциям. Таблица показывает бесплатные модели с контекстом не менее 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Одна модель планирует изменение, а модель-редактор пишет правкиПо желанию. Это удваивает число запросов.

~/.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: размер контекстного окна и стоимость неизвестны, используются значения по умолчанию.»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
«Все модели достигли лимита после N попыток»Все ключи достигли своего лимитаДобавьте ключи от других провайдеров или уменьшите 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 и больше на сегодня.

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели