# GPT-6 Sol — /chat/completions

GPT-6 Sol (OpenAI) — API для чата с моделью семейства GPT-6 для сложного программирования и агентных сценариев. Контекстное окно на 1 050 000 токенов, до 128 000 выходных токенов за запрос, шесть уровней размышлений от none до max, ввод изображений, вызов инструментов и вывод в формате JSON.

**Эндпоинт:** `POST https://kovapi.com/v1/chat/completions`

## Быстрый старт

Два шага: отправить запрос, а затем получить ответ в потоковом режиме. Замените YOUR_API_KEY своим ключом, и команды ниже заработают как есть. Эндпоинт совместим с OpenAI Chat Completions, поэтому в готовом коде для OpenAI достаточно поменять `base_url` и `model`.

**Шаг 1 · Отправка запроса**

```
curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'
```

Ответ (HTTP 200)

```
{
  "id": "chatcmpl-7f3c9a1e2b4d6f8a",
  "object": "chat.completion",
  "created": 1791281400,
  "model": "gpt-6-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Фотосинтез — это процесс, в котором растения с помощью солнечного света превращают углекислый газ и воду в сахар и выделяют кислород.",
        "reasoning_content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 186,
    "total_tokens": 204,
    "prompt_tokens_details": {"cached_tokens": 0},
    "completion_tokens_details": {"reasoning_tokens": 144}
  }
}
```

`message.content` — это ответ, `message.reasoning_content` — размышления. В `usage` — токены, по которым оплачивается этот запрос: токены размышлений входят в `completion_tokens` и оплачиваются по цене выхода.

**Шаг 2 · Потоковый вывод (рекомендуется)**

```
curl -N https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "stream": true, "messages": [{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}]}'
```

Поток — это стандартный SSE: каждый фрагмент несёт текст в `choices[0].delta.content`, последний фрагмент содержит `usage`, а завершается поток строкой `data: [DONE]`. Для длинных ответов и моделей с размышлениями используйте потоковый вывод: непотоковый запрос обрывается примерно через 10 минут.

**Python (OpenAI SDK)**

```
from openai import OpenAI

client = OpenAI(base_url="https://kovapi.com/v1", api_key="YOUR_API_KEY")

# 1. Один запрос — один ответ
resp = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
)
print(resp.choices[0].message.content)

# 2. Потоковый вывод
stream = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое фотосинтез"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
```

## Аутентификация
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Основные характеристики

| Контекстное окно | 1 050 000 токенов |
| --- | --- |
| Максимум выходных токенов за запрос | 128 000 токенов |
| Входные данные | Текст, изображения |
| Размышления | По значению `reasoning_effort` (если не задан — medium); сводка размышлений возвращается в `reasoning_content` |
| Вызов инструментов | Поддерживается (формат OpenAI `tools`) |
| Вывод в формате JSON | Поддерживается (`response_format`) |
| Веб-поиск | Поддерживается (`web_search: true`; сам поиск бесплатный) |
| Эндпоинты | /v1/chat/completions · /v1/responses |
| Потоковый вывод | Поддерживается (`stream: true`, SSE) |
| Оплата | За токены: у входа, выхода (включая размышления) и попаданий в кэш — свои цены; неудачные запросы бесплатны |

## Параметры запроса

JSON-тело запроса `POST /v1/chat/completions` — такое же, как в OpenAI Chat Completions. Основные параметры и то, как каждый из них работает у этой модели:

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| model | string | Да | ID модели: `gpt-6-sol`. |
| messages | array | Да | Диалог: у каждого сообщения есть `role` (`system`, `user`, `assistant` или `tool`) и `content`. `content` — строка или массив частей `text` и `image_url` (ввод изображений, см. ниже). Чтобы продолжить диалог, передавайте всю историю сообщений по порядку. |
| stream | boolean | Нет | `true` — ответ приходит потоком SSE, а `usage` — в последнем фрагменте. По умолчанию `false`. |
| max_tokens | integer | Нет | Эта модель не принимает ограничение вывода: `max_tokens` / `max_completion_tokens` игнорируются (без ошибки). Если нужен короткий ответ, попросите об этом в промпте. |
| temperature / top_p | number | Нет | Эта модель не принимает параметры сэмплирования: они игнорируются (без ошибки). |
| reasoning_effort | string | Нет | Глубина размышлений: none / low / medium / high / xhigh / max; по умолчанию medium. Чем выше уровень, тем дольше и тщательнее модель размышляет — и тем медленнее ответ и больше выходных токенов. Уровень можно указать и в ID модели, например `gpt-6-sol-high`. |
| tools / tool_choice | array / string | Нет | Вызов функций в стандартном формате OpenAI. Когда модель вызывает функцию, она возвращает `finish_reason: "tool_calls"` и `tool_calls`; подробнее — ниже. |
| response_format | object | Нет | `{"type": "json_object"}` заставляет модель возвращать только валидный JSON; в промпте тоже напишите, что нужен JSON и с какими полями. |
| web_search | boolean | Нет | `true` — сначала выполняется веб-поиск, и его результаты передаются модели как справочные материалы; подробнее — ниже. |

