Гайды

Mistral API: ключ и первый запрос

8 октября 2026 · 10 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 8 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Обычный ключ Mistral API создаётся в консоли Studio: раздел API Keys → Create new key → имя, срок действия и scope соединителей → ключ показывается один раз. По умолчанию аккаунт живёт в Free mode, лимиты применяются, а первый запрос идёт POST-ом на https://api.mistral.ai/v1/chat/completions с заголовком Authorization: Bearer. Ниже — весь путь по шагам, начиная с консоли.

Сразу договоримся о границах. Речь про hosted API Mistral, который обслуживают их серверы. Ключ для Vibe coding и подписка LeChat — отдельные сущности с собственной логикой квот; в этой статье они не разбираются. Запросов к API редакция не выполняла. Ниже приведены инструкция и ожидаемая структура; результаты запуска нужно получить в собственном окружении.

Как создать ключ в Studio

В официальной инструкции Mistral описан путь: откройте Studio, выберите API Keys, нажмите Create new key, задайте Name и Expiration, затем подтвердите создание. Скопируйте секрет сразу: полный ключ показывается только при создании. Документация предлагает хранить его в менеджере паролей или хранилище секретов.

Connector access scope относится к соединителям: Shared connectors only открывает общие соединители Workspace, Private and shared connectors добавляет личные. Выбор сделайте по своей задаче. Обычный API-ключ Studio используется для программных запросов. Справка Mistral отдельно различает такой ключ и ключ плана Vibe Code CLI.

Запишите назначение ключа, рабочее пространство и дату, когда планируете пересмотреть доступ. Значение секрета в такую памятку не вставляйте. Для учебного примера достаточно одной понятной цели: получить текстовый ответ на короткое сообщение. Перед расширением сценария отдельно решите, какие данные вы вправе отправлять.

Подготовка окружения без вывода секрета

В документации Mistral ключ задаётся переменной окружения. Для Bash используется export MISTRAL_API_KEY="your_api_key_here". Подставьте своё секретное значение в окружении запуска программы.

Наш редакционный вариант проверки выводит булев признак наличия переменной. Значение секрета в вывод не попадает. Такой результат подтверждает только наличие строки в окружении процесса; правильность ключа нужно проверять отдельно.

python3 - <<'PY'
import os
key = os.environ.get("MISTRAL_API_KEY")
print("MISTRAL_API_KEY set:", key is not None and len(key) > 0)
PY

Команда печатает подпись переменной и булев признак наличия; значение ключа не выводится. Если ключ попал в переписку, историю терминала или скриншот — его отзывают и выпускают новый: полный ключ показывается при создании.

Вход в консоль и аутентификация запроса — отдельные состояния. В таблице quickstart код 401 связан с неверным или отсутствующим ключом; один код не устанавливает конкретную причину. В справке про rate limits отдельно описан 401 после письма о бюджете Vibe Code CLI: в таком случае или при сомнении в типе ключа предложено обратиться в поддержку с идентификатором организации. Секрет ключа передавать нельзя.

Первый документированный POST

Официальный квикстарт даёт curl-вариант. Форма запроса:

• Метод и адрес: POST https://api.mistral.ai/v1/chat/completions.
• Заголовок авторизации: Authorization: Bearer $MISTRAL_API_KEY.
• Заголовок типа: Content-Type: application/json.
• Тело — JSON с полями model и messages.

В curl-примере документации модель mistral-small-latest, а сообщение — {"role": "user", "content": "Hello, Mistral!"}.

Документация предупреждает: полный ключ показывается один раз. Если он потерян — генерируют новый, старый не восстановить.

Следующий вариант — без установки SDK. Официальный квикстарт требует Python 3.9+ или Node.js 18+ и установку pip install mistralai. Вариант ниже использует стандартную библиотеку Python для сборки HTTP-запроса. Ориентир Python 3.9+ взят из официального quickstart; подключение через urllib — редакционная реализация. Это редакционная реализация, мы её не запускали на живом аккаунте.

# mistral_first_request.py
import json
import os
import urllib.request

