MiniMax M Plan／Token Planの上限到達時に、ウィンドウを確認してコーディングを続ける方法

MiniMaxを使うコーディングツールが突然止まっても、ツールやキーを手当たり次第に切り替えないでください。最初に、M Planの使用量ウィンドウを使い切ったのか、一時的なrate limitなのか、継続中のToken Planなのか、別種類のキーを設定しているのかを判定します。原因が分かれば、リセットを待つ、対象のCreditsを使う、残りのテキストコーディングだけを別のpay-as-you-go APIへ移す、という選択ができます。

まずはこの表で原因を切り分ける

表示されている状態	最初に確認すること	優先する対応
コンソールで5時間または週間ウィンドウの残量がない	プラン名と各ウィンドウの終了時刻	対応するリセットを待つか、Creditsが対象機能に使えるか確認する
残量はあるが、短時間に連続実行すると呼び出しが止まる	リクエスト頻度、同時実行数、ピーク時の動的制限	頻度または同時実行数を下げ、時間を置いて再試行する
アカウントにToken Planと表示される	旧プランを継続中か、M Planへ移行済みか	継続プランの告知に従い、M Planの全ルールをそのまま当てはめない
キーを変えた後にアカウント残高が減る	Subscription Keyかpay-as-you-go API keyか	キーの混在をやめ、意図した課金経路で設定し直す
今すぐテキストコーディングを続けたい	別課金を許容でき、M Plan限定機能が不要か	独立プロバイダーを専用キー、endpoint、Model IDで設定する

クライアント上では似たエラーに見えても、原因ごとに対処は異なります。安全な順序は、プランとウィンドウ、次にキーの種類、最後にプロバイダー切り替えです。

M Planの5時間ウィンドウと週間ウィンドウは独立している

MiniMaxのM Plan usage rulesでは、使用量が2つのウィンドウで自動リセットされると説明されています。

• テキスト、画像、音声などの非動画モデルは、5時間ウィンドウと7日間の週間ウィンドウの両方に残量が必要です。
• 動画モデルは週間ウィンドウだけが対象で、5時間ウィンドウの対象ではありません。
• どちらも最初の使用で開始します。終了すると現在のティアの上限まで戻り、次回使用時に新しいウィンドウが始まります。
• 2つのウィンドウは別々にリセットされます。5時間分が戻っても週間使用量は戻りません。
• 未使用分は次のウィンドウや次の請求期間へ繰り越されません。

そのため、5時間待っても復旧しない場合があります。週間ウィンドウがまだ上限のままかもしれません。逆に、残量があっても一時的なrate limitで呼び出しが止まることがあります。

対応ツールは同じM Plan使用量を共有する

M Planはクライアントごとに別の枠を配りません。MiniMax Codeでの使用と、同じSubscription Keyで接続した対応ツールでの使用は、同じM Plan上限に計上されます。

Claude CodeからOpenCodeへ移る、新しいセッションを開く、同じSubscription Keyを別のツールへ入れる、といった操作では新しい枠は生まれません。MiniMax usage pageで、プラン、ウィンドウ、Credits、使用履歴を確認してください。MiniMax CLIでは次のコマンドも使えます。

mmx quota

このコマンドはM Planの使用量と残り枠を表示します。クライアントの一般的なエラー文から推測するより、確実な診断になります。

rate limitと使用量上限は別の制限

MiniMaxはusage limitとrequest rate limitを別の制御として扱います。短時間に多くのリクエストを送る、同時実行数が多い、ピーク時間帯の動的制限に触れる、といった場合は、使用量が残っていても一時的にブロックされます。

リクエスト頻度と同時実行数を下げ、時間を置いて再試行してください。短時間の制限だけを理由にCreditsを購入したり、アップグレードしたり、キーを交換したりしないでください。コンソールで5時間または週間ウィンドウが実際に上限へ達している場合だけ、使用量切れの対応へ進みます。

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の実際の名前と状態を確認します。

本当に上限なら、必要な機能で次の行動を選ぶ

1. サブスクリプション限定機能が必要なら、正しいリセットを待つ

