ВойтиПолучить доступ

Инструменты10 минобновлено

Codex API: что это и нужен ли он

Codex API обычно ищут, чтобы войти по ключу, оплатить расход OpenAI или запустить агента из скрипта. Для работы с файлами на компьютере можно войти через ChatGPT. При входе по API-ключу расход учитывается в OpenAI Platform и оплачивается отдельно от подписки. Ключ сам по себе не означает, что на счёте есть деньги.

Если у тебя уже есть ключ и ты хочешь понять, на сколько его хватит, проверь две вещи: дату истечения ключа у его владельца и баланс организации, которая оплачивает запросы. Это разные ограничения. Факты и команды сверены с официальными источниками 1 октября 2026 года; платные запросы для этого разбора не запускались.

Codex API: какой доступ ты ищешь

У запроса три частых смысла. Сначала выбери свой, чтобы не подключить оплату, которая тебе не нужна.

Что тебе нужно Где искать
Работать с Codex на компьютере Вход через ChatGPT или API-ключ, в зависимости от выбранного способа оплаты
Отправлять запросы модели из своей программы OpenAI API, доступные модели и их тарифы
Запускать самого агента по расписанию или из приложения Неинтерактивный режим codex exec либо Codex SDK

Есть и исторический смысл. Инструкции с code-davinci-002, code-davinci-001, code-cushman-002 и code-cushman-001 относятся к старым моделям Codex. OpenAI отключила их 23 марта 2023 года. Переустановка CLI такой пример не восстановит: нужна актуальная модель и нынешний интерфейс API. Дата подтверждается в истории отключений OpenAI.

Сам агент, который открывает файлы и выполняет задачи в проекте, описан в словаре Codex. Если программа ещё не установлена, начни с установки Codex.

Как проверить, чем сейчас оплачивается Codex

В обычном терминале выполни:

codex login status

Команда показывает текущий способ входа. Она не запускает задачу агента и не сообщает срок оплаченной подписки. Вход через ChatGPT даёт доступ по условиям твоего аккаунта и рабочего пространства; при входе по API-ключу расход учитывается в Platform. Эти варианты описаны в документации авторизации.

Вопрос Вход через ChatGPT Вход по API-ключу OpenAI
Где оплачивается работа В аккаунте или рабочем пространстве ChatGPT В организации OpenAI Platform
Где проверять остаток Страница расхода ChatGPT, в CLI также /status Billing для баланса, Usage для расхода API
Нужно ли отдельно оплачивать API Для работы через этот вход баланс API не используется Да, по правилам организации Platform
Можно ли открыть облачный Codex При доступности для аккаунта Облачный Codex требует входа через ChatGPT

Не меняй способ входа только потому, что в инструкции встретилось слово «API». Для своей первой задачи в установленном Codex API-ключ может не понадобиться. Для регулярного запуска без человека он удобен, но у организации появится отдельный расход.

Оплата OpenAI Codex API: какой счёт пополнять

Если выбран вход по ключу OpenAI, открой OpenAI Platform, выбери нужную организацию и перейди в Billing. Пополнение должно относиться к той организации, чьим ключом ты пользуешься. Платёж в другом аккаунте не подтверждает доступ этого проекта.

При предоплате запросы уменьшают кредитный баланс API. Если у организации другие условия расчётов, проверь их в Billing или уточни у администратора. OpenAI описывает порядок в справке о предоплате. Если баланс кончился посреди задачи, Codex обрывает ответ строкой stream disconnected before completion с текстом про кредиты - как её прочитать, разобрано в статье про эту ошибку.

Для покупки подписки ChatGPT или дополнительных кредитов Codex есть отдельный разбор как оплатить Codex. Кредиты ChatGPT и API имеют разное назначение. До платежа запиши для себя, что именно оплачиваешь: подписку, дополнительные кредиты ChatGPT или баланс API.

Я сам плачу за ChatGPT и Codex картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF

Способ оплаты не меняет поддерживаемые страны OpenAI, права проекта и доступность модели. Если отказ связан с регионом, пополнение счёта его не устраняет. Про такие отказы - Codex и VPN.

Расход по API зависит от выбранной модели и количества токенов, которые она получает и создаёт. Токены - небольшие части текста. Учитывается материал, переданный модели, поэтому длина твоей фразы не равна объёму всего запроса агента. Актуальные ставки с учётом кэширования и режима обработки проверь в таблице API pricing. Выбор модели разобран отдельно в моделях Codex.

