API429 / Codex CLI

Codex CLI с API429: профиль провайдера и Responses API

Codex CLI позволяет описать собственного провайдера и выбрать его отдельным профилем. Для API429 здесь используется Responses API с моделью gpt-6.1-sol. Руководство посвящено конфигурации терминального клиента: адрес, способ чтения ключа, транспорт и первые проверки. Сверка публичных документов не подтверждает полный агентный цикл с файлами и инструментами в вашей установленной версии.

Настройка сверена с публичной документацией приложения и API429. Полный запуск в Codex CLI, импорт в установленный клиент и агентные сценарии здесь не подтверждены. Начните с короткого несекретного запроса и проверьте ответ в своей версии.

Параметры подключения

Протокол
OpenAI Responses
Режим соединения
Отдельный профиль провайдера Codex
Base URL
https://gateway.api429.com/v1
Точный ID для проверки
gpt-6.1-sol

Доступ конкретного ключа проверяйте через GET /v1/models. Публичная карточка модели не гарантирует её доступность в приложении. Храните ключ в предусмотренном приложением защищённом хранилище или в окружении текущей сессии. Не передавайте значение ключа аргументом команды и не сохраняйте его в общих файлах проекта.

Установка и отдельный профиль

Сначала сравните системные требования с официальной страницей Codex CLI и проверьте codex --version. На дату сверки в npm наблюдалась версия 0.164.0; это наблюдение о пакете, а не результат установки на каждой операционной системе. Пример установки фиксирует эту версию, чтобы будущие изменения клиента не меняли смысл инструкции незаметно. Обновления затем проверяйте отдельно, прежде всего формат настроек и поддержку собственного провайдера.

Сохраните копию существующего пользовательского ~/.codex/config.toml и добавьте новые таблицы в него вручную. Не заменяйте весь файл примером и не меняйте сохранённую авторизацию других профилей. Таблица profiles.api429 выбирает модель и model_provider; таблица model_providers.api429 задаёт соединение. Если такие имена уже заняты, сначала разберите текущие настройки. Запуск с --profile api429 явно выбирает добавленный профиль.

Responses, ключ и транспорт

Адрес base_url заканчивается на /v1, а wire_api имеет единственное указанное здесь значение responses. Клиент добавляет путь /responses. Chat Completions — другой контракт: подмена значения на chat не является способом исправить ошибку. В публичном клиентском справочнике API429 описан POST /v1/responses с model и input, а также инструменты, выполняемые клиентом. Наличие метода само по себе не доказывает совместимость всех событий и действий агента.

Переменная env_key называется API429_API_KEY. requires_openai_auth=false нужен для этого способа чтения ключа: true переключает логику авторизации и игнорирует env_key. В примере ключ вводится скрыто в окружение текущей Bash-сессии, без значения в истории команды. supports_websockets=false выбирает документированный HTTP-путь. request_max_retries и stream_max_retries равны нулю; пользователь всё равно должен контролировать собственные повторные запуски и дальнейшие действия клиента.

Первая проверка и диагностика

Начните в пустой папке без секретов и рабочих файлов. Проверьте профиль и доступ точного ID под своим ключом, затем отправьте короткий текстовый запрос без поручения менять проект. Публичный каталог и GET /v1/models решают разные задачи: первый показывает опубликованные записи, второй помогает проверить доступ клиента. Ни одна такая проверка не заменяет наблюдение конкретного ответа Responses и поведения вашей версии CLI.

При ошибке авторизации проверьте имя переменной и выбранный профиль, не публикуя значение ключа. При ошибке пути сверяйте конечный /v1/responses и отсутствие повторного /v1. Если обычный текст принят, а агентный шаг падает, отдельно исследуйте события SSE и цикл client-executed tools. Не включайте hosted tools, Fast, Flex или WebSocket только потому, что они существуют у производителя. Их поддержка этим руководством не установлена.

Расход и пределы вывода

Число действий агента заранее неизвестно: чтение контекста, промежуточные ответы и следующий ход могут увеличивать оплачиваемый объём. Для текущего GPT-маршрута справочник API429 предупреждает, что max_output_tokens не применяется. Поэтому такое поле нельзя представлять как жёсткий предел расходов. Оценка ниже считает только гипотетические обычные токены и не обещает фиксированную стоимость часа работы Codex.

После одной ручной проверки сопоставьте использование в личном кабинете с выбранным ID и временем запроса. Перед расширением задачи установите собственный порядок контроля расходов и остановки работы. Подписка на приложение, условия доступа производителя и оплата запросов API429 — отдельные вопросы. Эта инструкция не обещает переноса подписочных функций, полного исполнения инструментов или успешного запуска на основе одного совпавшего адреса.

Настройки и примеры

Версия CLI в отдельной проверяемой установке

npm install -g @openai/codex@0.164.0
codex --version

Добавить таблицы в пользовательский config.toml, сохранив его содержимое

[profiles.api429]
model = "gpt-6.1-sol"
model_provider = "api429"

[model_providers.api429]
name = "API429"
base_url = "https://gateway.api429.com/v1"
env_key = "API429_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
request_max_retries = 0
stream_max_retries = 0

Bash: скрытый ввод ключа и ручной запуск профиля

read -r -s -p "API429 key: " API429_API_KEY
printf "\n"
export API429_API_KEY
codex --profile api429
unset API429_API_KEY

Расход и следующие шаги

Гипотетический объём за час: 30 запросов к gpt-6.1-sol, каждый с 5 000 обычных входных и 512 выходными токенами, — около $0.14 по текущим ставкам API429. Кеш, инструменты, повторы, подписка приложения и другие сборы не включены. Дата каталога: .

Фактический расход зависит от числа запросов, длины контекста и ответов — смотрите его в личном кабинете API429.

Общий протокол OpenAI Compatible · Документация API429 · Помощь и диагностика

Оплата и тест $10

  • Карта российского банка. Пополнение баланса в личном кабинете.
  • Счёт для юрлиц. Безналичная оплата с закрывающими документами.
  • USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте

Частые вопросы

Зачем запускать Codex с --profile api429?

Так явно выбирается добавленная таблица profiles.api429. Профиль ссылается на model_providers.api429; существующие настройки и сохранённую авторизацию других провайдеров не следует заменять примером.

Можно ли указать wire_api = "chat"?

В этой конфигурации используется Responses API: wire_api = "responses" и base_url с /v1. Chat Completions не заменяет требуемый Codex контракт.

Ограничивает ли max_output_tokens расходы Codex?

Для текущего GPT-маршрута API429 это поле не применяется. Оно не является бюджетным ограничителем. Проверяйте фактическое использование и число действий агента.

Что подтверждено для инструментов Codex?

Сверены публичные настройки провайдера и описание Responses с client-executed tools. Полный SSE/tool cycle установленного CLI, hosted tools и подписочные режимы не выполнялись и не подтверждены.

Источники

Справочник приложения определяет его интерфейс и ограничения; документация API429 — адреса, авторизацию и клиентские методы. Дата сверки: .

Telegram