# Бэкенд для Codex

Адрес API /codex/api/v1 для агента Codex, расширения VS Code и приложения ChatGPT Work.

Адрес API `codex` предназначен для агента [Codex](https://coreinfra.ru/docs/codex.md), расширения Codex для VS Code и настольного приложения [ChatGPT Work](https://coreinfra.ru/docs/chatgpt-work.md) для работы с моделями через хаб без VPN. Он отличается от [`openai`](https://coreinfra.ru/docs/use/openai.md) тем, что отдает каталог моделей в формате `codex`.

## 1. Настройте адрес и ключ

Укажите базовый адрес `https://hub.coreinfra.ai/codex/api/v1` и подставьте ключ хаба `sk-ci2-...` в заголовок `Authorization: Bearer`. Готовые файлы конфигурации приведены в инструкциях для [Codex](https://coreinfra.ru/docs/codex.md) и [ChatGPT Work](https://coreinfra.ru/docs/chatgpt-work.md).

Проверьте минимальный вызов через cURL:

```bash
export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/codex/api/v1/responses \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-6-luna","input":"2 + 2"}'
```

Ожидаемый текст ответа — `4`. При пустом балансе вы получите предложение пополнить его.

## Отличия от API OpenAI

Запросы к моделям обрабатываются так же, как на [OpenAI-совместимом API](https://coreinfra.ru/docs/use/openai.md#limits) (включая [правила конвертации](https://coreinfra.ru/docs/use/openai.md#conversion) и [документацию OpenAI Responses](https://platform.openai.com/docs/api-reference/responses/create)). Дополнительные API методы `openai` — Images, Embeddings, Speech, Realtime, Decisions и подсчет входных токенов — на адресе `codex` не поддерживаются.

## Что доступно

Доступны API методы `POST /responses`, WebSocket на `/responses`, `POST /chat/completions` и `GET /models` относительно `https://hub.coreinfra.ai/codex/api/v1`. Описание форматов запросов приведено в [справочнике OpenAI API](https://coreinfra.ru/docs/reference/openai.md).

В отличие от `/openai/api/v1/models`, список `GET /codex/api/v1/models` возвращает объект с массивом `models`, где для каждой модели указаны `slug`, отображаемое имя с префиксом `[CoreInfra]`, поддерживаемые уровни рассуждений и шаблоны инструкций для меню Codex и ChatGPT Work. Полный перечень моделей приведен в [каталоге моделей](https://coreinfra.ru/docs/catalog.md).

![Модели из каталога хаба с префиксом \[CoreInfra\] в меню выбора модели Codex](https://coreinfra.ru/assets/images/any-model-any-agent-codex-10a68a19c42bee4025aec3c73d00bad4.jpg)

Модели разных провайдеров с префиксом `[CoreInfra]` в меню выбора модели Codex.

## Ошибки

Формат и примеры ошибок проверки параметров приведены в [справочнике OpenAI API](https://coreinfra.ru/docs/reference/openai.md#errors). Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
