Mistral Medium 3 API — выпуск 2505, база знаний и токены

Контекст: 131 072токенов
Результат: Текстформат ответа
Вход / выход: 80 ₽ / 370 ₽за 1 млн токенов

ПОДКЛЮЧЕНИЕ

От модели к первому запросу

Используйте идентификатор модели в совместимом API-клиенте. Полные параметры, ключи и ответы с ошибками описаны в документации.

const response = await client.chat.completions.create({
  model: "mistralai/mistral-medium-3",
  messages: [{ role: "user", content: "Ваш запрос" }],
});

Открыть инструкцию по подключению →

ПОДРОБНЫЙ ОБЗОР

Возможности модели

В официальной карточке выпуск называется mistral-medium-2505 и имеет контекст 128k. Дата выхода — 7 мая 2025 года, дата deprecation — 22 мая 2026 года. Возможности корпоративного размещения и настройки из исторического анонса не являются свойствами любого API-подключения.

Ответы по внутреннему справочнику: сначала найдите основание

Представьте помощника, который объясняет сотруднику порядок согласования командировки. До составления ответа приложению нужно найти действующую процедуру для нужного подразделения. В запрос модели передаются подходящие выдержки и сведения об их редакции. Попросите отделять изложенное в документе правило от предположения. Если размер компенсации в найденном материале отсутствует, ответ должен сообщать об этом, а не подставлять привычное значение. Такой сценарий позволяет проверить пользу модели на конкретной работе, не принимая общую убедительность текста за правильность.

Сохраните название документа и дату его редакции.
Проверьте, относится ли правило к подразделению сотрудника.
Отдельно отметьте вопросы, для которых источник не найден.

API модели не заменяет поиск и права доступа

Индекс документов, выбор подходящих фрагментов и проверка прав сотрудника относятся к приложению. Не передавайте закрытую инструкцию пользователю через модель только потому, что её удалось найти в общей базе. Ограничение доступа нужно применять до формирования запроса. При проверке помощника используйте две учётные роли с разными разрешениями и убедитесь, что набор доступных источников действительно различается. Сам ответ может выглядеть корректно, даже когда приложение ошибочно включило в контекст чужой документ. Это ошибка всей системы, которую нельзя обнаружить оценкой стиля текста.

База знаний и адаптация модели решают разные задачи

Поиск по базе знаний подставляет актуальные сведения в конкретный запрос. Изменение поведения модели через обучение — отдельная работа со своими данными и проверками. В анонсе Medium 3 разработчик описывал корпоративную настройку через решения Mistral; это не означает, что API-ключ автоматически предоставляет обучение или локальное размещение. Для обновляемого справочника сначала проверьте качество поиска и полноту переданных выдержек. Если нужная инструкция вообще не попала в запрос, изменение тона ответа эту проблему не исправит.

Как подключать именно Medium 3, а не соседнюю версию

Для записи каталога используется mistralai/mistral-medium-3; историческое имя выпуска у разработчика — mistral-medium-2505. Medium 3.1 соответствует другой редакции, 2508. Перед использованием старого примера проверьте доступность выбранной модели и назначение имени у вашего подключения. Ключ API сохраните в серверных настройках интеграции. Доступ к внутренним документам должен определяться правами пользователя приложения, а не наличием у него общего ключа модели. Сначала выполните короткий запрос без закрытых материалов и проверьте формат ответа и обработку ошибки.

Подключение клиента к API

Токены и стоимость поиска по документам

Входной расход растёт вместе с объёмом переданных выдержек и истории диалога. Для оценки покупки токенов возьмите несколько реальных вопросов и сохраните, сколько материала потребовалось для правильного ответа. Слишком широкая подборка добавляет стоимость и затрудняет проверку основания; слишком короткая может потерять исключение из правила. Учитывайте также повторные обращения после уточнений. Сравнивайте розничные ставки в карточках выбранных моделей: цена из анонса 2025 года не подтверждает нынешний тариф. Критерий полезности — ответ с проверяемым основанием и приемлемым полным расходом, а не минимальное число токенов любой ценой.

Расчёт входных и выходных токенов

Вопросы и ответы

Какая версия скрывается за Medium 3 в этой карточке?

Карточка посвящена исходному выпуску 2505. Не следует переносить на него характеристики Medium 3.1 или Medium 3.5.

Можно ли скачать Medium 3 для своего сервера?

Исторический анонс описывает корпоративное размещение по отдельному обращению к Mistral. Он не подтверждает свободную загрузку весов или предоставление такого размещения Токенмостом.

Нужно ли обучать модель на каждом новом документе?

Для поиска по обновляемым инструкциям приложение может передавать найденные фрагменты непосредственно в запрос. Необходимость обучения оценивается отдельно после проверки качества поиска и ответов.

Кто проверяет права на документы базы знаний?

Ваше приложение до отправки материалов модели. Инструкция в тексте запроса не заменяет ограничение доступа к источникам.

Почему для нового проекта предлагается Medium 3.5?

Это рекомендованная замена в документации Mistral для устаревшего выпуска 2505. Перед переходом всё равно требуется проверка на ваших запросах и данных.

Сравните с другими моделями

Mistral: Mistral Medium 3.1 — следующий исторический выпуск 2508 и проверка переноса инструкций
Mistral: Mistral Medium 3.5 — актуальная рекомендованная замена в документации разработчика