Skills

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

Após a instalação, execute:

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.

Se o Agent não acionar o Skill automaticamente, chame-o explicitamente:

/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

Para saída em chinês, adicione --lang zh ou defina:

export AIHUBMIX_LANG=zh

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

Repositório do Skill: https://github.com/AIhubmix/skills
AIHubMix CLI: https://github.com/AIhubmix/platfrom-cli
Marketplace de modelos AIHubMix: https://aihubmix.com/models

Começar

Guias do console

Empresa e equipes

Recursos de gateway

Capacidades do modelo

Referência de protocolo

Gestão de plataforma

Casos de uso

Pré-requisitos

Instalação

Opção 1: deixar o Agent instalar

Opção 2: instalação manual

Opcional: instalar AIHubMix CLI

Como usar

Uso pela linha de comando

Referência rápida

FAQ

O Agent não aciona o Skill automaticamente

Um modelo aparece na lista pública, mas minha Key não consegue chamá-lo

Quando preciso do CLI `aihubmix`

A API Key pode ser exposta

Recursos relacionados

​Casos de uso

​Pré-requisitos

​Instalação

​Opção 1: deixar o Agent instalar

​Opção 2: instalação manual

​Opcional: instalar AIHubMix CLI

​Como usar

​Uso pela linha de comando

​Referência rápida

​FAQ

​O Agent não aciona o Skill automaticamente

​Um modelo aparece na lista pública, mas minha Key não consegue chamá-lo

​Quando preciso do CLI aihubmix

​A API Key pode ser exposta

​Recursos relacionados

Casos de uso

Pré-requisitos

Instalação

Opção 1: deixar o Agent instalar

Opção 2: instalação manual

Opcional: instalar AIHubMix CLI

Como usar

Uso pela linha de comando

Referência rápida

FAQ

O Agent não aciona o Skill automaticamente

Um modelo aparece na lista pública, mas minha Key não consegue chamá-lo

Quando preciso do CLI `aihubmix`

A API Key pode ser exposta

Recursos relacionados