Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

El CLI de AiHubMix es una colección de scripts utilitarios que te permite gestionar tus claves API de AiHubMix, consultar información de la cuenta y usar los servicios de IA sin necesidad de pasar por una interfaz web. En esencia, encapsula las llamadas a la API (usando curl o requests de Python) para mayor comodidad en la línea de comandos.

​
Requisitos previos

Antes de usar el CLI de AiHubMix necesitas:
  1. Una cuenta de AIHubMix
  2. Generar un Access Token haciendo clic en “Generate System Access Token” en la página de Ajustes de AIHubMix;
  3. Instalar las dependencias de Python necesarias:
pip install -U requests openai
El script aihubmix_cli.py puede descargarse aquí

​
Descripción general de funciones

El CLI de AIHubMix ofrece las siguientes funcionalidades clave:

​
Resumen de endpoints de la API

EndpointMétodo HTTPDescripción
/api/user/selfGETObtener información del usuario actual y saldo de la cuenta
/api/token/GETObtener una lista de todas las claves
/api/token/POSTCrear una nueva clave API
/api/token/PUTActualizar una clave API existente
/api/token/{token_id}GETObtener información detallada de una clave específica
/api/token/{token_id}DELETEEliminar una clave específica
/api/token/searchGETBuscar claves (usa ?keyword=search_term)
/api/user/tokenGETObtener claves del usuario
/api/user/available_modelsGETObtener la lista de modelos disponibles para el usuario actual

​
Obtener información del saldo

# Using curl to retrieve balance, balance is quota / 500000
curl -X GET "https://aihubmix.com/api/user/self" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Gestión de claves

​
Crear una nueva clave

curl -X POST "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Key Name",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "subnet": ""
  }'

​
Obtener la lista de claves

curl -X GET "https://aihubmix.com/api/token/?num=20" \ # Adjust num parameter to change the number of output data.
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Buscar una clave

curl -X GET "https://aihubmix.com/api/token/search?keyword=search_term" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Actualizar una clave

curl -X PUT "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "Key_ID",
    "name": "New Name",
    "expired_time": 86400,
    "remain_quota": 100000,
    "status": 1
  }'

​
Eliminar una clave

curl -X DELETE "https://aihubmix.com/api/token/Key_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Obtener la clave del usuario

curl -X GET "https://aihubmix.com/api/user/token" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Gestión de modelos

​
Obtener los modelos disponibles del usuario

curl -X GET "https://aihubmix.com/api/user/available_models" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Salida en formato JSON

Todos los comandos del CLI admiten la salida de resultados en formato JSON, lo que facilita su procesamiento programático: 
python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

​
Resolución de problemas

Si encuentras problemas, puedes probar las siguientes soluciones:
  1. Problemas de conexión: Si falla la conexión al dominio principal, intenta usar un dominio alternativo: 
    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance
  2. Access Token no válido: Asegúrate de que el access token proporcionado sea una clave válida obtenida del sitio web de AIHubMix. El formato del access token suele ser similar a fd***.
  3. Permisos insuficientes: Algunas operaciones pueden requerir permisos específicos; asegúrate de que tu cuenta tenga los permisos adecuados.
  4. Fallo de la solicitud: Comprueba tu conexión de red o inténtalo más tarde.

​
Notas

  • El access token es distinto de la clave API regular utilizada para acceder a los modelos de IA.
  • Cada usuario tiene su propio access token del sistema, y el nivel de acceso lo determina el rol del usuario (usuario regular, administrador o usuario root).
Última actualización: 2026-06-01