Skills

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

Después de instalar, ejecuta:

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.

Si el Agent no activa el Skill automáticamente, llámalo explícitamente:

/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

Para salida en chino, añade --lang zh o configura:

export AIHUBMIX_LANG=zh

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

Repositorio del Skill: https://github.com/AIhubmix/skills
AIHubMix CLI: https://github.com/AIhubmix/platfrom-cli
Marketplace de modelos AIHubMix: https://aihubmix.com/models

Empezar

Guías de la consola

Empresa y equipos

Funciones de gateway

Capacidades del modelo

Referencia de protocolo

Gestión de plataforma

Casos de uso

Requisitos previos

Instalación

Opción 1: dejar que el Agent lo instale

Opción 2: instalación manual

Opcional: instalar AIHubMix CLI

Cómo usarlo

Uso en línea de comandos

Referencia rápida

FAQ

El Agent no activa el Skill automáticamente

Un modelo aparece en la lista pública, pero mi Key no puede llamarlo

Cuándo necesito el CLI `aihubmix`

Se puede exponer la API Key

Recursos relacionados

​Casos de uso

​Requisitos previos

​Instalación

​Opción 1: dejar que el Agent lo instale

​Opción 2: instalación manual

​Opcional: instalar AIHubMix CLI

​Cómo usarlo

​Uso en línea de comandos

​Referencia rápida

​FAQ

​El Agent no activa el Skill automáticamente

​Un modelo aparece en la lista pública, pero mi Key no puede llamarlo

​Cuándo necesito el CLI aihubmix

​Se puede exponer la API Key

​Recursos relacionados

Casos de uso

Requisitos previos

Instalación

Opción 1: dejar que el Agent lo instale

Opción 2: instalación manual

Opcional: instalar AIHubMix CLI

Cómo usarlo

Uso en línea de comandos

Referencia rápida

FAQ

El Agent no activa el Skill automáticamente

Un modelo aparece en la lista pública, pero mi Key no puede llamarlo

Cuándo necesito el CLI `aihubmix`

Se puede exponer la API Key

Recursos relacionados