> ## 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.

# Integração para Agents

> Todos os pontos de entrada da AIHubMix para AI Agents: instruções de integração agents.md, índice legível por máquina llms.txt, guia de chamada llms.txt por modelo, Playground Skill e deep links do Playground. Cada item com um comando copiável.

A AIHubMix oferece um conjunto de pontos de entrada legíveis por máquina para AI Agents (assistentes de programação como Claude Code, Codex, Cursor e Cline). O Agent pode descobrir modelos, gerar chamadas, verificar a conectividade e entregar a você um link do Playground já configurado. Esta página reúne todos os pontos de entrada, cada um com um comando copiável.

## Comece com uma frase

Envie a frase abaixo para o seu AI Agent:

```text theme={null}
Fetch https://aihubmix.com/agents.md and follow it.
```

`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

| Ponto de entrada                           | Endereço                                                    | Uso                                                                                                                                       |
| ------------------------------------------ | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Instruções de integração para Agents       | `https://aihubmix.com/agents.md`                            | Instruções passo a passo para o Agent concluir a integração e a verificação por conta própria                                             |
| Índice legível por máquina do site         | `https://aihubmix.com/llms.txt`                             | Índice legível por LLM das capacidades e da documentação do site                                                                          |
| Índice legível por máquina da documentação | `https://docs.aihubmix.com/llms.txt`                        | Índice de todas as páginas do site de documentação; adicione `.md` ao endereço de qualquer página de documentação para obter o texto puro |
| Guia de chamada por modelo                 | `https://aihubmix.com/model/{model_id}/llms.txt`            | Preços, capacidades verificadas, endpoints de protocolo e exemplos executáveis de um modelo específico                                    |
| Playground Skill                           | `https://aihubmix.com/skills/playground`                    | Arquivo de skill para o Agent testar modelos, ajustar parâmetros, comparar modelos e gerar mídia                                          |
| Catálogo de modelos em tempo real          | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | JSON sem autenticação, com preços e metadados                                                                                             |

## 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:

```bash theme={null}
curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt
```

A aba `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):

```text theme={null}
Run curl -fsSL https://aihubmix.com/skills/playground and follow it.
```

A Skill também é publicada em `/.well-known/skills/aihubmix-playground/SKILL.md` e pode ser instalada com `npx skills add AIhubmix/skills` a partir do [repositório GitHub](https://github.com/AIhubmix/skills). Para cenários de integração e desenvolvimento, use a [AIHubMix API Skill](/pt/skills).

## 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": "..."}`; `draft` preenche a caixa de entrada sem enviar

Os parâmetros do link são de uso único: após o carregamento da página, os parâmetros são removidos da barra de endereço e nenhuma chave é transportada.

## Geração de código

O pacote npm [`@aihubmix/codegen`](https://www.npmjs.com/package/@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`](https://www.npmjs.com/package/@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 ambiente `AIHUBMIX_API_KEY` e criada no [console](https://console.aihubmix.com/token). 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
