# OpenAI Responses по подписке ChatGPT

Вызовы Responses по подписке, переключение на баланс хаба и ограничения WebSocket.

`POST /openai/subscription/api/v1/responses` вызывает модель подписки ChatGPT либо доступную модель другого провайдера со списанием с баланса хаба. Тот же путь принимает WebSocket Upgrade для моделей подписки.

Минимальный пример ниже использует модель хаба и расходует баланс, а не подписку:

```bash
curl https://hub.coreinfra.ai/openai/subscription/api/v1/responses \
  -H "X-CoreInfra-API-Key: $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"deepseek-flash","input":"2 + 2"}'
```

Ожидаемый текст ответа — `4`. Фрагмент ответа:

```json
{"output":[{"type":"message","content":[{"type":"output_text","text":"4"}]}]}
```

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

Для запроса по подписке нужны два заголовка: `X-CoreInfra-API-Key` с ключом хаба и `Authorization: Bearer …` с токеном подписки. При переключении на модель, оплачиваемую с баланса, Bearer-токен подписки не используется и не требуется.

### Подписка и баланс

Модели OpenAI обслуживаются по подписке. Если выбрана доступная модель другого провайдера с генеративным протоколом, отличным от OpenAI Responses, хаб выполняет конвертацию и оплачивает запрос с баланса. Неизвестный идентификатор или модель, у которой есть только OpenAI Responses, остаются на подписке: их доступность проверяет сервис подписки.

Работа модели подписки не создает резерв и не списывает баланс хаба; недельный лимит расходов и разрешенные модели для нее не проверяются. Если в хабе отдельно включена проверка конфиденциальных данных с помощью модели, она оплачивается отдельно с баланса хаба и может вернуть отказ по балансу или лимиту расходов.

Использование подписки учитывается отдельно от списаний с баланса. Если принятый запрос не вернул пригодный `usage`, в аналитике используется оценка.

Для модели, оплачиваемой с баланса, действуют обычные правила [расчета стоимости генеративных моделей](https://coreinfra.ru/docs/billing/text.md), [резервирования](https://coreinfra.ru/docs/models.md#reserve) и [ограничений](https://coreinfra.ru/docs/limits.md). Смена провайдера модели посередине сессии не поддерживается.

### Изменяемые поля и ограничения

Поле `inference_geo` игнорируется.

Проверка входных изображений и файлов сохраняется: используйте данные в кодировке base64. Ссылки на внешние ресурсы и `file_id` отклоняются со статус-кодом `400`. Ограничения конвертации для запросов с баланса описаны на странице [«OpenAI-совместимый API»](https://coreinfra.ru/docs/use/openai.md#conversion).

### WebSocket

Адрес соединения — `wss://hub.coreinfra.ai/openai/subscription/api/v1/responses`. Для открытия соединения нужен `x-codex-routing-hint` со значением вида `model=<идентификатор модели>`. Отсутствие подсказки или выбор модели хаба, требующей конвертации, возвращает статус-код `426`: такой запрос нужно отправлять по HTTP. Если переключиться на эту модель уже после открытия WebSocket, хаб закроет соединение.

Передавайте события `response.create` и `response.interrupt` как JSON-объекты в текстовых сообщениях; бинарные сообщения отклоняются. В `response.create` поле `stream`, если задано, должно быть равно `true` и удаляется перед отправкой; любое присутствие `background`, включая `false` и `null`, запрещено. Поле `generate` принимает boolean или `null`.

Если передан `stream_id`, это непустая строка длиной до 256 символов из латинских букв, цифр, `_`, `-` и `.`. Общие ограничения соединения приведены в [разделе о WebSocket](https://coreinfra.ru/docs/limits.md#websocket).

## Ошибки

Для HTTP-запроса по подписке отсутствие или неверный формат ее Bearer-заголовка возвращает статус-код `401`. Некорректное JSON-тело или запрещенное входное вложение возвращает статус-код `400` (формат ошибок приведен в [разделе OpenAI API](https://coreinfra.ru/docs/reference/openai.md#errors)).

До WebSocket Upgrade статус-код `426` означает отсутствие подсказки модели, необходимость HTTP или отказ в установлении соединения. После Upgrade нарушения формата приходят событием `error`; для неподдерживаемого клиентского события используется `invalid_event_type`, для неверных `stream`, `background`, `generate` или бинарного сообщения — `invalid_request_error`, для неверного `stream_id` — `invalid_stream_id`.

Ошибки ключа хаба, баланса и остальные общие отказы описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors).
