Comece com uma frase
Envie a frase abaixo para o seu AI Agent:agents.md é um conjunto de instruções de integração escrito para execução direta pelo Agent: verificar a API Key, escolher um modelo no catálogo em tempo real, chamar pelo protocolo correspondente e validar de ponta a ponta, incluindo uma tabela de solução de problemas.
Visão geral dos pontos de entrada
llms.txt por modelo
Cada modelo tem um guia de chamada legível por máquina, com preços, lista de capacidades verificadas, endpoints de protocolo suportados e exemplos executáveis:llms.txt na página de detalhes do modelo abre diretamente o arquivo correspondente. Modelos ainda não verificados retornam um documento de orientação que aponta para o catálogo em tempo real e o schema de parâmetros, sem declarações de capacidade não verificadas.
Playground Skill
Entregue ao seu Agent as capacidades do Playground (teste de modelos, ajuste de parâmetros, comparação com o mesmo prompt, geração de imagem e vídeo, continuação por deep link):/.well-known/skills/aihubmix-playground/SKILL.md e pode ser instalada com npx skills add AIhubmix/skills a partir do repositório GitHub. Para cenários de integração e desenvolvimento, use a AIHubMix API Skill.
Deep links do Playground
O Agent pode gerar links diretos para que você assuma no navegador uma sessão do Playground já configurada:- Comparação multimodelo:
https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1(até 6 modelos) - Configuração direta:
https://playground.aihubmix.com/?config=<JSON codificado em base64url>, com JSON no formato{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."};draftpreenche a caixa de entrada sem enviar
Geração de código
O pacote npm@aihubmix/codegen oferece geração programática de código em 4 protocolos e 7 linguagens, construindo corpos de requisição idênticos aos que o Playground realmente envia; @aihubmix/model-schema converte schemas de parâmetros em entrada para o codegen.
Perguntas frequentes
Como o Agent verifica que a integração funcionou?
agents.md inclui etapas de verificação de ponta a ponta: enviar uma requisição mínima que exige uma resposta exata e checar o corpo da resposta e o eco do modelo. HTTP 200 não significa sucesso; é necessário verificar o conteúdo da resposta.
Quais credenciais são necessárias para as chamadas?
Uma API Key da AIHubMix, passada pela variável de ambienteAIHUBMIX_API_KEY e criada no console. Não escreva a Key em código, scripts ou conversas.
Quais modelos o llms.txt por modelo cobre?
Modelos verificados retornam a documentação completa (a lista de capacidades vem de dados verificados oficialmente); os demais modelos retornam um documento de orientação. A cobertura aumenta conforme o processo de verificação avança.Qual é o suporte atual a MCP?
O endpoint MCP atualmente oferece geração de imagens, com expansão de capacidades em andamento. Nesta fase, recomenda-se priorizar a integração via Skill e agents.md.Última atualização: 2026-08-20