> ## 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. # Skills > AIHubMix Skill ofrece a Codex, Claude Code, Cursor, Cline y otros agentes de IA búsqueda de modelos en tiempo real, configuración de integración, generación de ejemplos y diagnóstico de errores. **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](https://console.aihubmix.com/token). * 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: ```text theme={null} 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 /scripts/AiHubMixAPI.py --help para verificar. ``` ### Opción 2: instalación manual ```bash theme={null} # 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. ```powershell theme={null} # Windows irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex ``` ```bash theme={null} # macOS / Linux curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh ``` Después de instalar, ejecuta: ```bash theme={null} 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: ```text theme={null} 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. ``` Si el Agent no activa el Skill automáticamente, llámalo explícitamente: ```text theme={null} /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: ```bash theme={null} # Consultar modelos python scripts/AiHubMixAPI.py list --limit 20 python scripts/AiHubMixAPI.py report gemini python scripts/AiHubMixAPI.py compare # 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 ``` Para salida en chino, añade `--lang zh` o configura: ```bash theme={null} export AIHUBMIX_LANG=zh ``` ## Referencia rápida | Capacidad | Comando recomendado | | ---------------------------------------- | ------------------------------------------------------------------- | | Ver lista de modelos | `list` | | Consultar un modelo o familia | `get ` / `report ` | | Comparar modelos | `compare ...` | | Elegir por capacidad | `candidates --capability ` | | Ver solo modelos llamables | `candidates --capability --mine` | | Verificar API Key | `doctor --model ` | | Verificar entrada de imagen | `doctor --model --image` | | Generar ejemplo compatible con OpenAI | `example chat --model ` | | Generar ejemplo compatible con Anthropic | `example messages --model ` | | Diagnosticar errores | `troubleshoot --status --endpoint --model ` | ## 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 ` 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 * Repositorio del Skill: [https://github.com/AIhubmix/skills](https://github.com/AIhubmix/skills) * AIHubMix CLI: [https://github.com/AIhubmix/platfrom-cli](https://github.com/AIhubmix/platfrom-cli) * Marketplace de modelos AIHubMix: [https://aihubmix.com/models](https://aihubmix.com/models)