Закончилась квота MiniMax M Plan или Token Plan: как проверить окна и продолжить кодинг

Если coding agent на MiniMax внезапно перестал отвечать, не перебирайте инструменты и ключи наугад. Сначала выясните, что произошло: закончилась квота M Plan, сработал временный rate limit, аккаунт остался на сохранённом Token Plan или в клиенте указан ключ другого типа. От этого зависит правильное действие — ждать сброса, использовать подходящие Credits или перенести только текстовую задачу на отдельный pay-as-you-go API.

Быстрая диагностика

Что происходит	Что проверить	Что делать сначала
В консоли закончился 5-часовой или недельный лимит	Название плана и время окончания обоих окон	Ждать нужного сброса либо проверить, подходит ли Credit pack
Квота ещё есть, но после серии запросов вызовы блокируются	Частоту, параллельные агенты и пиковую динамическую нагрузку	Снизить частоту и concurrency, затем повторить запрос
В аккаунте по-прежнему указан Token Plan	Сохранена ли старая подписка и был ли переход на M Plan	Следовать условиям сохранённого плана, а не переносить на него все правила M Plan
После замены ключа списывается баланс	Используется Subscription Key или обычный API Key	Прекратить смешивать ключи и настроить нужный способ биллинга
Текстовый кодинг нужно продолжить прямо сейчас	Можно ли использовать отдельный ключ и отдельный биллинг	Подключить независимого API-провайдера с его Base URL и Model ID

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

У M Plan два независимых окна: 5 часов и 7 дней

В официальных правилах использования M Plan указаны два автоматических окна сброса:

• текстовые, графические, аудио- и другие невидеомодели требуют остатка и в 5-часовом, и в недельном окне;
• видеомодели зависят только от недельного окна;
• оба окна запускаются с первого использования; после окончания лимит возвращается к полному объёму тарифа, а следующий вызов запускает новое окно;
• окна сбрасываются независимо: обновление 5-часового окна не обнуляет недельное;
• неиспользованный объём не накапливается и не переносится в следующий расчётный период.

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

Все подключённые инструменты расходуют одну квоту

M Plan не выдаёт отдельный запас каждому клиенту. MiniMax Code и поддерживаемые инструменты, подключённые через один Subscription Key, учитываются в общей квоте плана.

Переход из Claude Code в OpenCode, новая сессия или тот же ключ в другом клиенте не создают новый лимит. Откройте страницу usage: там видны план, окна, Credits и история. В MiniMax CLI можно выполнить:

mmx quota

Команда показывает использование M Plan и оставшуюся квоту. Это точнее, чем пытаться определить причину по общему тексту ошибки coding agent.

Rate limit и исчерпанная квота — разные вещи

MiniMax отдельно применяет usage limits и ограничения частоты запросов. Даже при ненулевой квоте вызовы могут временно блокироваться из-за частых запросов, высокой параллельности или динамического ограничения в часы пик.

Сначала уменьшите количество одновременных задач и частоту запросов, затем повторите попытку позже. Не покупайте Credits и не меняйте ключ только из-за кратковременной блокировки. К сценарию «квота закончилась» переходите лишь тогда, когда консоль явно показывает исчерпанное окно.

Проверьте: M Plan или сохранённый Token Plan

После запуска M Plan новые покупки Token Plan прекратились, но существующим подписчикам разрешили сохранить план либо перейти на M Plan. Поэтому название плана в аккаунте важно:

• если в Plan Details указан M Plan, применяйте правила независимых окон, общей квоты и Credits;
• если там всё ещё Token Plan, откройте страницу Existing Token Plan subscribers и проверьте статус сохранённой подписки и автопродления;
• переход необратим: после апгрейда вернуться на Token Plan нельзя, а модели, лимиты, льготы и продление определяет новый уровень M Plan.

Не ориентируйтесь только на старую статью или сохранённую конфигурацию. Сначала посмотрите фактическое название плана в Plan Details.

Что выбрать, когда квота действительно закончилась

Нужны возможности подписки — дождитесь нужного сброса

Если задача зависит от модели или функции, доступной только в M Plan, от MiniMax Code либо от той же цепочки с Subscription Key, ожидание — самый чистый вариант. Уточните, исчерпано 5-часовое окно, недельное или оба, и ориентируйтесь на время окончания в консоли.

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

