AIHubMix Skill es una extensión local para agentes de programación con IA. Después de instalarla, puedes usar lenguaje natural en Codex, Claude Code, Cursor, Cline y otros agentes compatibles con Skills para integrar AIHubMix, consultar modelos, elegir por capacidad, generar ejemplos y diagnosticar errores.
Este Skill no incluye una lista fija de modelos. Cuando lo necesita, lee modelos, precios, ventanas de contexto, contratos de protocolo y otra información en tiempo real desde las API oficiales de AIHubMix, evitando que el agente dependa de memoria desactualizada.
Casos de uso
Requisitos previos
- Tener instalado al menos un AI Agent compatible con Skills, como Codex, Claude Code, Cursor, Cline, Gemini CLI u OpenCode.
- Tener Python 3.8 o superior disponible localmente.
- Para llamadas reales a modelos, prepara una AIHubMix API Key.
- Para consultar saldo, listas de Keys o modelos llamables por la cuenta actual, instala e inicia sesión en el CLI oficial
aihubmix.
Instalación
Opción 1: dejar que el Agent lo instale
Entrega esta instrucción al AI Agent que estés usando:
Opción 2: instalación manual
Cada Agent puede usar un directorio Skills distinto. Si tu herramienta usa un directorio compartido, revisa primero la documentación de Skills de ese Agent o deja que el Agent determine la ubicación de instalación.
Opcional: instalar AIHubMix CLI
El script AiHubMixAPI puede leer información pública de modelos y protocolos. El saldo de la cuenta, la gestión de Keys y los modelos realmente llamables por la cuenta actual requieren iniciar sesión en el CLI oficial.
Después de instalar, ejecuta:
Cómo usarlo
Después de instalar, normalmente no necesitas recordar comandos. Describe la tarea directamente en tu Agent:
Si el Agent no activa el Skill automáticamente, llámalo explícitamente:
Uso en línea de comandos
También puedes ejecutar el script directamente desde el directorio del Skill:
Para salida en chino, añade --lang zh o configura:
Referencia rápida
FAQ
El Agent no activa el Skill automáticamente
Cada Agent tiene una estrategia distinta para activar Skills. Puedes llamar primero a /AiHubMixAPI explícitamente, o describir la solicitud con más claridad usando palabras clave como “AIHubMix”, “modelo”, “Base URL”, “API Key” o “código de error”.
Un modelo aparece en la lista pública, pero mi Key no puede llamarlo
La lista pública solo indica que el modelo existe en la plataforma. No garantiza que la cuenta actual tenga permisos o saldo para llamarlo. Usa aihubmix models list o candidates --mine para comprobar el rango realmente llamable por la cuenta, y luego doctor --model <model-id> para una verificación real.
Cuándo necesito el CLI aihubmix
No lo necesitas para información pública. Para capacidades relacionadas con la cuenta, como saldo, gestión de Keys, modelos llamables y filtro --mine, debes instalar el CLI e iniciar sesión.
Se puede exponer la API Key
El script del Skill redacta los secretos. Aun así, evita escribir Keys reales en archivos del repositorio, issues, descripciones de PR o registros de chat. Usa variables de entorno para depuración local.
Recursos relacionados
