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
| Caso | Puedes decir | Qué hace el Skill |
|---|
| Integrar AIHubMix | “Conecta este proyecto a AIHubMix” | Detecta el stack del proyecto, elige el protocolo adecuado y ofrece una integración mínima ejecutable |
| Consultar modelos | “Revisa los últimos modelos gemini disponibles” | Consulta y resume resultados desde la API de modelos en tiempo real de AIHubMix |
| Elegir por capacidad | “¿Qué modelos con entrada de imagen están disponibles?” | Filtra modelos candidatos por vision, generación de imágenes, video, TTS, STT, embedding, rerank y otras capacidades |
| Generar ejemplos | “Dame un ejemplo de Anthropic messages” | Genera ejemplos ejecutables para OpenAI, Anthropic, Gemini y otros protocolos |
| Verificar una Key | “Ayúdame a confirmar si este modelo se puede llamar” | Verifica la API Key y la disponibilidad del modelo con una llamada real mínima |
| Diagnosticar errores | “¿Por qué recibo este 401 / 400?” | Analiza endpoint, modelo, cuerpo de error e ID de solicitud para sugerir una solución |
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:
Instala AIHubMix Skill desde https://github.com/AIhubmix/skills y colócalo en el directorio Skills de la herramienta actual.
Claude Code puede usar ~/.claude/skills,
Codex puede usar ~/.codex/skills.
Después de instalar, ejecuta python <skill>/scripts/AiHubMixAPI.py --help para verificar.
Opción 2: instalación manual
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/
# Codex
cp -r AiHubMixAPI ~/.codex/skills/
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.
# Windows
irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
aihubmix login
aihubmix whoami
aihubmix models list
Cómo usarlo
Después de instalar, normalmente no necesitas recordar comandos. Describe la tarea directamente en tu Agent:
Conecta este proyecto Next.js a AIHubMix y ejecuta un smoke test con un modelo de texto llamable.
Revisa los últimos modelos de la familia Claude y sus precios en AIHubMix.
¿Qué modelos de generación de imágenes puedo usar? Muestra solo los que mi cuenta actual puede llamar.
Este endpoint devuelve 401. Ayúdame a determinar si el problema es la Key, la Base URL o los permisos del modelo.
/AiHubMixAPI consultar los últimos modelos gemini
/AiHubMixAPI diagnosticar este error 400
Uso en línea de comandos
También puedes ejecutar el script directamente desde el directorio del Skill:
# Consultar modelos
python scripts/AiHubMixAPI.py list --limit 20
python scripts/AiHubMixAPI.py report gemini
python scripts/AiHubMixAPI.py compare <model-a> <model-b>
# Buscar modelos candidatos por capacidad
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank
# Mostrar solo candidatos llamables por la cuenta actual; requiere aihubmix CLI con sesión iniciada
python scripts/AiHubMixAPI.py candidates --capability vision --mine
--lang zh o configura:
Referencia rápida
| Capacidad | Comando recomendado |
|---|
| Ver lista de modelos | list |
| Consultar un modelo o familia | get <model-id> / report <query> |
| Comparar modelos | compare <model-a> <model-b> ... |
| Elegir por capacidad | candidates --capability <capability> |
| Ver solo modelos llamables | candidates --capability <capability> --mine |
| Verificar API Key | doctor --model <model-id> |
| Verificar entrada de imagen | doctor --model <model-id> --image |
| Generar ejemplo compatible con OpenAI | example chat --model <model-id> |
| Generar ejemplo compatible con Anthropic | example messages --model <model-id> |
| Diagnosticar errores | troubleshoot --status <code> --endpoint <path> --model <model-id> |
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
