> ## 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 oferece a Codex, Claude Code, Cursor, Cline e outros agentes de IA consulta de modelos em tempo real, configuração de integração, geração de exemplos e diagnóstico de erros. **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](https://console.aihubmix.com/token). * 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: ```text theme={null} 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 /scripts/AiHubMixAPI.py --help para verificar. ``` ### Opção 2: instalação manual ```bash theme={null} # 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. ```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 ``` Após a instalação, execute: ```bash theme={null} 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: ```text theme={null} 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. ``` Se o Agent não acionar o Skill automaticamente, chame-o explicitamente: ```text theme={null} /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: ```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 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 ``` Para saída em chinês, adicione `--lang zh` ou defina: ```bash theme={null} export AIHUBMIX_LANG=zh ``` ## Referência rápida | Capacidade | Comando recomendado | | -------------------------------------- | ------------------------------------------------------------------- | | Ver lista de modelos | `list` | | Consultar um modelo ou família | `get ` / `report ` | | Comparar modelos | `compare ...` | | Escolher por capacidade | `candidates --capability ` | | Ver apenas modelos chamáveis | `candidates --capability --mine` | | Verificar API Key | `doctor --model ` | | Verificar entrada de imagem | `doctor --model --image` | | Gerar exemplo compatível com OpenAI | `example chat --model ` | | Gerar exemplo compatível com Anthropic | `example messages --model ` | | Diagnosticar erros | `troubleshoot --status --endpoint --model ` | ## 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 ` 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 * Repositório do 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)