Есть Credits — сначала проверьте совместимость

Сначала расходуется включённая квота M Plan. После её исчерпания Credits могут покрывать допустимый перерасход, но Credit packs работают только с указанными моделями и возможностями.

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

Нужно продолжить текстовый кодинг сейчас — используйте отдельный API

Для текстовой задачи, которой не нужны эксклюзивные возможности M Plan, можно подключить независимого pay-as-you-go провайдера. У него будут собственный ключ и биллинг. Такая схема не сбрасывает M Plan, не переносит Credits и не передаёт преимущества MiniMax Code.

У MiniMax обычный pay-as-you-go API Key отделён от Subscription Key, и ключи не взаимозаменяемы. Тот же принцип применяйте к стороннему провайдеру: в одной конфигурации используйте только его ключ, Base URL и точный Model ID.

Пример отдельного маршрута: BetterToken в OpenCode

BetterToken здесь — пример независимого API, а не способ «добавить квоту» в M Plan. На 10 октября 2026 года в текущем каталоге BetterToken указан Model ID MiniMax-M3, а в документации OpenCode используется OpenAI-compatible Base URL https://www.bettertoken.ai/v1.

В документации MiniMax сказано, что MiniMax-M3.1-Flash-Preview пока доступна только через M Plan и MiniMax Code. Не переносите этот ID в стороннюю конфигурацию: используйте точное имя из каталога выбранного провайдера.

Настройка без смешения ключей

1. Создайте API Key в своём аккаунте BetterToken. Не используйте MiniMax Subscription Key.
2. В OpenCode выполните /connect, выберите Other, задайте provider id bettertoken и введите ключ BetterToken в запросе учётных данных.
3. Создайте opencode.json в корне проекта или обновите глобальный ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/MiniMax-M3",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax-M3"
        }
      }
    }
  }
}

4. Перезапустите OpenCode, выберите bettertoken/MiniMax-M3 и отправьте короткий вопрос по коду.
5. Обычный ответ подтверждает, что независимый API-маршрут работает. Он не означает, что квота MiniMax восстановилась или была перенесена.

Подробности есть в инструкции BetterToken для OpenCode. Перед сохранением конфигурации сверяйте ID с актуальным каталогом моделей.

Если отдельный маршрут не работает

• Ошибка авторизации: повторите /connect и убедитесь, что ввели ключ BetterToken, а не MiniMax Subscription Key.
• Ошибка endpoint: оставьте Base URL ровно https://www.bettertoken.ai/v1, без /chat/completions.
• Модель не найдена: проверьте регистр и полное имя MiniMax-M3; верхнее поле должно содержать bettertoken/MiniMax-M3.
• Конфигурация не применилась: перезапустите OpenCode и проверьте, не перекрывает ли проектный opencode.json глобальный файл.
• Исходный клиент MiniMax всё ещё не работает: это ожидаемо. Сторонний API не меняет окна, Credits и статус подписки MiniMax.

Пять типичных ошибок

1. Считать временный rate limit исчерпанной квотой. При оставшемся лимите снизьте concurrency и повторите запрос.
2. Ждать только 5-часовой сброс. Для невидеомоделей нужен остаток и в недельном окне.
3. Переносить один Subscription Key между клиентами. Поддерживаемые инструменты делят общую квоту.
4. Смешивать Subscription Key и pay-as-you-go API Key. У них разные права и биллинг.
5. Использовать MiniMax-M3.1-Flash-Preview как универсальный внешний ID. Для стороннего API нужен ID из его текущего каталога.

Рабочий порядок действий

Проверьте план и окна в консоли или командой mmx quota. Если это только rate limit, снизьте частоту и параллельность. Если квота закончилась, ждите сброса для подписочных возможностей, используйте Credits только для поддерживаемой задачи или настройте отдельный pay-as-you-go API для непрерывного текстового кодинга.

Не решайте проблему случайной заменой ключей. Разделяйте M Plan или сохранённый Token Plan, Subscription Key, обычный pay-as-you-go API Key и ключ стороннего провайдера — так вы продолжите работу без ошибочного списания и неверной диагностики.