Chat API

Основной REST-эндпоинт для генерации текста.

Endpoint

POSThttps://chat.jarv.tech/api/v1/chat

Заголовок api-key. Эндпоинт — тонкий прокси к модели: tools и параметры передаются напрямую, серверного агент-цикла нет.

json(6 строк)

…

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

Параметр	Тип	Обяз.	По умолч.	Описание
`prompt`	string	да	—	Текущее сообщение пользователя.
`model`	string	да	—	ID модели, например `google/gemini-2.5-flash`.
`system_prompt`	string	—	—	Системная инструкция.
`messages`	array	—	—	История диалога: объекты `{role, content}`.
`file_urls`	string[]	—	—	URL изображений/файлов (картинки определяются по расширению).
`response_format_json`	boolean	—	false	Включить JSON-режим ответа.
`project_id`	string	—	—	UUID базы знаний для RAG (см. раздел «RAG»).
`knowledge_base_id`	string	—	—	Альтернатива project_id.
`tools`	array	—	—	Описания функций (формат OpenAI).
`tool_choice`	string \| object	—	—	`auto`, `none`, `required` или конкретная функция.
`temperature`	float	—	0.7	Креативность, 0.0–2.0.
`max_tokens`	int	—	—	Лимит токенов ответа (> 0).

Поле user_id принимается для совместимости со старыми клиентами, но игнорируется — владелец запроса определяется по ключу.

Формат ответа

Ответ

json(27 строк)

…

has_reasoning и response.reasoning заполняются для reasoning-моделей. Блок cost — справочная стоимость в рублях (фактическое списание — в токенах с кошелька команды).

Формат сообщений

Передавайте историю в messages, а новое сообщение — в prompt. Роли: user, assistant, system.

json(9 строк)

…

Tools (Function Calling)

Описания функций в формате OpenAI передаются в tools и проксируются модели как есть. Вызовы функций вернутся в ответе — выполняйте их на своей стороне.

json(19 строк)

…