Cuota agotada en MiniMax M Plan o Token Plan: revisa las ventanas y sigue programando

Cuando una herramienta de programación conectada a MiniMax se detiene, no empieces a cambiar clientes y claves al azar. Primero averigua si agotaste una ventana de M Plan, activaste un rate limit temporal, sigues en un Token Plan conservado o configuraste el tipo de clave equivocado. Con ese diagnóstico podrás decidir si conviene esperar, usar Credits compatibles o mover solo el trabajo de texto a una API de pago por uso independiente.

Empieza por esta tabla de decisión

Qué observas	Qué debes comprobar	Primera acción recomendada
La consola muestra agotada la ventana de 5 horas o la semanal	El nombre del plan y la hora de cierre de cada ventana	Esperar al reinicio correspondiente o verificar si los Credits cubren esa capacidad
Aún queda cuota, pero las llamadas se bloquean tras una ráfaga	Frecuencia, concurrencia y limitación dinámica en horas punta	Reducir frecuencia o concurrencia y volver a intentarlo después
La cuenta todavía indica Token Plan	Si es una suscripción conservada y si ya se actualizó	Seguir el aviso del plan conservado, sin asumir que todas las reglas de M Plan se aplican
Tras cambiar la clave empieza a descontarse saldo	Si la herramienta usa Subscription Key o una API key de pago por uso	Dejar de mezclar claves y configurar la ruta de facturación deseada
Necesitas continuar ya con programación de texto	Si aceptas facturación separada y no dependes de funciones exclusivas de M Plan	Configurar un proveedor independiente con su propia clave, endpoint y Model ID

Los síntomas pueden parecer iguales dentro del cliente, pero sus causas no lo son. El orden seguro es: primero plan y ventanas, después tipo de clave y, al final, cambio de proveedor.

M Plan tiene ventanas independientes de 5 horas y 7 días

Las reglas de uso de M Plan describen dos ventanas que se reinician automáticamente:

• Los modelos de texto, imagen, audio y otros modelos no relacionados con vídeo necesitan saldo tanto en una ventana de 5 horas como en una ventana semanal de 7 días.
• Los modelos de vídeo solo están sujetos a la ventana semanal.
• Ambas ventanas empiezan con el primer uso. Al terminar una ventana, vuelve el límite completo del nivel y el siguiente uso abre una ventana nueva.
• Las ventanas se reinician por separado. El reinicio de 5 horas no restablece el consumo semanal.
• La cuota no utilizada no se acumula en la siguiente ventana ni pasa al siguiente ciclo de facturación.

Por eso, esperar cinco horas puede no bastar: la ventana semanal todavía puede estar agotada. También puede ocurrir lo contrario: queda cuota, pero una limitación temporal de solicitudes bloquea las llamadas.

Todas las herramientas compatibles comparten el mismo uso

M Plan no asigna una cuota distinta a cada cliente. Lo usado en MiniMax Code y en herramientas compatibles conectadas con la misma Subscription Key cuenta dentro de los mismos límites del plan.

Cambiar de Claude Code a OpenCode, abrir otra sesión o pegar la misma Subscription Key en otra herramienta no crea cuota nueva. Consulta la página de uso de MiniMax para ver el plan, las ventanas, los Credits y el historial. Con MiniMax CLI también puedes ejecutar:

mmx quota

Este comando muestra el uso de M Plan y la cuota restante. Es una comprobación más fiable que deducir la causa a partir de un error genérico del cliente.

Un rate limit no significa que la cuota se haya agotado

MiniMax trata los límites de uso y los límites de frecuencia como controles separados. Muchas solicitudes en poco tiempo, demasiada concurrencia o una restricción dinámica durante horas punta pueden bloquear temporalmente las llamadas aunque todavía quede cuota.

Reduce la frecuencia y la concurrencia y vuelve a probar más tarde. No compres Credits, no actualices el plan ni sustituyas claves solo por una limitación breve. Sigue la rama de «cuota agotada» únicamente cuando la consola muestre que la ventana de 5 horas o la semanal está realmente vacía.

Confirma si la cuenta usa M Plan o un Token Plan conservado

Cuando MiniMax introdujo M Plan, Token Plan dejó de estar disponible para nuevas compras, pero los suscriptores existentes pudieron conservarlo o actualizar. Por eso importa el nombre que aparece en la cuenta:

• Si Plan Details muestra M Plan, aplica las reglas de ventanas independientes, uso compartido y Credits.
• Si todavía muestra Token Plan, consulta Existing Token Plan subscribers y revisa el estado de la suscripción conservada y de la renovación automática.
• La actualización es irreversible: el aviso oficial indica que no se puede volver a Token Plan y que el nuevo nivel de M Plan pasa a definir modelos, límites, ventajas y renovación.

No deduzcas las reglas actuales a partir de una entrada antigua o una configuración guardada. Mira primero el nombre y el estado reales en Plan Details.

Cuando la cuota sí está agotada, elige según la dependencia