M Plan限定モデル、MiniMax Codeの会員機能、同じSubscription Key経路が必要な作業では、待機が最も明確です。5時間、週間、または両方のどれが上限かを確認し、コンソールに表示される終了時刻に合わせます。

待機中に、不要なファイルをコンテキストから外し、目的を絞った新しいセッションを用意し、大きな作業を小さな確認単位へ分割できます。リセット時刻は早まりませんが、次のウィンドウでの消費を抑えられます。

2. Creditsがあるなら、対象モデルと機能を確認する

まずM Planの付属使用量が消費されます。上限到達後は、対象となる追加使用にCreditsを使えますが、Credit packsは対応するモデルと機能にしか適用されません。

Usage pageで、Credits残高、有効期限、対象機能を確認してください。Creditsが表示されているだけで、すべての処理を継続できるとは限りません。

3. 今すぐテキストコーディングを続けるなら、別の従量課金経路を使う

M Plan限定の特典を必要としないテキスト作業なら、独立したAPIプロバイダーへ切り替えられます。キーと課金は別になります。この経路はM Planのウィンドウをリセットせず、CreditsやMiniMax Codeの特典も移しません。

MiniMaxでも標準pay-as-you-go API keyとSubscription Keyは分離され、相互利用できません。外部プロバイダーでも同じ境界を守り、設定にはそのプロバイダー自身のキー、Base URL、正確なModel IDだけを使います。

例：BetterTokenでOpenCodeに独立経路を作る

BetterTokenは独立APIの一例であり、M Planの追加枠ではありません。2026年10月10日時点で、BetterTokenの現行モデルカタログにある正確なIDはMiniMax-M3、OpenCodeガイドのOpenAI-compatible Base URLはhttps://www.bettertoken.ai/v1です。

MiniMaxのモデル文書では、MiniMax-M3.1-Flash-Previewは現在M PlanとMiniMax Codeでのみ利用可能とされています。このpreview IDを外部プロバイダーへそのまま設定せず、外部側の現行カタログにあるIDを使ってください。

キーを混在させない設定手順

1. BetterTokenアカウントでBetterToken API keyを作成します。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をやり直し、MiniMax Subscription KeyではなくBetterTokenのキーを入力したか確認します。
• endpointエラー：Base URLはhttps://www.bettertoken.ai/v1だけにし、/chat/completionsを追加しません。
• モデルが見つからない：大文字小文字と完全なIDを確認します。該当欄ではMiniMax-M3とbettertoken/MiniMax-M3を使います。
• 設定が反映されない：OpenCodeを再起動し、プロジェクト側のopencode.jsonがグローバル設定を上書きしていないか確認します。
• 元のMiniMaxツールはまだ使えない：想定どおりの境界です。外部APIはMiniMaxのウィンドウ、Credits、契約状態を変更しません。

時間を無駄にしやすい5つの誤り

1. 一時的なrate limitを使用量切れと判断する。 残量があるなら同時実行数を下げて再試行します。
2. 5時間リセットだけを待つ。 非動画モデルは週間ウィンドウにも残量が必要です。
3. 同じSubscription Keyを別ツールへ移す。 対応ツールは同じM Plan使用量を共有します。
4. Subscription Keyとpay-as-you-go API keyを混在させる。 特典と課金経路が異なります。
5. MiniMax-M3.1-Flash-Previewを外部共通IDと考える。 外部ツールでは各プロバイダーの現行カタログにある正確なIDが必要です。

実際の対応順序

コンソールまたはmmx quotaでプランと残りウィンドウを確認します。rate limitだけなら頻度と同時実行数を下げます。使用量が本当に尽きているなら、サブスクリプション限定機能が必要な場合はリセットを待ち、対象作業にはCreditsを使い、テキスト作業を止められない場合は独立したpay-as-you-goプロバイダーを設定します。

キーを試行錯誤で入れ替えて解決しようとしないでください。M Planまたは継続中のToken Plan、Subscription Key、標準pay-as-you-go key、外部プロバイダーのキーを明確に分けることで、原因の誤認と意図しない課金を防げます。