AIHubMix Skill é uma extensão local para agentes de programação com IA. Após a instalação, você pode usar linguagem natural no Codex, Claude Code, Cursor, Cline e outros agentes compatíveis com Skills para integrar o AIHubMix, consultar modelos, escolher por capacidade, gerar exemplos e diagnosticar erros.
Este Skill não inclui uma lista fixa de modelos. Quando necessário, ele lê modelos, preços, janelas de contexto, contratos de protocolo e outras informações em tempo real das APIs oficiais do AIHubMix, evitando que o agente dependa de memória desatualizada.
Casos de uso
| Caso | Você pode dizer | O que o Skill faz |
|---|
| Integrar AIHubMix | “Conecte este projeto ao AIHubMix” | Detecta a stack do projeto, escolhe o protocolo adequado e fornece uma integração mínima executável |
| Consultar modelos | “Verifique os modelos gemini mais recentes disponíveis” | Consulta e resume os resultados da API de modelos em tempo real do AIHubMix |
| Escolher por capacidade | “Quais modelos com entrada de imagem estão disponíveis?” | Filtra candidatos por vision, geração de imagem, vídeo, TTS, STT, embedding, rerank e outras capacidades |
| Gerar exemplos | “Me dê um exemplo de Anthropic messages” | Gera exemplos executáveis para OpenAI, Anthropic, Gemini e outros protocolos |
| Verificar uma Key | “Ajude-me a confirmar se este modelo pode ser chamado” | Verifica a API Key e a disponibilidade do modelo com uma chamada real mínima |
| Diagnosticar erros | “Por que recebi este 401 / 400?” | Analisa endpoint, modelo, corpo do erro e ID da requisição para sugerir uma correção |
Pré-requisitos
- Ter pelo menos um AI Agent compatível com Skills instalado, como Codex, Claude Code, Cursor, Cline, Gemini CLI ou OpenCode.
- Ter Python 3.8 ou superior disponível localmente.
- Para chamadas reais a modelos, prepare uma AIHubMix API Key.
- Para consultar saldo, listas de Keys ou modelos chamáveis pela conta atual, instale e faça login no CLI oficial
aihubmix.
Instalação
Opção 1: deixar o Agent instalar
Forneça esta instrução ao AI Agent que você usa:
Instale AIHubMix Skill a partir de https://github.com/AIhubmix/skills e coloque-o no diretório Skills da ferramenta atual.
Claude Code pode usar ~/.claude/skills,
Codex pode usar ~/.codex/skills.
Após a instalação, execute python <skill>/scripts/AiHubMixAPI.py --help para verificar.
Opção 2: instalação manual
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/
# Codex
cp -r AiHubMixAPI ~/.codex/skills/
Diferentes agentes podem usar diretórios Skills diferentes. Se a sua ferramenta usa um diretório compartilhado, consulte primeiro a documentação de Skills desse agente ou deixe o agente decidir o local de instalação.
Opcional: instalar AIHubMix CLI
O script AiHubMixAPI pode ler informações públicas de modelos e protocolos. Saldo da conta, gerenciamento de Keys e modelos realmente chamáveis pela conta atual exigem login no 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
Como usar
Após a instalação, normalmente você não precisa memorizar comandos. Descreva a tarefa diretamente no Agent:
Conecte este projeto Next.js ao AIHubMix e execute um smoke test com um modelo de texto chamável.
Verifique os modelos mais recentes da família Claude e seus preços no AIHubMix.
Quais modelos de geração de imagem posso usar? Mostre apenas os que minha conta atual pode chamar.
Este endpoint retorna 401. Ajude-me a determinar se o problema é Key, Base URL ou permissão do modelo.
/AiHubMixAPI consultar os modelos gemini mais recentes
/AiHubMixAPI diagnosticar este erro 400
Uso pela linha de comando
Você também pode executar o script diretamente no diretório do 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 capacidade
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank
# Mostrar apenas candidatos chamáveis pela conta atual; requer aihubmix CLI logado
python scripts/AiHubMixAPI.py candidates --capability vision --mine
--lang zh ou defina:
Referência rápida
| Capacidade | Comando recomendado |
|---|
| Ver lista de modelos | list |
| Consultar um modelo ou família | get <model-id> / report <query> |
| Comparar modelos | compare <model-a> <model-b> ... |
| Escolher por capacidade | candidates --capability <capability> |
| Ver apenas modelos chamáveis | candidates --capability <capability> --mine |
| Verificar API Key | doctor --model <model-id> |
| Verificar entrada de imagem | doctor --model <model-id> --image |
| Gerar exemplo compatível com OpenAI | example chat --model <model-id> |
| Gerar exemplo compatível com Anthropic | example messages --model <model-id> |
| Diagnosticar erros | troubleshoot --status <code> --endpoint <path> --model <model-id> |
FAQ
O Agent não aciona o Skill automaticamente
Diferentes agentes usam estratégias diferentes para acionar Skills. Você pode primeiro chamar /AiHubMixAPI explicitamente ou descrever a solicitação com mais clareza usando palavras-chave como “AIHubMix”, “modelo”, “Base URL”, “API Key” ou “código de erro”.
Um modelo aparece na lista pública, mas minha Key não consegue chamá-lo
A lista pública de modelos indica apenas que o modelo existe na plataforma. Ela não garante que a conta atual tenha permissão ou saldo para chamá-lo. Use aihubmix models list ou candidates --mine para verificar o intervalo realmente chamável pela conta, e depois doctor --model <model-id> para uma verificação real.
Quando preciso do CLI aihubmix
Para informações públicas, ele não é necessário. Para capacidades relacionadas à conta, como saldo, gerenciamento de Keys, modelos chamáveis e filtro --mine, é necessário instalar o CLI e fazer login.
A API Key pode ser exposta
O script do Skill mascara segredos. Mesmo assim, evite escrever Keys reais em arquivos do repositório, issues, descrições de PR ou logs de chat. Use variáveis de ambiente para depuração local.
Recursos relacionados