1. Necesitas funciones exclusivas de la suscripción: espera el reinicio correcto

Esperar es la opción más limpia cuando el trabajo depende de un modelo exclusivo de M Plan, de prestaciones de MiniMax Code o del mismo flujo con Subscription Key. Comprueba si se agotó la ventana de 5 horas, la semanal o ambas y usa la hora final que muestra la consola.

Mientras esperas, elimina archivos irrelevantes del contexto, inicia una sesión más enfocada y divide el trabajo grande en pasos verificables. Eso no adelanta el reinicio, pero puede reducir el consumo en la siguiente ventana.

2. La cuenta tiene Credits: comprueba la compatibilidad

Primero se consume la cuota incluida en M Plan. Una vez alcanzado el límite, los Credits disponibles pueden cubrir uso adicional compatible, pero los paquetes solo se aplican a los modelos y capacidades que admiten.

Comprueba en la página de uso el saldo, la caducidad y si la capacidad concreta es compatible. Tener Credits no garantiza que cualquier operación pueda continuar.

3. Debes seguir programando texto ahora: usa una ruta de pago por uso separada

Si la tarea no necesita ventajas exclusivas de M Plan, un proveedor API independiente puede mantener en marcha el trabajo de texto. Tendrá su propia clave y facturación. Esta ruta no reinicia M Plan, no transfiere Credits ni mueve las ventajas de MiniMax Code.

MiniMax separa la API key estándar de pago por uso de la Subscription Key; no son intercambiables. Mantén el mismo límite con cualquier proveedor externo: cada configuración debe usar la clave, el Base URL y el Model ID exacto de ese proveedor.

Ejemplo: una ruta independiente de OpenCode con BetterToken

BetterToken es un ejemplo opcional de proveedor independiente, no una recarga de M Plan. A 10 de octubre de 2026, su catálogo actual muestra el ID exacto MiniMax-M3, y su guía de OpenCode usa el Base URL compatible con OpenAI https://www.bettertoken.ai/v1.

La documentación de modelos de MiniMax indica que MiniMax-M3.1-Flash-Preview está disponible actualmente solo mediante M Plan y MiniMax Code. No copies ese ID de vista previa en un proveedor externo; utiliza el ID exacto de su catálogo.

Configuración sin mezclar claves

1. Crea una API key en tu cuenta de BetterToken. No pegues una MiniMax Subscription Key.
2. En OpenCode ejecuta /connect, elige Other, usa bettertoken como provider id e introduce la clave de BetterToken en el diálogo de credenciales.
3. Crea opencode.json en la raíz del proyecto o actualiza ~/.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. Reinicia OpenCode, selecciona bettertoken/MiniMax-M3 y envía una pregunta corta de programación.
5. Una respuesta normal confirma que la ruta API separada está configurada. No significa que la cuota de MiniMax se haya reiniciado o transferido.

Consulta la guía de OpenCode de BetterToken para completar la configuración y verifica el ID en el catálogo de modelos actual antes de guardar.

Si la ruta independiente falla, revisa una capa cada vez

• Fallo de autenticación: ejecuta /connect de nuevo y confirma que introdujiste una clave de BetterToken, no una MiniMax Subscription Key.
• Fallo del endpoint: conserva exactamente https://www.bettertoken.ai/v1 como Base URL; no añadas /chat/completions.
• Modelo no encontrado: revisa mayúsculas y el ID completo. Usa MiniMax-M3 y bettertoken/MiniMax-M3 en los campos correspondientes.
• La configuración no cambia: reinicia OpenCode y comprueba si un opencode.json del proyecto sobrescribe el archivo global.
• La herramienta original de MiniMax sigue bloqueada: es el límite esperado. Un proveedor separado no modifica ventanas, Credits ni estado de suscripción.

Cinco errores que hacen perder más tiempo

1. Confundir una limitación temporal con cuota agotada. Si queda cuota, reduce la concurrencia y reintenta.
2. Esperar solo al reinicio de 5 horas. Los modelos no relacionados con vídeo también necesitan saldo semanal.
3. Mover la misma Subscription Key entre herramientas. Todas comparten el mismo uso de M Plan.
4. Mezclar Subscription Key y API key de pago por uso. Usan derechos y facturación diferentes.
5. Tratar MiniMax-M3.1-Flash-Preview como un ID externo universal. Cada proveedor exige el ID exacto de su catálogo actual.

Orden práctico de actuación

Comprueba el plan y las ventanas restantes en la consola o con mmx quota. Si solo es un rate limit, reduce frecuencia y concurrencia. Si la cuota está agotada, espera cuando necesites funciones exclusivas de la suscripción, usa Credits solo si la tarea es compatible o configura un proveedor de pago por uso separado cuando sea prioritario continuar con texto.

No intentes resolverlo rotando claves al azar. Mantener separados M Plan o el Token Plan conservado, la Subscription Key, la API key estándar de pago por uso y la clave de un proveedor externo evita diagnósticos incorrectos y cargos en la cuenta equivocada.