Перейти к содержанию

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

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

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

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. Фрагмент ответа:

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

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

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

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

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

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

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

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

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

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

Проверка входных изображений и файлов сохраняется: используйте данные в кодировке base64. Ссылки на внешние ресурсы и file_id отклоняются со статус-кодом 400. Ограничения конвертации для запросов с баланса описаны на странице «OpenAI-совместимый API».

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.

Ошибки​

Для HTTP-запроса по подписке отсутствие или неверный формат ее Bearer-заголовка возвращает статус-код 401. Некорректное JSON-тело или запрещенное входное вложение возвращает статус-код 400 (формат ошибок приведен в разделе OpenAI API).

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

Ошибки ключа хаба, баланса и остальные общие отказы описаны в общем справочнике.