api_key = os.environ.get("MISTRAL_API_KEY")
if not api_key:
    raise SystemExit("MISTRAL_API_KEY is not set")

payload = {
    "model": "mistral-small-latest",
    "messages": [{"role": "user", "content": "Hello, Mistral!"}],
}

request = urllib.request.Request(
    "https://api.mistral.ai/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)

with urllib.request.urlopen(request, timeout=None) as response:
    body = json.loads(response.read().decode("utf-8"))

print(body["choices"][0]["message"]["content"])

Что в нём менять под себя: model — на нужную модель из доступных вам, content в messages — на свой вопрос. Скрипт получает ключ из окружения; при отсутствии переменной выполнение останавливается.

Что вернёт API: разбор ожидаемой формы

Успешный ответ — JSON. Документация описывает результат так: успешный ответ подтверждает работу ключа в этой попытке. В квикстарте для SDK сказано, что терминал печатает краткое описание Mistral AI, а если этого не произошло — надо смотреть таблицу ошибок. Для разбора формы ответа ориентируйтесь на структуру, которую документация показывает в Python-примере: в ней есть response.choices[0].message.content. Этот путь — то место, откуда берут текст. Всё остальное в ответе (идентификаторы, служебные поля) — детали, которые стоит посмотреть глазами при первом запуске и не закладывать в логику вслепую.

Рабочий приём для офлайн-разбора: сохранить тело ответа в файл и разобрать его локально. Так видно структуру без повторных вызовов, можно посчитать символы, проверить кодировку и убедиться, что JSON валиден. Повторно разбирать сохранённый JSON можно локально. Это не требует нового обращения к API; новый ответ сервиса при повторном запросе здесь не проверялся.

Отдельно: если вы сохраняете ответ на диск, помните, что в теле может оказаться что угодно из вашего промпта. Файлы с ответами не место хранить рядом с ключами.

Биллинг и ограничения

По текущей справке Mistral Free mode предназначен для оценки и прототипирования; действуют ограничения запросов и токенов. Своё использование и лимиты смотрите на странице Limits. Не переносите лимит другого аккаунта на собственную интеграцию. Письмо о бюджете плана Vibe Code CLI относится к отдельному контуру; при сомнении в типе ключа справка предлагает обратиться в поддержку с идентификатором организации, сохранив секрет при себе.

До первого запроса откройте настройки оплаты и решите, допускаете ли платное потребление. Если условия неясны, остановитесь и уточните их в аккаунте. Учебный текст ниже не измеряет стоимость и не устанавливает бесплатную квоту. Для контроля сохраняйте наблюдаемое использование отдельно от содержания ответа.

Диагностика по фактическому сообщению

Сначала читаем код и текст фактического ответа. В документации приведена таблица ошибок:

• 401 Unauthorized — в quickstart причина связана с неверным или отсутствующим ключом. Для проверки наличия переменной используйте приведённый выше булев тест, который не выводит секрет.
• 402 Payment Required — нет способа оплаты; действие — добавить способ оплаты в Admin Panel › Subscriptions › Billing.
• 429 Too Many Requests — достигнуто ограничение; действие — подождать и повторить с экспоненциальной задержкой.

Важный нюанс про 401: он может прийти не только из-за неверного ключа, но и из-за типа ключа. В справке описан случай, когда ключ создан как plan key в разделе Code › Vibe Code CLI и привязан к бюджету плана: при сомнении в типе ключа обратитесь в поддержку с идентификатором организации. Справка также указывает, что при смене модели лимиты меняются, поэтому «Too Many Requests» после перехода на другую версию — повод посмотреть Limits page для новой модели. Частоту появления каждой ошибки источники не измеряют, и мы не будем: сообщение решает всё.

Промпт для первого сообщения и вариации

Основной сценарий — короткая проверка, что связь установлена. Готовый текст для поля content:

Ты — ассистент для проверки интеграции. Ответь одним абзацем: подтверди, что получил сообщение, и назови три вещи, которые можно делать через Mistral API. Пиши нейтрально, без рекламных оборотов, не длиннее короткого абзаца.

Под свою задачу меняйте [ваша тема], [ваш стиль] и [ваш язык]:

Объясни [ваша тема] на примере из практики. Стиль: [ваш стиль]. Язык: [ваш язык]. Объём — не больше короткого абзаца.

Вариации для самостоятельной проверки:

1. Проверка формата: попросить ответ строго в JSON с двумя полями — так видно, насколько модель держит структуру.
2. Проверка длины: задать ограничение по словам и пересчитать результат вручную.
3. Проверка повтора: отправить один и тот же запрос дважды и сравнить ответы по смыслу и длине.
4. Проверка отказа: задать вопрос вне темы и посмотреть, как модель обозначит границу.

Валидируйте сами. Мы эти прогоны не выполняли; единственное, на что здесь можно опираться без живого аккаунта, — описанная в документации форма запроса и таблица ошибок.

Проверка доступности из России

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

Доступ конкретного аккаунта из России редакция не тестировала. Перед работой проверьте актуальные условия сервиса и сообщение своего интерфейса. Тема доступа к зарубежным AI-сервисам из России разобрана в отдельных материалах блога — Groq в России: доступ, ключ и лимиты и Kimi AI не работает: доступ из России.

Если сервис недоступен, а API нужен, стоит посмотреть локальный запуск моделей — это отдельный сценарий. Материалы о локальных вариантах: Ollama бесплатно: скачать, установить и запустить и LM Studio бесплатно: запуск LLM на своём ПК.

Что показывает топ по запросу «mistral api»

Мы скачали страницы сохранённого топ-10 Яндекса по запросу «mistral api»: текст отдали 10 из 10. Медиана объёма читаемого текста топа — 2151 слово. Метку 2026 года несут 8 из 10 прочитанных страниц.

Состав Яндекса взят из ранее оплаченного кэша, страницы скачаны заново сегодня. Позиции относятся к сохранённому срезу. Датировки страниц характеризуют сохранённый набор источников и не доказывают сегодняшние позиции.

Как сохранить результат для следующей проверки

Заведите локальную папку учебного проекта и сохраните туда файл программы, текст сообщения и обезличенную запись ответа. Отдельно запишите выбранную модель и действие, которое хотите проверить. Ключ храните в предусмотренном для секретов месте; в текстовую памятку его не вставляйте.

Перед изменением запроса сравните текущую версию с исходной. Меняйте одно условие: например, формат ответа или тему сообщения. Сохраните обе инструкции, чтобы потом понять, чем они различались. Результат одной попытки оценивайте по её входным данным. Если модель назвала возможности сервиса, найдите подтверждение в документации: собственное описание модели не заменяет техническую справку.

Для текстовой проверки используйте полный учебный вход: «Сократи объявление: встреча перенесена к северным воротам, время прежнее, инструменты выдаются на месте. Не добавляй дату и имена». Убедитесь, что место изменено, время осталось прежним, инструменты не превратились в покупку. Это редакционная задача; ответ Mistral по ней здесь не получен.

Перед следующей попыткой проверьте, какое поле сообщения вы изменили и какой результат хотите оценить. Если задача — сохранить факты объявления, выпишите их отдельно и сверяйте после ответа. Если задача — получить таблицу, заранее определите столбцы и порядок строк. Успех одной формы не подтверждает работу всех функций API; сохраняйте вывод именно по выбранному учебному сценарию и его входным данным.

Частые вопросы

Где получить ключ Mistral API?
В Studio откройте API Keys и создание ключа. Сохраните секрет при выпуске. Затем подготовьте окружение запуска.

Подойдёт ли ключ Vibe Code CLI?
Справка различает API-автоматизацию и бюджет плана Vibe. Сверьте происхождение своего ключа. При сомнении уточните тип в поддержке, сохранив секрет при себе.

Как проверить переменную без вывода ключа?
Запустите приведённый булев тест в окружении программы. True означает наличие непустой строки. Это ещё не проверка прав доступа.

Как начать с бесплатного режима?
Quickstart описывает Free mode с ограничениями. Актуальные условия проверьте в аккаунте. Объём бесплатного потребления этой статьёй не измерен.

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