Cota esgotada no MiniMax M Plan ou Token Plan: confira as janelas e continue programando

Quando uma ferramenta de programação ligada ao MiniMax para de responder, não comece a alternar clientes e chaves ao acaso. Primeiro descubra se uma janela do M Plan acabou, houve um rate limit temporário, a conta ainda usa um Token Plan mantido ou a ferramenta recebeu o tipo errado de chave. Só então escolha entre esperar o reset, usar Credits compatíveis ou mover apenas o trabalho de texto para uma API pay-as-you-go independente.

Comece por esta tabela de decisão

O que você vê	O que conferir	Primeira ação
O console mostra a janela de 5 horas ou a semanal sem saldo	Nome do plano e horário final de cada janela	Aguarde o reset correspondente ou verifique se os Credits cobrem a capacidade
Ainda há cota, mas as chamadas param depois de muitas solicitações	Frequência, concorrência e limitação dinâmica em horários de pico	Reduza frequência ou concorrência e tente novamente depois
A conta ainda mostra Token Plan	Se é uma assinatura mantida e se houve upgrade	Siga o aviso do plano mantido, sem presumir que todas as regras do M Plan valem
O saldo começa a ser descontado após trocar a chave	Se a ferramenta usa Subscription Key ou API key pay-as-you-go	Pare de misturar chaves e configure o caminho de cobrança desejado
Você precisa continuar a programação de texto imediatamente	Se aceita cobrança separada e não depende de benefício exclusivo do M Plan	Configure um provedor independente com chave, endpoint e Model ID próprios

Os sintomas podem parecer iguais dentro do cliente, mas as causas são diferentes. A ordem segura é: plano e janelas primeiro, tipo de chave depois e troca de provedor por último.

O M Plan usa janelas independentes de 5 horas e 7 dias

As regras de uso do M Plan descrevem duas janelas com reset automático:

• Modelos de texto, imagem, áudio e outros modelos que não são de vídeo precisam de saldo na janela de 5 horas e na janela semanal de 7 dias.
• Modelos de vídeo dependem apenas da janela semanal.
• As duas janelas começam no primeiro uso. Quando uma termina, o limite completo do nível volta, e o uso seguinte inicia uma nova janela.
• Os resets são independentes. O reset de 5 horas não restaura o uso semanal.
• A cota não utilizada não acumula na janela seguinte nem passa para o próximo ciclo de cobrança.

Por isso, esperar cinco horas pode não resolver: a janela semanal ainda pode estar esgotada. Também pode ocorrer o contrário — ainda existe cota, mas um rate limit temporário bloqueia as chamadas.

Todas as ferramentas compatíveis compartilham o mesmo uso

O M Plan não concede uma cota separada para cada cliente. O uso no MiniMax Code e em ferramentas compatíveis ligadas pela mesma Subscription Key conta nos mesmos limites do plano.

Trocar de Claude Code para OpenCode, abrir outra sessão ou colocar a mesma Subscription Key em outra ferramenta não cria cota nova. Consulte a página de uso do MiniMax para ver plano, janelas, Credits e histórico. No MiniMax CLI, também é possível executar:

mmx quota

Esse comando mostra o uso do M Plan e a cota restante. É uma verificação mais confiável do que tentar interpretar uma mensagem genérica do cliente.

Rate limit não é a mesma coisa que cota esgotada

O MiniMax trata limites de uso e limites de frequência como controles separados. Muitas solicitações em pouco tempo, concorrência alta ou controles dinâmicos em horários de pico podem bloquear chamadas temporariamente mesmo quando ainda existe cota.

Reduza a frequência e a concorrência e tente novamente depois. Não compre Credits, não faça upgrade nem troque chaves apenas por uma limitação breve. Siga o caminho de “cota esgotada” somente quando o console indicar que a janela de 5 horas ou a semanal realmente chegou ao limite.

Confirme se a conta usa M Plan ou um Token Plan mantido

Depois do lançamento do M Plan, o Token Plan deixou de ser oferecido para novas compras, mas assinantes existentes puderam manter o plano ou fazer upgrade. Por isso, o nome exibido na conta importa:

• Se Plan Details mostra M Plan, use as regras de janelas independentes, consumo compartilhado e Credits.
• Se ainda mostra Token Plan, leia Existing Token Plan subscribers e confira o estado da assinatura mantida e da renovação automática.
• O upgrade é definitivo: o aviso oficial informa que não é possível voltar ao Token Plan, e o novo nível do M Plan passa a definir modelos, limites, benefícios e renovação.

Não deduza as regras atuais a partir de uma postagem antiga ou de uma configuração salva. Confira primeiro o nome e o estado reais em Plan Details.

Se a cota realmente acabou, escolha conforme a dependência

1. Você precisa de recursos exclusivos da assinatura: aguarde o reset correto

