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
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:
Opção 2: instalação manual
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.
Após a instalação, execute:
Como usar
Após a instalação, normalmente você não precisa memorizar comandos. Descreva a tarefa diretamente no Agent:
Se o Agent não acionar o Skill automaticamente, chame-o explicitamente:
Uso pela linha de comando
Você também pode executar o script diretamente no diretório do Skill:
Para saída em chinês, adicione --lang zh ou defina:
Referência rápida
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