`frequency_penalty` и `presence_penalty` тоже игнорируются. Остальные параметры OpenAI передаются модели без изменений.

## Цена

Оплата за токены по актуальным ценам ниже (за миллион токенов). Оплачиваются только успешные запросы и только по фактическому расходу: неудачные, прерванные по таймауту и отклонённые запросы бесплатны. 1 кредит = $0.005.

| Тип | USD за 1 млн токенов | Кредитов за 1 млн токенов |
| --- | --- | --- |
| Вход | $0.60 | 120 |
| Выход (включая размышления) | $3.00 | 600 |
| Попадание в кэш | $0.06 | 12 |

Например, запрос с 2000 входных токенов и 1000 выходных (включая размышления) стоит около $0.0042.

## Размышления

`reasoning_effort` принимает значения none / low / medium / high / xhigh / max; если параметр не задан, шлюз запрашивает medium. Чем выше уровень, тем дольше модель размышляет и тем надёжнее отвечает, но и тем медленнее ответ и больше выходных токенов; для простых вопросов достаточно low.

Сводка размышлений возвращается в `message.reasoning_content` (при потоковом выводе — в `delta.reasoning_content`). Уровень можно указать и в ID модели — `gpt-6-sol-low`, `gpt-6-sol-high` или `gpt-6-sol-xhigh`: результат тот же, оплата — как за `gpt-6-sol`.

В /v1/responses глубина размышлений задаётся в `reasoning.effort`, а сводка возвращается, только если вы сами передадите `reasoning.summary` (шлюз его не добавляет).

Токены размышлений входят в `usage.completion_tokens` и оплачиваются по цене выхода (некоторые модели ещё и указывают их отдельно в `completion_tokens_details.reasoning_tokens`).

## Кэширование промптов

Параметры не нужны: повторяющийся длинный префикс (тот же системный промпт, предыдущие ходы диалога) поставщик модели может закэшировать автоматически, и закэшированная часть оплачивается по более низкой цене кэша. Кэшировать ли и сколько, решает поставщик; чтобы чаще попадать в кэш, ставьте неизменные части в самое начало сообщений.

Число токенов из кэша возвращается в `usage.prompt_tokens_details.cached_tokens`; эта часть оплачивается по цене попадания в кэш, а остальной вход — по цене входа.

## Ввод изображений

Добавьте в массив `content` часть `image_url`. Рекомендуемый вариант — data URI в base64 (`data:image/png;base64,...`): его всегда удаётся прочитать. Изображение по публичной ссылке сначала нужно скачать, и иногда это не удаётся или не укладывается в таймаут. Изображения пересчитываются во входные токены по правилам разработчика модели.

```
curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "messages": [{"role": "user", "content": [{"type": "text", "text": "Что изображено на этой картинке"}, {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBORw0KGgo..."}}]}]}'
```

## Вызов инструментов (function calling)

Опишите свои функции в `tools` с помощью JSON Schema. Когда модель решит вызвать функцию, она вернёт `finish_reason: "tool_calls"`, а в `message.tool_calls` — имя функции и аргументы (строкой JSON).

```
curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "messages": [{"role": "user", "content": "Какая сейчас погода в Шанхае"}], "tools": [{"type": "function", "function": {"name": "get_weather", "description": "Current weather of a city", "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]}}}]}'
```

Выполните функцию, добавьте результат в диалог сообщением с `role: "tool"` и соответствующим `tool_call_id` и отправьте диалог повторно — модель даст итоговый ответ. `tool_choice` принимает `auto`, `none`, `required` или конкретную функцию.

## Responses API (/v1/responses)

Эта модель доступна и через OpenAI Responses API — его используют Codex и похожие инструменты. Запросы и ответы идут в формате OpenAI Responses: входные данные передаются в `input`, а глубина размышлений — в `reasoning.effort`.

```
curl https://kovapi.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "input": "Объясни одним предложением, что такое фотосинтез", "reasoning": {"effort": "medium", "summary": "auto"}}'
```

Этот эндпоинт не подставляет уровень размышлений по умолчанию и сам не возвращает сводку; если она нужна, передайте `"summary": "auto"`, как в примере выше. Оплата такая же, как на эндпоинте чата; веб-поиск доступен только на /v1/chat/completions.

## Веб-поиск