Esperar é a opção mais limpa quando a tarefa depende de um modelo exclusivo do M Plan, de benefícios do MiniMax Code ou do mesmo fluxo com Subscription Key. Veja se terminou a janela de 5 horas, a semanal ou ambas e use o horário final mostrado no console.

Enquanto isso, retire arquivos irrelevantes do contexto, abra uma sessão mais focada e divida uma tarefa grande em etapas verificáveis. Isso não antecipa o reset, mas pode reduzir o consumo na próxima janela.

2. A conta tem Credits: confirme a elegibilidade

A cota incluída no M Plan é consumida primeiro. Depois do limite, Credits disponíveis podem cobrir uso adicional elegível, mas os pacotes só se aplicam aos modelos e recursos que suportam.

Na página de uso, verifique saldo, validade e compatibilidade com a capacidade desejada. A presença de Credits não garante que toda operação possa continuar.

3. Você precisa continuar a programação de texto agora: use uma rota separada

Quando a tarefa não depende de benefícios exclusivos do M Plan, um provedor API independente pode manter o trabalho de texto em andamento. Ele terá chave e cobrança próprias. Essa rota não reinicia o M Plan, não transfere Credits nem leva benefícios do MiniMax Code.

O próprio MiniMax separa a API key padrão pay-as-you-go da Subscription Key; elas não são intercambiáveis. Preserve a mesma separação com qualquer provedor externo: cada configuração deve usar a chave, o Base URL e o Model ID exato daquele provedor.

Exemplo: uma rota independente no OpenCode com BetterToken

BetterToken é um exemplo opcional de provedor separado, não uma recarga do M Plan. Em 10 de outubro de 2026, o catálogo atual da BetterToken lista o ID exato MiniMax-M3, e o guia do OpenCode usa o Base URL compatível com OpenAI https://www.bettertoken.ai/v1.

A documentação de modelos do MiniMax informa que MiniMax-M3.1-Flash-Preview está disponível atualmente apenas por M Plan e MiniMax Code. Não copie esse ID de preview para uma configuração externa; use o ID exato oferecido pelo provedor escolhido.

Configure sem misturar chaves

1. Crie uma API key na sua conta BetterToken. Não cole uma MiniMax Subscription Key.
2. No OpenCode, execute /connect, escolha Other, defina o provider id como bettertoken e insira a chave BetterToken no prompt de credenciais.
3. Crie opencode.json na raiz do projeto ou atualize ~/.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. Reinicie o OpenCode, selecione bettertoken/MiniMax-M3 e envie uma pergunta curta de programação.
5. Uma resposta normal confirma que a rota API independente está configurada. Isso não significa que a cota do MiniMax foi restaurada ou transferida.

Consulte o guia BetterToken para OpenCode e confirme o ID no catálogo atual de modelos antes de salvar a configuração.

Se a rota independente falhar, verifique uma camada por vez

• Falha de autenticação: execute /connect novamente e confirme que usou uma chave BetterToken, não uma MiniMax Subscription Key.
• Falha no endpoint: mantenha o Base URL exatamente como https://www.bettertoken.ai/v1; não acrescente /chat/completions.
• Modelo não encontrado: confira maiúsculas e ID completo. Use MiniMax-M3 e bettertoken/MiniMax-M3 nos campos correspondentes.
• A configuração não foi aplicada: reinicie o OpenCode e verifique se um opencode.json do projeto substitui o arquivo global.
• A ferramenta original do MiniMax continua bloqueada: esse é o limite esperado. Um provedor separado não altera janelas, Credits ou status da assinatura.

Cinco erros que mais desperdiçam tempo

1. Tratar uma limitação temporária como cota esgotada. Se ainda existe cota, reduza a concorrência e tente novamente.
2. Esperar apenas o reset de 5 horas. Modelos que não são de vídeo também precisam de saldo semanal.
3. Mover a mesma Subscription Key entre ferramentas. Todas compartilham o mesmo uso do M Plan.
4. Misturar Subscription Key e API key pay-as-you-go. Elas usam direitos e cobrança diferentes.
5. Tratar MiniMax-M3.1-Flash-Preview como um Model ID externo universal. Cada provedor exige o ID exato do catálogo atual.

Ordem prática de execução

Confira o plano e as janelas restantes no console ou com mmx quota. Se for apenas rate limit, reduza frequência e concorrência. Se a cota acabou, aguarde quando precisar de recursos exclusivos da assinatura, use Credits apenas quando a tarefa for elegível ou configure um provedor pay-as-you-go separado quando a continuidade do texto for prioridade.

Não tente resolver o problema alternando chaves por tentativa e erro. Manter separados M Plan ou Token Plan mantido, Subscription Key, API key padrão pay-as-you-go e chave de provedor externo evita diagnóstico incorreto e cobrança na conta errada.