У API Key MiniMax два частых источника: открытая платформа MiniMax и совместимые входы вроде ZSQH AI Gateway. Оба позволяют вызывать модели, но регистрация, область действия ключа и счета разделены. Ниже по порядку реальных действий разобраны регистрация, создание, хранение, изоляция прав, ротация и разбор 401, а в конце — рекомендации по выбору между официальным и шлюзовым ключом.

Командам, подключающимся впервые, стоит запомнить одну мысль: ключ не должен быть «универсальным» — его делят по средам, людям и назначению, чтобы его можно было отключить, отследить и заменить. Тогда проблема с одним ключом не затронет весь бизнес.

Примечание: MiniMax — товарный знак своего правообладателя; статья носит технический характер. Входы платформы, управление ключами и лимиты определяются официальной документацией и консолью MiniMax; модели и тарификация — страницей цены на модели.

1. Сначала разделите три типа ключей

Сейчас у MiniMax обычно есть два типа официальных ключей: ключ интерфейса с оплатой по факту и ключ подписки M Plan. Первый создаётся на странице «Ключи интерфейса» в аккаунте и поддерживает языковые, видео-, речевые, графические и другие модели; второй отображается на странице подписки и биллинга и используется для M Plan и купленных Credits. Третий тип — ключ ZSQH AI Gateway: он действует только внутри шлюза и служит единым доступом к нескольким подключённым моделям.

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

Тип ключа Где создать или посмотреть Область действия Для какого сценария
Официальный ключ по факту «Ключи интерфейса» открытой платформы Подключённые модели и интерфейсы официального аккаунта Только MiniMax, прямые расчёты с вендором
Официальный ключ подписки M Plan Страница подписки и биллинга Подписка M Plan и купленные Credits Есть подписка, работа по тарифу
Ключ шлюза Консоль ZSQH Модели, подключённые в шлюзе Единый вход и счёт для нескольких моделей

2. Регистрация: сначала определите, китайский или международный сайт

У MiniMax два входа: platform.minimax.cn и platform.minimax.io. У них разные консоли и Base URL, поэтому до регистрации определите, к какому сайту есть доступ у команды и какой способ расчётов подходит. Не регистрируйтесь на китайском сайте, а затем не настраивайте ключ на адрес международного.

Командам рекомендуется схема «главный аккаунт + субаккаунты». Документация китайского сайта указывает, что главный аккаунт может создавать субаккаунты; субаккаунты наследуют права, лимиты, расход API и счета главного, но не могут просматривать и управлять платежами. Так у каждого сотрудника есть свой вход, а при увольнении достаточно отключить субаккаунт, не передавая пароль главного.

Если консоль требует дополнить корпоративные данные или способ проверки, выполните шаги по подсказкам страницы; ориентируйтесь на процесс, который видите при регистрации.

3. Шаги создания ключа

  1. Войдите на открытую платформу MiniMax и откройте «Ключи интерфейса» в пользовательском центре. Путь китайского сайта: platform.minimax.cn/user-center/basic-information/interface-key.
  2. Нажмите создание ключа и укажите понятное назначение, например prod-customer-service или test-zhang.
  3. Выберите или подтвердите область действия по подсказкам страницы. Если выбора прав на уровне модели нет, значит действуют права аккаунта.
  4. Сразу скопируйте ключ и сохраните в менеджере паролей или сервисе управления секретами. Не отправляйте скриншоты в чаты и не пишите ключ в комментарии кода.
  5. Если используется M Plan, ключ подписки находится не на странице ключей интерфейса, а на странице подписки и биллинга.
  6. Проверьте ключ минимальным запросом, убедитесь, что регион, Base URL и имя модели совпадают.
  7. Внесите в реестр команды ответственного, назначение, дату создания и условия отключения ключа.

По третьему шагу отдельное пояснение: судя по публичной документации, универсального описания «прав ключа на уровне отдельных моделей» нет, действует то, что показывает консоль. Если нужно разделить направления бизнеса, используйте субаккаунты или отдельные ключи для разных сред, а не один ключ на всё.

4. Изоляция прав: одна среда — один ключ

Как минимум разделите три среды: разработка, предпроизводство и production. Production-ключ хранится только в серверных переменных окружения или сервисе секретов и не передаётся в браузер, мобильное приложение и десктопный клиент. Тестовому ключу можно задать меньший лимит, чтобы его было легко отключить.

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

Цель изоляции — не бюрократия, а ограничение зоны сбоя. Один ключ на весь бизнес удобен на коротком отрезке, но усложняет разбор в долгую.

5. Хранение ключа в переменных окружения