Как узнать срок доступа по ключу Codex

Выясни, кто выдал ключ. Строка в настройках может относиться к OpenAI Platform, корпоративному доступу или стороннему шлюзу. Название Codex в инструкции не подтверждает происхождение ключа.

Для ключа OpenAI найди проект, в котором его создали, и проверь дату истечения в управлении ключами. Если проект ведёт другой человек, попроси владельца или администратора подтвердить дату и ограничения. В OpenAI можно создавать ключи проекта с датой истечения; администратор также может ограничить максимальный срок. Это описано в правилах безопасности ключей.

Для ключа стороннего шлюза смотри кабинет этого поставщика и условия своего заказа. Инструкция OpenAI не определяет срок пакета, ограничения моделей и баланс такого сервиса. Если кабинет не показывает срок, его должен подтвердить тот, кто выпустил ключ. Передавать сам ключ для вопроса о сроке не требуется.

Если ты вошёл через ChatGPT, отдельно проверь подписку и страницу расхода. У токенов входа есть свой срок, и Codex умеет обновлять их во время использования. Дата внутри токена не показывает, когда закончится оплаченный план. Не копируй auth.json на сайты для «проверки срока»: там хранятся данные доступа.

У доступа несколько независимых дат:

  • срок API-ключа, если он установлен;
  • срок купленных кредитов;
  • дата продления подписки;
  • срок сессии входа, которую клиент может обновлять.

Ключ могут отозвать раньше даты истечения, а средства могут закончиться при действующем ключе. Поэтому по самой строке ключа нельзя определить, сколько дней работы осталось. Для этого нужны сведения от владельца ключа и из его кабинета оплаты.

Где посмотреть остаток API и потраченные токены

Открой Usage в OpenAI Platform, выбери организацию и период. Здесь показана активность API. Для доступа нужны права владельца организации или разрешение на просмотр Usage. Время в кабинете указано в UTC - учитывай это, если сверяешь его с вечерним запуском по своему времени.

Баланс и сведения о кредитах находятся в Billing выбранной организации. Usage и Billing отвечают на разные вопросы: сколько использовано и чем можно оплатить следующую работу. Порядок подтверждён в справке о расходе API.

По числу токенов нельзя точно определить, сколько задач ещё можно выполнить. Следующая задача может потребовать другую модель, больше файлов или длинный ответ. Если ты работаешь через ChatGPT, вместо Platform смотри остаток лимита Codex. Ключ API - один из вариантов на случай, когда лимит подписки кончился, а сброса нет; остальные собраны в статье как сбросить лимиты Codex.

Как обратиться к Codex из скрипта

codex exec выполняет задачу без обычного интерактивного чата и умеет использовать сохранённый вход. Пример команды для разбора проекта:

codex exec --sandbox read-only "Опиши структуру проекта и предложи следующий шаг. Файлы не меняй."

Это пример для самостоятельного запуска, он не выполнялся при подготовке статьи. Запрос к модели использует твой лимит или оплачиваемый API. Перед запуском проверь codex login status, чтобы понимать способ расчётов.

При необходимости добавь --json, чтобы получить поток событий в формате JSON Lines для обработки другой программой. Способы авторизации и флаги описаны в неинтерактивном режиме Codex. Для обычной автоматизации документация рекомендует API-ключ. В доверенной среде предусмотрен и запуск с авторизацией через ChatGPT, поэтому правило «любой скрипт требует ключ» неверно.

Официальная команда входа берёт ключ из уже настроенной переменной окружения и передаёт его Codex через стандартный ввод:

printenv OPENAI_API_KEY | codex login --with-api-key

Здесь предполагается, что переменная заполнена безопасным способом. Не заменяй её настоящим ключом в статье, чужом примере или публичном скрипте. Команда меняет текущий вход - выполняй её, когда выбрал оплату по API.

Codex SDK: когда нужен программный интерфейс

SDK подходит, если другая программа должна создавать задачи агента и получать результат. OpenAI публикует библиотеки для TypeScript и Python:

npm install @openai/codex-sdk

или:

pip install openai-codex

