Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Быстрый старт API бесплатного уровня

Статус: активно Область: текущее состояние Последняя проверка: 2026-08-28 Владелец: среда выполнения ax-code

AX Code не выдаёт квоту модели. «Бесплатный» запуск использует квоту или кредиты внешнего провайдера моделей, чья доступность, пределы, условия данных и каталог моделей могут меняться независимо от AX Code.

Самый короткий поддерживаемый путь: Groq

Groq — провайдер AX Code по умолчанию, его текущий каталог моделей AX Code содержит модели, способные вызывать инструменты, и Groq публикует пределы бесплатного плана для этих идентификаторов моделей.

Создайте аккаунт Groq и ключ API в консоли Groq.
Сохраните ключ в AX Code:

ax-code providers login groq

Подтвердите модели, доступные в установленном выпуске AX Code:

ax-code models groq

Откройте ax-code, выполните /connect и выберите Groq и одну из перечисленных моделей. Для безголовой дымовой проверки текущий комплектный каталог поддерживает:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Если ax-code models groq не печатает именно эту модель, используйте идентификатор модели, который печатается. Установленный каталог авторитетен для установленного выпуска.

Встроенные варианты бесплатного уровня и бесплатных кредитов

Эти провайдеры есть в выборе настройки AX Code по умолчанию. «Встроено» значит, что AX Code поставляет адаптер протокола, метаданные модели, поток учётных данных и конечную точку провайдера; это не значит, что каждая модель или каждый запрос бесплатны.

Провайдер AX Code	Путь без платы	Важное ограничение
`groq`	Бесплатный план Groq	Пределы частоты заданы на модель и аккаунт; сверьтесь с живыми пределами Groq.
`google`	Модели API Gemini бесплатного уровня	Подходят только модели, помеченные бесплатными в ценах API Gemini. Google заявляет, что содержимое бесплатного уровня может использоваться для улучшения его продуктов.
`unorouter`	Идентификаторы моделей, оканчивающиеся на `:free`	UnoRouter — сторонний шлюз. Его пределы бесплатных моделей намеренно низки, а доступность может колебаться.
`huggingface`	Повторяющийся кредит Inference Providers	Бесплатные аккаунты сейчас получают небольшой ежемесячный кредит, условия могут измениться; см. цены Hugging Face. Полная задача агента может его исчерпать.
`zai`	Текущие артикулы GLM-5.3 на API PAYG	Выбор AX Code начинается с GLM-5.3. Подключайте провайдера `zai`, а не `zai-coding-plan`, и сверьтесь с ценами Z.AI по текущему артикулу без платы.
`openrouter`	`openrouter/free` или вариант `:free`, специфичный для модели	Пресет провайдера встроен, но курируемый снимок AX Code сейчас не перечисляет бесплатный маршрутизатор. Добавьте его явно, как показано ниже.

Для UnoRouter подключитесь через ax-code providers login unorouter, выполните ax-code models unorouter и выберите модель, чей идентификатор оканчивается на :free. Не считайте платную пару без этого суффикса бесплатной. Собственный каталог UnoRouter отмечает, что не каждая бесплатная модель поддерживает вызов инструментов; AX Code показывает в комплектном каталоге только записи, способные вызывать инструменты.

Для Google или Hugging Face подключитесь с подходящим идентификатором провайдера, затем используйте ax-code models google или ax-code models huggingface. Перед выбором модели сверьтесь с живой страницей цен провайдера.

Добавьте маршрутизатор бесплатных моделей OpenRouter

OpenRouter документирует openrouter/free как маршрутизатор с нулевой стоимостью, который выбирает доступную бесплатную модель, совместимую с запросом. Поскольку этого маршрутизатора нет в текущем курируемом снимке AX Code, добавьте консервативную локальную запись модели в ax-code.json в корне проекта (или влейте её в глобальную конфигурацию AX Code):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Пределы выше — консервативные бюджетные значения AX Code, а не право от OpenRouter. Затем подключитесь и проверьте объединённый каталог моделей:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

Повтор openrouter намеренный: первый сегмент — идентификатор провайдера AX Code, а openrouter/free — идентификатор модели, которого ждёт OpenRouter. Доступность и выбор бесплатного маршрутизатора зависят от запроса; см. документацию бесплатного маршрутизатора OpenRouter.

Как пользоваться внешним каталогом бесплатных API

awesome-free-llm-apis полезен, чтобы узнавать текущие предложения, но это не список совместимости AX Code и не список одобрения:

У провайдера в Поддерживаемых провайдерах и моделях есть пресет настройки AX Code по умолчанию.
Провайдер, который лишь присутствует в models-snapshot.json, опирается на реестр и не обязательно курируется для потока настройки по умолчанию.
Другая служба может работать через Пользовательских провайдеров и шлюзы, если открывает совместимую конечную точку OpenAI или Anthropic.
«Совместимость с OpenAI» необходима, но недостаточна для кодирующего агента. Выбранной модели также нужны потоковые текстовые ответы и надёжный вызов инструментов и функций.
Имена провайдеров, идентификаторы моделей, бесплатные квоты, регионы и требования к аккаунту в сторонних списках могут устареть. Сверьте их с официальными страницами цен, моделей и пределов частоты провайдера, прежде чем на них опираться.

На дату проверки этой страницы службы, названные тем каталогом, соотносятся с AX Code так:

Отношение к AX Code	Службы каталога	Смысл
Пресет настройки по умолчанию	Google Gemini (`google`), Groq (`groq`), OpenRouter (`openrouter`), Hugging Face (`huggingface`), UnoRouter (`unorouter`)	Видны в обычном потоке настройки провайдера и разобраны выше.
Опора на реестр, не пресет по умолчанию	Mistral (`mistral`), Cohere (`cohere`), Zhipu AI (`zhipuai`), AnyAPI (`anyapi`), Cerebras (`cerebras`), NVIDIA NIM (`nvidia`), Cloudflare Workers AI (`cloudflare-workers-ai`)	Метаданные и адаптер есть в комплектном реестре, но провайдер не входит в курируемый поток настройки по умолчанию. Явная конфигурация не гарантирует, что бесплатная модель поддерживает инструменты агента.
Только пользовательский протокол	Api.Airforce, Kluster AI, LLM7.io, Pollinations AI	Пресета AX Code нет. Настраивайте точную конечную точку и модель, только если её текущий API совместим с контрактом пользовательского провайдера.

В частности, пресет github-copilot — это не API github-models, который перечисляют некоторые каталоги. Не подменяйте один идентификатор провайдера или поток учётных данных другим. Общие API zai и zhipuai начинаются с GLM-5.3; более старые артикулы GLM 3, GLM 4, GLM-5 и GLM-5.2 остаются отфильтрованными.

Безопасные практики оценки

Сначала проверяйте на публичном или одноразовом репозитории. Размещённый провайдер или шлюз получает запросы и контекст кода, отправленные в его API.
Включите изоляцию workspace-write или используйте read-only для дымовой проверки только с рецензией.
Начните с одной короткой задачи и одного агента. Council, арена, долгие сессии и большие репозитории могут потратить много запросов и быстро упереться в пределы бесплатного уровня.
Храните учётные данные через ax-code providers login или переменную окружения; никогда не фиксируйте ключи API в ax-code.json.
Считайте 429 и временную недоступность обычными ограничениями бесплатного уровня. Дождитесь окна повтора провайдера или выберите другую бесплатную модель из текущего списка.