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.
Ошибки ключа хаба, баланса и остальные общие отказы описаны в общем справочнике.
