aihubmix). Una vez instalada, puedes consultar el saldo de la cuenta, gestionar claves API y ver los modelos disponibles directamente en el terminal, sin necesidad de abrir la consola web. Es un único binario, no requiere instalar Python, Node ni Go, y se instala con un solo comando; todos los comandos admiten salida JSON, lista para integrarse con scripts, CI y agentes de IA (como Claude Code).
Qué puede hacer:
- Consultar saldo: consulta en tiempo real el saldo de la cuenta y la cuota utilizada
- Gestionar Keys: crea, consulta, busca, modifica y elimina claves API
- Ver modelos: lista los modelos disponibles para el token actual
- Apto para scripts: salida JSON + códigos de salida estables, ideal para automatización y agentes de IA
No confundas las dos credenciales: el CLI inicia sesión con el «token de acceso al sistema» (Manage Key, formato
fd***); obtenlo en la consola console.aihubmix.com/setting haciendo clic en «Generar token de acceso al sistema». Se usa para gestionar la cuenta y no es lo mismo que la clave API (sk-***) que usas para llamar a los modelos.Instalación
Instalación rápida (recomendada)
Copia el comando correspondiente a tu sistema, pégalo en el terminal y ejecútalo: descargará el binario y lo añadirá automáticamente alPATH:
aihubmix login para empezar a usarlo.
También puedes descargar manualmente el binario de tu plataforma desde Releases (en Windows:
aihubmix_windows_amd64.exe) y colocarlo en un directorio del PATH; en sistemas tipo Unix ejecuta chmod +x.Inicio rápido
Una vez iniciada la sesión, puedes usar todos los comandos:Referencia de comandos
Operaciones habituales
Gestionar claves API
-q 10 indica que la clave tiene un límite de $10, y -u indica que no tiene límite de cuota. La eliminación solicita confirmación por defecto; en escenarios de CI puedes añadir --yes para omitirla.
Uso en scripts / agentes de IA
El CLI es muy amigable con la automatización y puede ser ejecutado directamente por CI, scripts o agentes de IA (como Claude Code):- Sin inicio de sesión: pasa el Manage Key mediante la variable de entorno
AIHUBMIX_TOKENo el flag--tokenpara omitir el inicio de sesión interactivo (prioridad:--token>AIHUBMIX_TOKEN> archivo de configuración). - Salida JSON: añade
--json(-j) a cualquier comando; los resultados normales van a stdout y los errores a stderr, lo que facilita el análisis conjq. - Códigos de salida estables: los scripts pueden usarlos para determinar el éxito o el fracaso.
Flags globales
Los siguientes parámetros se aplican a todos los comandos:Archivo de configuración
La información de inicio de sesión se guarda en~/.aihubmix/config.json (en Windows: %USERPROFILE%\.aihubmix\config.json), con permisos restringidos a solo lectura/escritura para el usuario actual. Al iniciar sesión, el Manage Key no se muestra en pantalla ni se escribe en los logs.
Preguntas frecuentes
¿Hace falta instalar Python / Node / Go? No. El CLI es un único binario, listo para usar tras descargarlo. ¿Qué diferencia hay entre el Manage Key y la API Key? El Manage Key (fd***) se usa para gestionar la cuenta (consultar saldo, gestionar claves) y lo utiliza el CLI; la API Key (sk-***) se usa para llamar a los modelos. Se generan en lugares distintos de la consola y no son intercambiables.
¿Es compatible con Windows?
Sí. Hay binarios nativos para Windows, macOS y Linux.
¿Cómo usarlo sin interacción en CI / scripts?
Pasa el Manage Key mediante la variable de entorno AIHUBMIX_TOKEN, combínalo con --json y los códigos de salida, y no necesitarás ejecutar aihubmix login.
¿Qué hago si olvido o se filtra el Manage Key?
Genéralo de nuevo en console.aihubmix.com/setting; el token antiguo dejará de ser válido.
Documentación relacionada: API de plataforma · CliEndpoints · Script Python antiguo · Consola de AIHubMix
Última actualización: 2026-06-22