Это установка библиотек для интеграции, её не нужно выполнять ради обычной сессии Codex. Примеры создания и продолжения задач находятся в документации SDK. Там же проверяй требования к версиям и доступность модели. Установленная библиотека сама по себе не подтверждает, что выбранный аккаунт имеет доступ к этой модели.

Где хранить ключ

Создай отдельный ключ для автоматизации и ограничь его права нужным проектом. Не помещай ключ в публичный код, браузерный JavaScript, переписку или скриншот. При замене ключа сначала настрой и проверь новый, затем отзови старый - такой порядок рекомендует OpenAI.

В Codex кэш входа может храниться в ~/.codex/auth.json или системном хранилище учётных данных. Настройка cli_auth_credentials_store выбирает место хранения. Например, keyring использует системное хранилище и требует, чтобы оно было доступно; ephemeral хранит данные только в памяти текущего процесса. Подробности есть в документации авторизации.

Для автоматизации учитывай, какой код имеет доступ к окружению. Не задавай OPENAI_API_KEY или CODEX_API_KEY для всего задания сборки, если в нём выполняется код из репозитория: тесты, скрипты и зависимости могут прочитать эти переменные. Передавай секрет только тому шагу, которому он нужен, и используй защиту секретов своей системы автоматизации.

Ошибка доступа: что проверить до нового платежа

Что произошло Первая проверка
401 или сообщение о неверном ключе Нужный ли ключ используется, действует ли он, не отозван ли, правильные ли организация и проект
429 Прочитай текст ошибки: ограничение частоты и исчерпание квоты требуют разных действий
Сообщение об исчерпанном балансе Billing организации API, если вход по ключу OpenAI
Облачный Codex требует входа Вход через ChatGPT и доступность облачного режима для аккаунта
Сообщение про неподдерживаемую страну Условия доступа по региону; не срок ключа

Коды подтверждены в справке ошибок API. Один номер ошибки не доказывает, что нужно покупать новый ключ. Сохрани сообщение без секрета, время и название модели - эти данные помогут владельцу проекта или поддержке проверить причину.

Чек-лист перед работой по ключу

  • codex login status показывает тот способ входа, который ты выбрал.
  • Ты знаешь владельца ключа и организацию, которая оплачивает расход.
  • Дата истечения проверена в проекте или у поставщика доступа.
  • Баланс API проверен отдельно от подписки и кредитов ChatGPT.
  • Ключ не попал в код, чат или скриншот.
  • Модель доступна этому аккаунту, ты проверил её тариф до запуска.

Если всё это понятно, переходи к первой задаче в Codex. Разбор оплаты подписки находится в соседней статье, а проверка остатка и времени сброса - в лимитах Codex.

Читайте также: Номер для Codex: как пройти проверку телефона

Спрашивают

Пять вопросов по теме

Что означает запрос Codex API?

Так ищут вход в Codex по API-ключу, доступ к моделям OpenAI или запуск агента из программы. Для агента документация описывает codex exec и Codex SDK. Старые примеры с code-davinci и code-cushman относятся к моделям, закрытым в 2023 году.

Нужен ли API-ключ, чтобы пользоваться Codex?

Для обычной работы можно войти через ChatGPT, если Codex доступен твоему аккаунту. API-ключ нужен при выборе оплаты через OpenAI Platform. Он удобен для автоматизации, но не является единственным способом запустить codex exec: тот умеет использовать сохранённый вход.

Как оплачивается OpenAI Codex API?

При входе по API-ключу счёт относится к организации OpenAI Platform. Там проверяют Billing и тариф выбранной модели. Подписка ChatGPT и дополнительные кредиты Codex не пополняют этот баланс. Сначала проверь способ входа командой codex login status.

Как узнать срок доступа по ключу Codex?

Уточни, кто выпустил ключ. У ключа OpenAI дата истечения и ограничения срока проверяются в проекте у владельца или администратора. У ключа стороннего шлюза условия подтверждает его поставщик. Из произвольной строки ключа нельзя узнать дату окончания подписки или остаток средств.

Что делать, если ключ есть, а Codex не работает?

Проверь полный текст ошибки: ключ мог истечь или быть отозван, а организация могла исчерпать баланс или упереться в ограничение запросов. Не отправляй ключ в чат и не покупай новый доступ только по коду 401 или 429. Сначала проверь проект, Billing и права у владельца ключа.

Источники