Создание ответа модели (chat completion)

Метод

POST https://api.f5ai.ru/v2/chat/completions

Заголовки

X-Auth-Token: YOUR_API_KEY
Content-Type: application/json

Метод Chat Completion позволяет получить ответ от модели выбранного вендора (например, OpenAI, DeepSeek, Yandex, GigaChat) на основе предоставленных сообщений и опциональных параметров: инструкций, температуры, инструментов и др.

Поддерживает вызов инструментов (function calling), системные подсказки, задание температуры генерации и контроль над количеством токенов.

Тело запроса (JSON)

model

string

Да

Код модели, например: "gpt-4.1-mini"
Список вендоров моделей

messages

array

Да

Массив сообщений с ролями user, assistant, system

tools

array

Нет

Инструменты, которые может вызвать модель

instructions

string

Нет

Системные инструкции (аналог system role)

max_tokens

integer

Нет

Максимальное количество токенов в ответе

temperature

float

Нет

Температура генерации (по умолчанию 1.0, диапазон 0.0 – 2.0)

Пример запроса

{
  "model": "gpt-4.1-mini",
  "messages": [
    { "role": "user", "content": "Какое время в Москве?" }
  ],
  "tools": [],
  "instructions": "Ты очень полезный ассистент!",
  "max_tokens": 1000,
  "temperature": 0.6
}

Ответ

{
  "created": 1750756702,
  "model": "gpt-4.1-mini",
  "message": {
    "role": "assistant",
    "content": "Сейчас я не могу получить текущее время, но могу подсказать, как это сделать."
  },
  "tools_calls": [],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 66,
    "total_tokens": 98
  },
  "finish_reason": "COMPLETE"
}

Поля в ответе

created

int

UNIX-время генерации

model

string

Модель, которая использовалась

message

object

Ответ модели

tools_calls

array

Вызовы инструментов, если есть

usage

object

Информация об использовании токенов

finish_reason

string

Причина завершения генерации (COMPLETE, TOOL_CALL и т.д.)

Поддержка инструментов (function calling)

Если указать в tools описание функции, модель может вызвать её при необходимости.

Пример инструмента:

{
  "type": "function",
  "name": "get_current_weather",
  "description": "Get current weather in a location",
  "parameters": {
    "type": "object",
    "properties": {
      "location": {
        "type": "string",
        "description": "City and country"
      },
      "unit": {
        "type": "string",
        "enum": ["celsius", "fahrenheit"]
      }
    },
    "required": ["location", "unit"]
  }
}

Использование

Можно применять для создания ассистентов, для поиска, FAQ, поддержки клиентов.

Поддерживает многопоточность, вызов API-инструментов и построение ассистентов.

Подходит для построения чат-ботов с контекстом.