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.| Variable | Descripción | Valor por defecto |
|---|---|---|
AIHUBMIX_VERSION | Instala una versión específica (p. ej. v0.2.0) | latest |
AIHUBMIX_BIN_DIR | Directorio de instalación personalizado | Unix: /usr/local/bin o ~/.local/bin; Windows: %LOCALAPPDATA%\aihubmix\bin |
Inicio rápido
Una vez iniciada la sesión, puedes usar todos los comandos:Referencia de comandos
| Comando | Función |
|---|---|
aihubmix login | Iniciar sesión (pegar Manage Key) |
aihubmix logout | Cerrar sesión y eliminar las credenciales locales |
aihubmix whoami | Ver la identidad y el saldo de la sesión actual |
aihubmix me | Ver información completa de la cuenta y el saldo |
aihubmix models list | Ver los modelos disponibles actualmente |
aihubmix keys list [--num N] | Listar claves API |
aihubmix keys search <palabra clave> | Buscar claves por palabra clave |
aihubmix keys get <id> | Ver los detalles de una clave específica |
aihubmix keys create [parámetros] | Crear una nueva clave |
aihubmix keys update <id> [parámetros] | Modificar una clave |
aihubmix keys delete <id> | Eliminar una clave |
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.
| Código de salida | Significado |
|---|---|
0 | Éxito |
1 | Error general (parámetros incorrectos, fallo de negocio, etc.) |
2 | Fallo de autenticación (sin sesión iniciada / token inválido) |
3 | Error de red / conexión |
Flags globales
Los siguientes parámetros se aplican a todos los comandos:| Parámetro | Abreviatura | Descripción |
|---|---|---|
--token <token> | -t | Pasa el Manage Key directamente (para CI / scripts) |
--json | -j | Devuelve el resultado en formato JSON |
--base-url <url> | -b | URL base de la API personalizada (por defecto https://aihubmix.com) |
--no-color | Desactiva la salida con color | |
--config <path> | Especifica la ruta del archivo de configuración | |
--version | Ver la versión |
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