Solución de problemas

API, mensajes de CLI y CI

Lo que quieren decir los mensajes de planes y límites de la API de Mokxi, la herramienta de línea de comandos y la GitHub Action.

Lo que ves

El CLI imprime un error como mokxi: <mensaje> (<código>, <id de petición>). La API devuelve el mismo mensaje y código en su respuesta JSON. El código entre paréntesis es el encabezado de abajo. Envíanos el id de petición cuando nos escribas.

How each tool works is in la API de Mokxi, the command line tool and CI; la extensión de VS Code está en GitHub y VS Code.

Minutos de simulación (quota_exceeded)

"Ya usaste los N minutos de simulación que tu plan incluye este mes." El tiempo simulado ejecutado con la API cuenta para un monto mensual: 100 minutos en Gratis, 2,000 en Pro, Estudiante, Docente y Salón de clases, y 5,000 en Ultra (ya no se vende; las cuentas que lo tienen lo conservan). En Docente y Salón de clases el maestro y su grupo comparten un solo fondo, así que el mensaje puede decir "tu grupo" en su lugar. El contador se reinicia el primero de cada mes (UTC), que el mensaje indica. Una ejecución iniciada bajo el límite siempre termina, y nunca se cobra nada por pasarse. Los circuitos ejecutados en el editor nunca cuentan.

Demasiadas peticiones (rate_limited)

  • "Tu plan permite N peticiones por minuto por token" o "N simulaciones por hora por token". 60 peticiones por minuto y 30 simulaciones por hora en Gratis, 600 de cada una en los planes de pago. Espera los segundos que indica el encabezado Retry-After.
  • "Demasiadas peticiones sin token; envía uno para el límite de tu plan."
  • "La duración es de X ms; tu plan ejecuta N ms de tiempo simulado como máximo por petición." 10 segundos de tiempo simulado por ejecución en Gratis, 60 en los planes de pago. Divide una ejecución larga en varias más cortas.

Tokens (unauthorized, insufficient_scope, token_limit)

  • "Send your token as "Authorization: Bearer mkx_..."", "that token is not valid", "was revoked" or "has expired". Make a new token on API tokens in Configuración, o inicia sesión de nuevo con mokxi login.
  • "Este token no tiene el ámbito ..." Crea un token con ese ámbito marcado: simulate para ejecuciones, projects:read y projects:write para proyectos.
  • "Tu plan conserva N tokens de API a la vez; revoca uno primero." 5 en Gratis, 25 en los planes de pago.
  • "Ese código es desconocido o caducó; empieza de nuevo" (mokxi login). Ejecuta el login otra vez y aprueba el código nuevo en unos minutos.

Plan requerido (license_required)

  • "Mokxi para VS Code es parte de Pro." Inicia la prueba gratis de 7 días de Pro, o elige Pro en /pricing.
  • "Mokxi CI es gratis para repositorios públicos." Las ejecuciones desde la GitHub Action, o desde el CLI dentro de un trabajo de CI, en un repositorio privado necesitan un token de CI de una cuenta Pro (configúralo como MOKXI_TOKEN, o como la entrada token de la Action). El CI para repositorios privados viene con Pro, el precio de estudiante, Lifetime, Salón de clases y la prueba, y con Ultra para las cuentas que aún lo tienen. Ejecutar un sketch en tu propia computadora con mokxi run sigue siendo gratis, sin cuenta.
  • "... You can keep using it until then." (December 11, 2026) A notice, not an error: accounts that used VS Code or CI before the change keep it until that date.

¿Sigue atascado?

Escríbenos desde /support con las palabras exactas y el id de la petición.