# OpenAI-совместимый API

Настройка клиента или SDK OpenAI для работы через CoreInfra AI Hub, поддерживаемые операции и особенности конвертации.

OpenAI-совместимый API хаба позволяет вызывать модели OpenAI и других провайдеров через хаб без VPN из стандартного SDK OpenAI или любого совместимого HTTP-клиента по ключу хаба.

## 1. Настройте адрес и ключ

Укажите в клиенте базовый адрес `https://hub.coreinfra.ai/openai/api/v1` и подставьте ключ хаба `sk-ci2-...` в заголовок `Authorization: Bearer`.

Минимальный запрос OpenAI Responses через cURL:

```bash
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](https://platform.openai.com/docs/api-reference). При работе через хаб действуют следующие отличия:

* Доступны только 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](https://coreinfra.ru/docs/reference/openai/chat-completions.md#differences) и [Responses](https://coreinfra.ru/docs/reference/openai/responses.md#differences).
* В 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](https://coreinfra.ru/docs/reference/openai.md).

## Что доступно

Доступны следующие API методы относительно базового адреса `https://hub.coreinfra.ai/openai/api/v1` (для WebSocket — `wss://hub.coreinfra.ai/openai/api/v1`):

| Метод или транспорт | Путь                      | Назначение и справочник                                                                         |
| ------------------- | ------------------------- | ----------------------------------------------------------------------------------------------- |
| `GET`               | `/models`                 | [Каталог моделей API](https://coreinfra.ru/docs/reference/openai/models.md)                     |
| `POST`, WebSocket   | `/responses`              | [OpenAI Responses](https://coreinfra.ru/docs/reference/openai/responses.md)                     |
| `POST`              | `/responses/input_tokens` | [Подсчет входных токенов](https://coreinfra.ru/docs/reference/openai/responses-input_tokens.md) |
| `POST`              | `/chat/completions`       | [OpenAI Chat Completions](https://coreinfra.ru/docs/reference/openai/chat-completions.md)       |
| `POST`              | `/decisions`              | [OpenAI Decisions](https://coreinfra.ru/docs/reference/openai/decisions.md)                     |
| `POST`              | `/images/generations`     | [Создание изображений](https://coreinfra.ru/docs/reference/openai/images-generations.md)        |
| `POST`              | `/images/edits`           | [Редактирование изображений](https://coreinfra.ru/docs/reference/openai/images-edits.md)        |
| `POST`              | `/embeddings`             | [Эмбеддинги](https://coreinfra.ru/docs/reference/openai/embeddings.md)                          |
| `POST`              | `/audio/speech`           | [Синтез речи](https://coreinfra.ru/docs/reference/openai/audio-speech.md)                       |
| WebSocket           | `/realtime`               | [Голосовые сессии Realtime](https://coreinfra.ru/docs/reference/openai/realtime.md)             |

Получите список доступных моделей через `GET /models`. Совместимость конкретной модели с API методами смотрите в [каталоге моделей](https://coreinfra.ru/docs/catalog.md), цены — на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

Формат и примеры ошибок проверки параметров и потоковых событий SSE приведены в [справочнике OpenAI API](https://coreinfra.ru/docs/reference/openai.md#errors). Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
