Совместимый API

Подключение к Aida AI

Наш API совместим с форматом OpenAI и поддерживает как /v1/chat/completions, так и /v1/responses. Пользователь работает с публичными моделями, а списания идут с общего баланса аккаунта.

Базовый адрес

https://svobodanet.ru/v1

Авторизация Передавайте ключ в заголовке Authorization: Bearer sk-proj-....

Список моделей GET /v1/models возвращает только модели, доступные текущему API-ключу с учётом ограничений аккаунта и самого ключа.

Чат-запрос POST /v1/chat/completions обрабатывает сообщения и возвращает ответ в совместимом формате.

Responses API POST /v1/responses поддерживает формат, который используется Codex CLI и Codex plugin.

Использование GET /v1/usage и кабинет помогают контролировать токены, расходы и активность ключей.

Пример запроса

curl https://svobodanet.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-proj-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt_5_5",
    "messages": [{"role": "user", "content": "Сделай краткое резюме проекта"}],
    "max_tokens": 900,
    "temperature": 0.4
  }'

Пример ответа

{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "model": "gpt_5_5",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 800,
    "completion_tokens": 400,
    "total_tokens": 1200
  }
}

Настройка Codex CLI и Codex plugin

Для Codex рекомендуем использовать отдельный провайдер svobodanet в пользовательском файле ~/.codex/config.toml. Это работает и для CLI, и для VS Code-расширения, а модель выбирается из тех, что реально доступны вашему ключу через GET /v1/models.

Base URL

https://svobodanet.ru/v1

Ключ

ключ формата sk-proj-... из раздела API-ключи

Wire API

responses — именно этот формат ожидает Codex

Модели

любая модель или alias, которые возвращаются вашим ключом в /v1/models

1. Режимы доступа к файлам и консоли

Codex CLI и VS Code-плагин поддерживают три режима работы с файловой системой и терминалом вашего проекта. Режим задаётся параметром approval_policy в конфиге.

suggest

AI предлагает изменения, но каждое действие требует вашего ручного подтверждения. Самый безопасный режим.

auto-edit

AI автоматически редактирует файлы проекта, но перед запуском консольных команд запрашивает подтверждение.

full-auto

AI редактирует файлы и выполняет консольные команды без дополнительных вопросов. Рекомендуется для опытных пользователей.

В режиме full-auto модель получает полный доступ: чтение, создание и редактирование файлов в рабочей директории проекта, а также выполнение shell-команд (сборка, тесты, git, установка пакетов и т.д.). Используйте этот режим, когда хотите, чтобы AI работал автономно — как полноценный ассистент-разработчик.

2. Ручная настройка Codex CLI

Установите Codex CLI по официальной инструкции OpenAI, затем задайте API-ключ в отдельной переменной окружения и создайте пользовательский конфиг.

# Linux / macOS
export AIDA_API_KEY="sk-proj-..."
mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5-codex"
model_provider = "svobodanet"
approval_policy = "full-auto"

[model_providers.svobodanet]
name = "Svobodanet Aida AI"
base_url = "https://svobodanet.ru/v1"
env_key = "AIDA_API_KEY"
wire_api = "responses"
request_max_retries = 3
stream_max_retries = 6
supports_websockets = false
EOF

# Windows PowerShell
$env:AIDA_API_KEY = "sk-proj-..."
New-Item -ItemType Directory -Force "$HOME/.codex" | Out-Null
@'
model = "gpt-5-codex"
model_provider = "svobodanet"
approval_policy = "full-auto"

[model_providers.svobodanet]
name = "Svobodanet Aida AI"
base_url = "https://svobodanet.ru/v1"
env_key = "AIDA_API_KEY"
wire_api = "responses"
request_max_retries = 3
stream_max_retries = 6
supports_websockets = false
'@ | Set-Content "$HOME/.codex/config.toml"

После этого запустите codex doctor, затем обычный codex. В статусе должен определиться провайдер svobodanet, а запросы пойдут в /v1/responses.

3. Как выбирать разные модели сервиса в CLI

Codex CLI поддерживает именованные профили через файлы вида $CODEX_HOME/.config.toml и запуск codex -p . Не используйте старый синтаксис profile = "..." внутри config.toml — он больше не поддерживается.

# ~/.codex/gpt-5-codex-mini.config.toml
model = "gpt-5-codex-mini"
model_provider = "svobodanet"
approval_policy = "full-auto"

# ~/.codex/gpt_5_5.config.toml
model = "gpt_5_5"
model_provider = "svobodanet"
approval_policy = "full-auto"

codex -p gpt-5-codex-mini
codex -p gpt_5_5

Вместо gpt_5_5 можно подставить любую модель или alias, который виден вашему ключу. Проверка списка:

curl https://svobodanet.ru/v1/models \
  -H "Authorization: Bearer sk-proj-..."

4. Настройка Codex plugin в VS Code