Добавьте в запрос `"web_search": true` (или элемент `{"type": "web_search"}` в `tools`): шлюз сначала ищет в интернете в реальном времени по содержанию диалога, передаёт модели до 5 результатов со ссылками как справочные материалы, а модель отвечает и указывает источники. Сам поиск бесплатный; справочный текст оплачивается как входные токены.

```
curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "web_search": true, "messages": [{"role": "user", "content": "Какие главные технологические новости сегодня"}]}'
```

## Надёжность и автоматические повторы

- Если запрос завершился ошибкой, не уложился в таймаут или упёрся в предел нагрузки, шлюз ещё до начала ответа автоматически повторяет его: повторять запрос самому не нужно, и дважды ничего не спишется.

- Начав передачу, поток больше не повторяется автоматически: если он оборвётся на середине, оплачивается то, что успело сгенерироваться до обрыва (см. [Оплата и возвраты](https://docs.kovapi.com/ru/guide/billing)).

- Если модель загружена до предела, шлюз возвращает 429 с `Retry-After`: подождите указанное число секунд и повторите. Неудачные запросы не оплачиваются. Статус каждой модели — на [странице статуса](https://kovapi.com/ru/status).

## Ошибки и возвраты

Ошибки возвращаются объектом `error` (`message`, `type`, `code`, `param`); ориентируйтесь на HTTP-статус и `code`, а не на текст `message`. Неудачные запросы не оплачиваются; полный список — в разделе [Коды ошибок](https://docs.kovapi.com/ru/guide/errors).

| HTTP | code | Причина | Что делать |
| --- | --- | --- | --- |
| 400 | invalid_messages / invalid_role / invalid_max_tokens | В запросе к чату поле `messages` отсутствует, пустое или имеет неверный формат, у `role` недопустимое значение либо `max_tokens` — не положительное целое число. Поле указано в `param`. | Исправьте поле, указанное в `param`. |
| 400 | model_not_found | ID модели написан с ошибкой, `model` не передан или модель нельзя использовать на этом эндпоинте (например, чат-модель на эндпоинте изображений). | Берите ID модели из `GET /v1/models` или из [справочника API](https://docs.kovapi.com/ru/api). |
| 400 | max_tokens_too_small | Модель с размышлениями потратила весь `max_tokens` на размышления и не написала ответ (непотоковый чат). | Увеличьте `max_tokens` и повторите. |
| 4xx | invalid_request | Поставщик модели отклонил запрос (например, из-за слишком длинного контекста или неподдерживаемого параметра); статус и `message` передаются в том виде, в каком их прислал поставщик, а в `code` — его значение. | Измените запрос согласно `message`. |
| 401 | invalid_api_key | Ключ не существует, удалён или отключён, либо отключён аккаунт. | Проверьте ключ на странице API Keys в консоли. |
| 402 | insufficient_quota | Баланса не хватает, чтобы зарезервировать стоимость этого запроса. Шлюз сначала резервирует максимально возможную стоимость запроса, поэтому ошибка может возникнуть и при всплеске одновременных вызовов. | Если был всплеск запросов, подождите несколько секунд и повторите; в остальных случаях пополните баланс. |
| 403 | permission_denied | Модели нет в списке разрешённых моделей ключа. | Используйте модель из списка разрешённых или измените список в консоли. |
| 429 | rate_limit_exceeded | Превышен лимит запросов в минуту, заданный для этого ключа (считается за последние 60 секунд). Заголовка `Retry-After` нет. | Подождите несколько секунд и повторите или увеличьте лимит ключа в консоли. |
| 429 | rate_limit_exceeded | Модель загружена до предела, и запрос не был отправлен. Бывает только на эндпоинтах чата: задачи изображений и видео не отклоняются, а встают в очередь. OpenAI-совместимые эндпоинты добавляют `Retry-After`. | Подождите столько секунд, сколько указано в `Retry-After`, и повторите. |
| 502 | upstream_timeout | Поставщик не уложился в таймаут, в том числе слишком долго не отправлял первый токен. | Повторите; для длинных ответов используйте `stream: true`. |
| 502 | upstream_unavailable | Поставщик дал сбой или временно недоступен. | Повторите чуть позже. |
| 502 | upstream_busy | Поставщик модели ограничивает частоту запросов. Его 429 никогда не передаётся вам как 429 — вместо этого вы получаете этот 502. | Повторите чуть позже. |
| 502 | empty_completion | Поставщик модели вернул пустой ответ. Это не оценка вашего контента. | Повторите. |
| 503 | model_maintenance | Модель на обслуживании и не принимает запросы; пока идёт обслуживание, другая модель вместо неё не ответит. | Повторите, когда обслуживание закончится; ход работ — на [странице статуса](https://kovapi.com/ru/status). |

Если поток дал сбой уже после начала передачи, код статуса не меняется: ошибка приходит строкой данных с `error`, или поток просто заканчивается (без `data: [DONE]`). Считайте такой поток оборванным.