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

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/responsesOpenAI Responses
POST/responses/input_tokensПодсчет входных токенов
POST/chat/completionsOpenAI Chat Completions
POST/decisionsOpenAI Decisions
POST/images/generationsСоздание изображений
POST/images/editsРедактирование изображений
POST/embeddingsЭмбеддинги
POST/audio/speechСинтез речи
WebSocket/realtimeГолосовые сессии Realtime

Получите список доступных моделей через GET /models. Совместимость конкретной модели с API методами смотрите в каталоге моделей, цены — на странице «Тарифы».

Ошибки​

Формат и примеры ошибок проверки параметров и потоковых событий SSE приведены в справочнике OpenAI API. Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике API и на странице «Лимиты и ограничения».