Установите расширение openai.chatgpt, затем закройте VS Code и убедитесь, что переменная AIDA_API_KEY доступна всему приложению, а не только текущему терминалу. После этого создайте пользовательский файл ~/.codex/config.toml и заново откройте VS Code.

Linux/macOS: добавьте export AIDA_API_KEY="..." в ~/.bashrc, ~/.zshrc или другой startup-файл вашей оболочки.
Windows: задайте пользовательскую переменную среды AIDA_API_KEY через PowerShell или через параметры системы и затем полностью перезапустите VS Code.
Общий конфиг: используйте пользовательский ~/.codex/config.toml; на практике это надёжнее, чем repo-local .codex/config.toml для расширения.
Режим full-auto: в ~/.codex/config.toml укажите approval_policy = "full-auto", чтобы AI мог редактировать файлы и запускать команды без лишних вопросов.

Рекомендация: самый надёжный способ выбрать модель сервиса для VS Code-расширения — явно задать model = "..." и approval_policy = "full-auto" в пользовательском ~/.codex/config.toml и перезапустить VS Code. Если picker расширения не показывает пользовательские модели провайдера, это ограничение самого Codex extension, а не нашего API.

5. Автонастройка для популярных ОС

Готовые скрипты создают ~/.codex/config.toml, сохраняют резервную копию старого конфига, настраивают провайдера svobodanet с режимом full-auto и создают набор CLI-профилей для популярных моделей. Скрипты принимают параметр --approval-policy для выбора режима доступа.

Скачать setup-codex.sh Скачать setup-codex.ps1

# Linux / macOS — быстрая настройка с полным доступом
curl -fsSL https://svobodanet.ru/docs/downloads/setup-codex.sh -o setup-codex.sh
bash setup-codex.sh --api-key "sk-proj-..." --model "gpt-5-codex"

# С настройкой проектной директории
bash setup-codex.sh --api-key "sk-proj-..." --project-dir ~/my-project

# Только просмотр файлов, без автозапуска команд
bash setup-codex.sh --api-key "sk-proj-..." --approval-policy auto-edit

# Windows PowerShell — быстрая настройка
Invoke-WebRequest https://svobodanet.ru/docs/downloads/setup-codex.ps1 -OutFile setup-codex.ps1
powershell -ExecutionPolicy Bypass -File .\setup-codex.ps1 -ApiKey "sk-proj-..." -Model "gpt-5-codex"

# С настройкой проектной директории
powershell -ExecutionPolicy Bypass -File .\setup-codex.ps1 -ApiKey "sk-proj-..." -ProjectDir "$HOME\my-project"

# Только просмотр файлов, без автозапуска команд
powershell -ExecutionPolicy Bypass -File .\setup-codex.ps1 -ApiKey "sk-proj-..." -ApprovalPolicy auto-edit

Оба скрипта по умолчанию создают профили gpt-5, gpt-5-codex, gpt-5-codex-mini, gpt-5.1-codex и gpt-5.1-codex-mini с тем же режимом доступа. После этого CLI-профили можно запускать через codex -p <имя-профиля>.

6. Что умеет AI в режиме full-auto

Чтение файлов: анализирует структуру проекта, читает исходный код, конфиги и зависимости.
Редактирование файлов: создаёт и изменяет файлы проекта — код, тесты, документацию, конфигурации.
Консольные команды: запускает сборки, тесты, git-операции, установку пакетов и произвольные shell-скрипты.
Рефакторинг: находит и исправляет проблемы, оптимизирует код, добавляет типизацию.
Git workflow: создаёт коммиты, ветки, решает конфликты слияния.

7. Диагностика

401 / unauthorized: Codex не видит переменную AIDA_API_KEY. Проверьте окружение и полностью перезапустите VS Code.
Пустой список моделей: у ключа нет доступа ни к одной модели, либо ключ создан с жёстким allow-list.
Неправильная модель в VS Code: поменяйте model = "..." в ~/.codex/config.toml и перезапустите расширение/IDE.
Ошибка в profile: используйте codex -p my-profile и файл ~/.codex/my-profile.config.toml, а не устаревшее поле profile = "my-profile".
AI не редактирует файлы: проверьте, что в конфиге стоит approval_policy = "full-auto" или approval_policy = "auto-edit".
AI не запускает команды: для режима auto-edit команды требуют подтверждения. Переключитесь на full-auto или подтвердите команду вручную.
Проверка API напрямую: если сомневаетесь, сначала убедитесь, что этот же ключ успешно отвечает на GET /v1/models и POST /v1/responses.

Пример запроса для Responses API

curl https://svobodanet.ru/v1/responses \
  -H "Authorization: Bearer sk-proj-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt_5_5",
    "input": "Собери план рефакторинга",
    "max_output_tokens": 900,
    "temperature": 0.4,
    "reasoning": {"effort": "low"}
  }'