OpenAI-совместимый API
OpenAI-совместимый API хаба позволяет вызывать модели OpenAI и других провайдеров через хаб без VPN из стандартного SDK OpenAI или любого совместимого HTTP-клиента по ключу хаба.
1. Настройте адрес и ключ
Укажите в клиенте базовый адрес https://hub.coreinfra.ai/openai/api/v1 и подставьте ключ хаба sk-ci2-... в заголовок Authorization: Bearer.
Минимальный запрос OpenAI Responses через cURL:
export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/openai/api/v1/responses \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-6-luna","input":"2 + 2"}'
Ожидаемый текст ответа — 4. Тот же базовый адрес используется для OpenAI Chat Completions и остальных API методов ниже.
Отличия от API OpenAI
Полное описание параметров приведено в документации OpenAI. При работе через хаб действуют следующие отличия:
- Доступны только API методы из таблицы ниже. Files, Batches, Fine-tuning, Assistants и управление сохраненными Responses через этот адрес API не предоставляются.
- В OpenAI Responses не поддерживаются
background: true, сохраненныеpromptиconversation, MCP-инструменты сtunnel_id, а также встроенные инструментыcode_interpreter,file_search,image_generation,x_search,code_execution,collections_search,attachment_searchи контейнерныйshell(возвращается ошибка со статус-кодом400). - В OpenAI Chat Completions не поддерживаются
deferred: trueи встроенные инструменты провайдера (code_interpreter,code_execution,file_search,collections_search,x_search,web_search,retrieval,builtin_function). Для вызова инструментов на стороне клиента используйте функции (type: "function"). - Заголовки
OpenAI-Organization,OpenAI-Projectи полеinference_geoигнорируются. Для текстовых моделей OpenAI отключено сохранение на стороне провайдера (store: false), игнорируетсяsafety_identifier, а из значенийservice_tierподдерживаютсяauto,default,priorityиfast(в Responses такжеultrafast;flexигнорируется). Правила игнорируемых полей для моделей других провайдеров приведены в справочниках Chat Completions и Responses. - В Images параметр
output_format: "svg"отклоняется со статус-кодом400. Для моделиglm-imageподдерживается только генерация одного изображения (n: 1) без редактирования и потокового режима (stream: true), а параметрыbackgroundиoutput_formatигнорируются. - Входные изображения и файлы передавайте в кодировке base64 (
data:image/...;base64,...илиfile_data). Ссылки на внешние ресурсы иfile_idотклоняются со статус-кодом400. В Images также поддерживается загрузка файлов черезmultipart/form-data.
Конвертация
Когда выбранная генеративная модель не поддерживает вызванный протокол напрямую (например, при вызове моделей Anthropic, Google или Z.ai через OpenAI Responses или Chat Completions), хаб конвертирует запрос и ответ на своей стороне:
- В Responses при конвертации не поддерживаются
previous_response_id,conversationиitem_reference(возвращается ошибка со статус-кодом400— передавайте историю сообщений вinput). Не конвертируютсяmax_tool_calls,top_logprobs,truncation,text.verbosityи встроенные инструменты провайдера. - В Chat Completions при конвертации формируется один вариант ответа (
n: 1) и не конвертируютсяlogprobs,top_logprobs,logit_bias,audio,modalities,predictionиweb_search_options. - Подробности по каждому API методу приведены в справочнике OpenAI API.
Что доступно
Доступны следующие API методы относительно базового адреса https://hub.coreinfra.ai/openai/api/v1 (для WebSocket — wss://hub.coreinfra.ai/openai/api/v1):
| Метод или транспорт | Путь | Назначение и справочник |
|---|---|---|
GET | /models | Каталог моделей API |
POST, WebSocket | /responses | OpenAI Responses |
POST | /responses/input_tokens | Подсчет входных токенов |
POST | /chat/completions | OpenAI Chat Completions |
POST | /decisions | OpenAI Decisions |
POST | /images/generations | Создание изображений |
POST | /images/edits | Редактирование изображений |
POST | /embeddings | Эмбеддинги |
POST | /audio/speech | Синтез речи |
| WebSocket | /realtime | Голосовые сессии Realtime |
Получите список доступных моделей через GET /models. Совместимость конкретной модели с API методами смотрите в каталоге моделей, цены — на странице «Тарифы».
Ошибки
Формат и примеры ошибок проверки параметров и потоковых событий SSE приведены в справочнике OpenAI API. Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике API и на странице «Лимиты и ограничения».
