Документация Rivya AI
Страницы API моделей

Интеграция Gemini 2.5 Pro API

Используйте Gemini 2.5 Pro через Rivya Public API v1: model id gemini-2-5-pro-chat, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIГотово для текстового вводаЧат
API model id

gemini-2-5-pro-chat

Входные данные

text, file

Files API

Не требуется для минимального запроса

Базовые кредиты

2

Возможность

Чат

Готовность

Chat API: обычный режим + SSE streaming

Биллинг

TOKEN_BASED

Лимит промпта

20000 символов

Контракт запроса

Chat-запросы отправляют по одному сообщению за раз. История сессии хранится в Rivya; не отправляйте сырой массив messages.

КлючТипОбязательноПо умолчаниюОписание
modelstringДаgemini-2-5-pro-chatИспользуйте gemini-2-5-pro-chat как API model id.
session_idstringНет-Необязательный id чат-сессии, созданной через API. Не указывайте его, чтобы начать новую сессию.
messagestringДа-Следующее сообщение пользователя. История Chat API берется из серверной сессии, а не из сырого массива messages.
attachmentsarrayНет-Необязательные значения file_id для изображений, возвращенные Files API. Внешние URL вложений не принимаются.
enable_web_searchbooleanНетfalseПрименяется только если выбранная чат-модель поддерживает веб-поиск.
reasoning_effortstringНетdefaultНеобязательная глубина рассуждения: default, minimal, low, medium, high или xhigh, если модель это поддерживает.
client_request_idstringНет-Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Эта чат-модель использует общие поля Chat API выше. Поддержка веб-поиска, вложений с файлами изображений, мыслей и reasoning отражена в данных readiness.

Минимальный запрос

{
  "model": "gemini-2-5-pro-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Запрос с reference-файлом

{
  "model": "gemini-2-5-pro-chat",
  "message": "Write a concise launch plan for a new product image campaign",
  "attachments": [
    {
      "file_id": "file_uploaded_image_id"
    }
  ]
}

Ответ создания

Эндпоинт Chat возвращает готовое сообщение assistant, использование токенов и финальное списание кредитов за этот ход.

{
  "id": "chatcmpl_msg_gemini_2_5_pro_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gemini_2_5_pro_chat",
  "model": "gemini-2-5-pro-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "A concise launch plan with clear next steps."
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 2,
    "final": 2
  }
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

Chat API в Public API v1 поддерживает обычные и SSE streaming ходы. Вложения изображений должны использовать значения file_id из Files API.