Mistral API: как получить ключ и вызвать модели Mistral

Данные на 26.10.2026, 13:00 МСК

Ключ Mistral API создаётся в консоли Mistral Studio, раздел API Keys. Base URL у Mistral https://api.mistral.ai/v1. Через AIShlyuz Mistral Large 4 вызывается тем же ключом sk-ais-, что и остальные модели каталога, по адресу https://aishlyuz.ru/v1.

Если вы искали «Mistral AI» или «мистраль нейросеть» как чат, у Mistral для этого отдельный продукт Vibe, он работает в браузере и в приложении. Ниже только доступ из кода и харнессов. Факты сверены с документацией Mistral на 26.10.2026.

Ключ Mistral API в Studio

По документации Mistral:

1. Войдите в консоль Studio (console.mistral.ai). 2. Откройте API Keys в левом меню и нажмите Create new key. 3. Задайте имя и срок действия ключа. 4. Скопируйте ключ сразу. Полный ключ показывается один раз, потом его не достать, только выпустить новый. 5. Сохраните его в переменную окружения MISTRAL_API_KEY.

Проверка ключа у Mistral:

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral-small-latest", "messages": [{"role": "user", "content": "Привет!"}]}'

У Mistral есть свой Python SDK (pip install mistralai), но API отвечает и на обычные запросы в формате Chat Completions.

Какие модели Mistral есть по API

У Mistral по API много моделей: Mistral Large 4, Mistral Small 4, OCR, модели для распознавания и синтеза речи. Полный список в разделе моделей их документации.

В нашем каталоге из Mistral сейчас одна модель, mistral-large-4. Остальные модели Mistral берите у Mistral напрямую. Весь каталог AIShlyuz на /modeli.

Mistral через OpenAI-совместимый шлюз

Через шлюз меняются три вещи: base URL, ключ и id модели. Код на OpenAI SDK остаётся тем же.

1. Получите ключ sk-ais-… на aishlyuz.ru/register, шаги на странице подключения. 2. Проверьте, какие id доступны вашему ключу:

curl https://aishlyuz.ru/v1/models \
  -H "Authorization: Bearer sk-ais-…"

3. Отправьте запрос:

curl https://aishlyuz.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-ais-…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "messages": [{"role": "user", "content": "Привет! Кто ты?"}]
  }'

То же на Python:

from openai import OpenAI

client = OpenAI(api_key="sk-ais-…", base_url="https://aishlyuz.ru/v1")
resp = client.chat.completions.create(
    model="mistral-large-4",
    messages=[{"role": "user", "content": "Привет! Кто ты?"}],
)
print(resp.choices[0].message.content)

Через наш ключ у Mistral Large 4 работают картинки на входе и инструменты. JSON-режимы (json_object, json_schema) пока работают нестабильно, поэтому в примерах их нет.

В харнессы Mistral Large 4 подключается так же, как любая модель каталога: Claude Code, Codex, OpenCode и Kilo Code. В списке моделей укажите mistral-large-4.

Mistral Large 4 и веса

Mistral Large 4, неофициально «Le Chonk», с 6 октября 2026 года доступна как предварительная версия (public preview). По анонсу Mistral модель принимает изображения, а дообучение ещё идёт, так что ответы до финальной версии могут меняться. Mistral обещает опубликовать веса до конца октября, лицензия станет понятна после выкладки. Подробности и цены у шлюзов на карточке Mistral Large 4.

Ошибки 401, 402 и 404

У Mistral, по документации:

• 401 Unauthorized. Ключ неверный или не задан. Проверьте echo $MISTRAL_API_KEY.
• 402 Payment Required. На аккаунте нет способа оплаты для платного режима.
• 429 Too Many Requests. Упёрлись в лимит запросов, повторите с паузой.

Через шлюз 401 значит неверный ключ sk-ais-, 404 значит id модели не совпал с /v1/models. Частая причина 404 в OpenAI SDK: не задан base_url, и запрос ушёл в OpenAI. Остальное в типичных ошибках подключения.

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