Не вписывайте ключ в код. Ниже минимальный пример: .env используется только локально, в production применяйте управление секретами платформы или секреты контейнера.

# .env (не коммитить в Git)
MINIMAX_API_KEY=ваш-ключ
# пример для официального китайского сайта; для шлюза замените адрес и имя модели
MINIMAX_BASE_URL=https://api.minimax.cn/v1
MINIMAX_MODEL=MiniMax-M3.1-Flash

# .gitignore
.env
.env.*

В Python читайте через os.environ["MINIMAX_API_KEY"] и не задавайте ключ значением по умолчанию в параметрах функции. Обратите внимание на три вещи: .env должен быть в .gitignore; в контейнерах и CI ключ не должен попадать в слой образа; при логировании заголовков сначала обезличивайте, чтобы Authorization не оказался в логах.

При использовании сервиса управления секретами выдайте приложению права только на чтение и фиксируйте каждое чтение. Не копируйте ключ в чаты и текст документов.

6. Ротация и обработка утечки

Официальная документация не задаёт фиксированный период ротации; задайте его по риску: основной production-ключ меняйте раз в 90 дней, а при смене персонала, потере устройства или подозрении на утечку — немедленно.

Ротация идёт по порядку «создать новый — переключить — отключить старый»:

  • Создайте новый ключ с датой в имени, например prod-2026-10.
  • Запишите новый ключ в хранилище секретов и проверьте на предпроизводстве.
  • Постепенно переведите production-трафик, наблюдая за ошибками и расходом.
  • После стабилизации отключите старый ключ и сохраните запись об операции.
  • Проверьте, не было ли у старого ключа подозрительных вызовов до отключения.

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

7. Разбор 401: сначала адрес, затем ключ

401 означает сбой аутентификации и не равен нехватке баланса или лимиту. Проверяйте по порядку:

  • Заголовок должен быть Authorization: Bearer <Key>, между Bearer и ключом один пробел.
  • Ключ скопирован полностью, без пробелов, переносов строк и кавычек по краям.
  • Ключ китайского сайта настроен на китайский адрес, международного — на международный.
  • Официальный ключ не попал на адрес шлюза, а ключ шлюза — на официальный адрес.
  • Ключ не удалён, не отключён и не относится к истёкшей подписке.
  • Переменная окружения действительно загружена. В контейнере печатайте имя переменной, а не значение.

Если возвращается 403, обычно это права или квота; 429 — лимит скорости; на баланс указывает сообщение вроде insufficient balance. Обрабатывайте 401 отдельно от этих ошибок.

8. Как выбрать официальный ключ или ключ шлюза

Если используется только MiniMax, есть возможность напрямую пройти официальную регистрацию и расчёты, а команда способна отдельно управлять ключами каждого вендора, прямой вариант проще. Если одновременно нужны MiniMax, Claude, GPT, DeepSeek и другие модели либо один ключ, единый счёт и единое представление расхода, шлюз удобнее.

Цена шлюза — дополнительный слой зависимости, поэтому подтвердите три вещи: какие модели MiniMax поддерживаются, понятна ли тарификация, куда обращаться при сбоях. Сначала небольшой тест, затем production-трафик. Модели и тарификацию можно сверить на странице цены на модели, тестовый ключ создать на странице регистрации.

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

Где создать MiniMax API Key?

Официальный ключ по факту создаётся в пользовательском центре открытой платформы на странице «Ключи интерфейса»; ключ подписки M Plan отображается на странице подписки и биллинга. Точный путь зависит от сайта, на котором вы зарегистрированы.

Один ключ может вызывать текст, речь и видео?

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

Можно ли хранить ключ во фронтенде или мини-программе?

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

Нужен ли простой при ротации ключа?

Нет. Сначала создайте новый ключ, проверьте на предпроизводстве, затем постепенно переведите production и отключите старый. Главное — период сосуществования старых и новых ключей, чтобы в момент переключения не отказали все вызовы.

Можно ли смешивать официальный ключ и ключ шлюза?

Нет. Ключи действуют только на своей платформе и своём адресе. При смешивании обычно возникают 401 или 404; сначала проверьте, что Base URL и ключ относятся к одной платформе.

10. Дальше

Сначала определите, нужен ли только MiniMax или единый вход для нескольких моделей. Для одной модели достаточно создать ключ по официальной документации; для единого входа можно зарегистрироваться в ZSQH AI Gateway, создать тестовый ключ и сверить модели и тарификацию на странице цены на модели. В любом случае храните ключ в переменных окружения и разделяйте тестовую и производственную среды.

Полезное чтение: