Содержание
Как получить API ключ MiniMax
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 13 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Как получить API ключ MiniMax: зайдите на platform.minimax.io под своей учётной записью, откройте раздел API Keys и создайте новый секретный ключ. В документации MiniMax указано, что ключ Pay-as-you-go выдаётся через пункт API Keys командой Create new secret key. Этот ключ открывает доступ ко всем модальностям: языку, видео, речи и изображениям.
Собственный срез корпуса: мы скачали подборку результатов веб-поиска по запросу «Как получить API ключ MiniMax»: текст отдали 6 из 10.
Получение ключа и ресурса MiniMax
В разделе подготовки MiniMax путь Pay-as-you-go задан как API Keys → Create new secret key. Этот доступ включает языковые модели, видео, речь и изображения. Subscription Key находится в Billing → M Plan и применяется к ресурсам плана или Credits. Выберите нужный ресурс до сборки клиента. Для Pay-as-you-go документация предлагает пополнить Billing/Balance при необходимости; M Plan использует подписку, Credits или ресурсы команды.
MiniMax рекомендует переменную окружения или .env. OpenAI-совместимый адрес — https://api.minimax.io/v1, Anthropic-совместимый — https://api.minimax.io/anthropic. В сохранённой OpenAI-документации есть установка pip install openai и модель MiniMax-M2.7. Пример с MiniMax-M3.1-Flash-Preview относится к M Plan и MiniMax Code. В учебном файле ниже выбрана M2.7.
Подготовьте отдельную папку упражнения. Запишите тип ресурса и место хранения секрета, исключите .env из git. Перед запуском сверьте выбранные значения с собственным кабинетом. Получение строки ключа и фактическая доступность вызова проверяются отдельно. Редакция запрос к модели не выполняла.
Учебный пример и как проверить себя
Пример ниже — наше учебное упражнение. Цель: убедиться, что ключ жив и что выбранный базовый адрес совпадает с документацией MiniMax.
Шаг первый. Положите ключ в переменную окружения под именем, которое использует ваш клиент. Шаг второй. Установите OpenAI-совместимый клиент командой из документации MiniMax. Шаг третий. Сделайте один короткий запрос к модели и выведите ответ в консоль.
Критерии самостоятельной проверки формулируются так. Запрос вернул осмысленный текст без ошибки авторизации — ключ принят, адрес верный. При ошибке авторизации сначала проверьте, какая переменная передана процессу и совпадает ли она с выбранным типом доступа. Из одного отказа нельзя установить причину. Запрос ушёл, но вернул ошибку модели — проверьте, доступно ли выбранное имя модели вашему типу ключа.
Критерий по объемной модели: MiniMax-M2.7 в документации MiniMax описан с окном 204,800 и скоростью вывода примерно 60 tps. Если ваш запрос падает по длине контекста, сравните фактический размер промпта с этой границей.
Заведите привычку разделять среды: один ключ для локальной отладки, другой для продакшена. Так отзыв одного секрета не остановит рабочий сервис. Инструкция по подключению моделей в редакторе — Как подключить Qwen к VS Code.
Готовый промпт для первого запроса
Задача промпта — проверить ключ и получить рабочий ответ модели с понятной структурой.
Ты — ассистент, отвечающий строго и по делу.
Ответь на запрос: [ваша тема].
Формат ответа: краткий вывод, затем пояснение.
Стиль: [ваш стиль].
Объём: кратко.
Если данных недостаточно, задай уточняющий вопрос.
Под себя меняйте тему, стиль и требуемую детализацию. Вариации той же задачи: объяснить термин простыми словами; составить план действий по теме; переписать текст в другом стиле; сделать краткое резюме длинного текста; предложить проверочные вопросы по теме.
Смежные варианты и что выбирать по задаче
Выбор сводится к трём сценариям. Если вам нужен простой доступ ко всем модальностям и оплата по факту, подходит ключ Pay-as-you-go из раздела API Keys. Если вы уже работаете в рамках M Plan и у вас есть кредиты, используйте Subscription Key из раздела Billing. Если задача связана с MiniMax-M3.1-Flash-Preview, ориентируйтесь на M Plan и MiniMax Code, поскольку документация MiniMax закрепляет эту модель именно за ними.
Отдельно стоит решить вопрос протокола. OpenAI-совместимый адрес пригодится, когда у вас есть готовый код под OpenAI. Anthropic-совместимый адрес выбирают, когда рабочий инструмент уже настроен на этот протокол. Оба адреса приведены в документации MiniMax, и переход между ними не требует нового ключа.
Ниже — сравнение по типовым задачам.
| Задача | Что брать | Почему |
|---|---|---|
| Быстрый тест всех модальностей | Ключ Pay-as-you-go | Покрывает язык, видео, речь, изображения |
| Работа внутри подписки M Plan | Subscription Key | Привязан к месту в плане и кредитам |
| Доступ к MiniMax-M3.1-Flash-Preview | M Plan или MiniMax Code | Модель закреплена за ними в документации |
Если вы пока выбираете инструмент и сравниваете варианты, посмотрите разбор условий бесплатного доступа — Qwen Code бесплатно: что доступно сейчас.
Типичные проблемы и способы диагностики
При ошибке авторизации сохраните сообщение сервера и проверьте сборку клиента. Диагностика простая: проверьте, что в переменной окружения нет пробелов и переводов строки, что вы не обернули значение в кавычки и что клиент читает именно ту переменную, которую вы заполнили.
Вторая проблема — ключ верный, но запрос падает. Здесь стоит разделить два случая. Сохраните код и текст ответа сервера. Сверьте базовый адрес, переданные переменные окружения и доступность выбранной модели для своего типа ресурса с документацией MiniMax. Подписка на чат и API — независимые вещи, и ключ выдаётся платформой разработчиков.
Третья проблема — секрет утёк. Ключ, случайно закоммиченный в репозиторий, нужно немедленно отозвать и выпустить новый в разделе API Keys. Откройте управление ключами в своём аккаунте и выполните доступную процедуру отзыва. Затем обновите секрет у клиентов, которым он был выдан.
Четвёртая проблема — путаница между носителями доступа. При смешении ресурсов проверьте соответствие ключа, модели и доступного плана. Проверьте, какой раздел вы открывали при копировании строки.
Если проблема похожа на сетевую и проявляется в другом инструменте, пригодится разбор Qwen не работает без ВПН: что проверить — логика диагностики переносится на любой API-клиент. Отдельный разбор типовых сбоев — Qwen Code не работает: причины и решения.
Полный файл для первого вызова
Редакционный пример использует форму OpenAI SDK из документации MiniMax и доступную в списке модель MiniMax-M2.7. Запрос не выполнялся. В окружении того же терминала задайте OPENAI_BASE_URL=https://api.minimax.io/v1 и OPENAI_API_KEY своим ключом. Установите пакет командой pip install openai. Для следующего файла ключ и адрес считывает клиент. Перед запуском проверьте Billing и ресурс ключа.
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
model="MiniMax-M2.7",
messages=[{
"role": "user",
"content": "Сократи заметку: книги принимают у северных ворот, срок возвращения в основной зал неизвестен. Сохрани обе части."
}],
)
print(response.choices[0].message.content)
Сохраните его как first_request.py и запустите python first_request.py. Сверьте текст с учебным входом: место приёма книг должно сохраниться, срок должен остаться неизвестным. Сохраните фактическое сообщение сервера при отказе. Из текста исключения сначала установите этап сбоя; случайная замена ключа, адреса и модели одновременно затруднит проверку.
Карточка отдельного клиентского окружения
Подготовьте для учебного файла отдельный терминал. Запишите, откуда запускаете программу и каким интерпретатором. Проверьте наличие нужных переменных в процессе, выводя только булев признак заполнения. Полное значение ключа в консоль и скриншот не отправляйте. Если в другом терминале пример работает иначе, сначала сравните эти записи: одинаковый файл может получить разные параметры окружения.
Сохраните учебную заметку до запуска. После ответа выделите фразы о месте приёма книг и сроке возвращения в зал. Сравните их с исходником буквально. Модель могла сократить текст и одновременно убрать неизвестность срока; это расхождение с заданием, даже если ответ звучит естественно. Уточняйте конкретную фразу и повторно проверяйте весь текст. Перед отправкой реальным посетителям прочитайте результат сами.
Если программа не дала ответа, опишите этап: чтение окружения, создание клиента, отправка запроса, получение тела или выбор текста. В обезличенной записи оставьте названия полей и сообщение исключения. После исправления меняйте только одно условие и подпишите его. Смена типа ключа одновременно с моделью и клиентом усложнит сравнение. Для следующего опыта сохраните рабочий файл отдельно от изменённого. По завершении учебной работы проверьте, где остались ответы и кому они доступны.
Частые вопросы
Что такое minimax api key и где его взять?
Для Pay-as-you-go откройте API Keys и Create new secret key. Для упражнения сохраните секрет в окружении.
Можно ли получить minimax api key free?
Сначала проверьте ресурсы и условия аккаунта в Billing. Одна выданная строка не устанавливает наличие бесплатного расхода.
Чем ключ Pay-as-you-go отличается от Subscription Key?
Проверьте ресурс: первый относится к Pay-as-you-go, второй — к M Plan и Credits. Используйте модель своего ресурса.
Почему ключ не работает при первом запросе?
Сохраните сообщение сервера и последовательно проверьте окружение, адрес и модель. Одновременно менять все значения неудобно для диагностики.
Как подключить ключ к OpenAI-совместимому клиенту?
Подготовьте окружение и запустите полный Python-файл из раздела выше. Сохраните ответ и сверяйте его с заданной заметкой.