ИнференсСправочник

Chat Completions

Основной метод API Yenisei, который возвращает ответ модели на разговор и принимает те же параметры, что и API OpenAI.

POSThttps://api.yenisei.ru/v1/chat/completions

Метод Chat Completions — главный в API Yenisei: вы передаёте модели сообщения разговора, а она возвращает ответ. Через этот же метод работают потоковая передача, вызов инструментов, ответ в формате JSON и рассуждения. Формат запроса и ответа совпадает с API OpenAI, поэтому подойдёт любой его SDK.

Параметры

  • modelstringобязательный

    Имя модели из каталога, например yenisei-100.

  • messagesarrayобязательный

    Сообщения разговора. У каждого сообщения есть роль role и содержимое content.

  • streamboolean

    Если передать true, ответ приходит по частям в виде событий SSE. Подробнее на странице Потоковая передача.

  • temperaturenumber

    Разнообразие ответа. По умолчанию значение равно 1.

  • top_pnumber

    Отбор вероятных токенов. По умолчанию значение равно 1.

  • max_tokensinteger

    Предел длины ответа в токенах. Значение больше того, что умеет выдать модель, обрезается до её предела.

  • stopstring | array

    Строка или список строк, на которых модель прекращает ответ.

  • seedinteger

    Число, которое помогает получать повторяемые ответы.

  • response_formatobject

    Формат ответа. Значение {"type": "json_object"} включает ответ в формате JSON. Подробнее на странице Ответ в формате JSON.

  • toolsarray

    Описания функций, которые модель может попросить вызвать. Подробнее на странице Вызов инструментов.

  • reasoning_effortstring

    Глубина рассуждений для моделей, которые умеют рассуждать: none, low, medium или high. Подробнее на странице Рассуждения.

curl https://api.yenisei.ru/v1/chat/completions \
  -H "Authorization: Bearer $YENISEI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "yenisei-100",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Ответ

JSON
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "yenisei-100",
  "choices": [{
    "index": 0,
    "finish_reason": "stop",
    "message": { "role": "assistant", "content": "Здравствуйте!" }
  }],
  "usage": { "prompt_tokens": 9, "completion_tokens": 4, "total_tokens": 13 }
}

Ошибки

  • 401
    Ключ API не передан или неверный.
  • 403
    Модель недоступна на вашем тарифе.
  • 404
    Такой модели нет в каталоге.
  • 429
    Исчерпан лимит кредитов в окне сессии, недели или месяца. Когда лимит обновится, указано в заголовке Retry-After.
  • 502
    Модель не ответила. Повторите запрос.

Остаток кредитов в окне сессии приходит в заголовке X-RateLimit-Remaining-Session, а момент обновления лимита — в заголовке X-RateLimit-Reset. Все коды и заголовки описаны на страницах Коды ошибок и Лимиты и расход.