Amp Reabre BYOK Após Um Ano: Conectando e Configurando AIHubMix

Amp reabriu o BYOK (Bring Your Own Key), e AIHubMix agora o suporta. Este guia usa os modelos Claude da Anthropic como exemplo e orienta sobre como apontar o Amp para a API do AIHubMix via URL Personalizada e Roteamento de Modelos — cobrindo a chave da API, mapeamento de nomes de modelos e configuração do projeto.

Se você está procurando por "configuração do Amp BYOK", "conectar Amp ao AIHubMix", "chave da API do AIHubMix", "URL Personalizada do Amp" ou "Roteamento de Modelos do Amp", os passos abaixo cobrem isso.

Para que serve o Amp?

Fluxos de trabalho multi-modelo: atribua diferentes modelos a diferentes modos e agentes — Claude, GPT ou um modelo rápido para trabalhos leves.
Contexto de projeto completo: o Amp lê em toda a base de código, edita arquivos, executa comandos e realiza testes.
BYOK e roteamento personalizado: escolha seus próprios modelos e provedores através do Roteamento de Modelos, URL Personalizada e serviços de API de terceiros.
Web e CLI juntos: configure modelos no navegador e continue trabalhando no terminal.
Construído para equipes: compartilhe qualquer thread e trabalhe nela ao lado de seus colegas de equipe.
Threads sincronizadas na nuvem: cada thread se sincroniza automaticamente com a nuvem, para que sua equipe sempre comece do mesmo estado.

O restante deste guia usa os modelos Claude da Anthropic para mostrar como conectar o AIHubMix ao Amp.

Por que rotear o Amp através do AIHubMix? Uma chave e uma URL Base alcançam mais de 400 modelos entre provedores, o endpoint é compatível com a API de Mensagens da Anthropic (portanto, o Amp se comunica com ele nativamente), e o mapeamento de nomes de modelos por chave, além de fallback de erros, permite que você se adapte a qualquer nomenclatura que um cliente espera. Crie uma conta →

Parte 1 — Conectar a API

Passo 1: Abrir Configurações Pessoais

Na tela inicial do Amp, clique em Configurações Pessoais no canto inferior esquerdo.

Passo 2: Adicionar uma rota de modelo personalizada

Encontre Roteamento de Modelos na barra lateral esquerda, clique em Adicionar à direita e escolha URL Personalizada.

Passo 3: Criar uma chave de API e configurar o mapeamento de nomes de modelos

Vá para o console do AIHubMix e crie uma chave de API, depois configure um mapeamento de nomes de modelos nela.

O Amp espera nomes de modelos na forma provider/model — por exemplo anthropic/claude-fable-5-1. Os IDs de modelo do AIHubMix não têm o prefixo provider/ , então adicione um mapeamento que reescreva o nome que o Amp envia para o ID do modelo que o AIHubMix fornece:

Alias (o que o Amp envia)	Alvo (ID do modelo AIHubMix)
`anthropic/claude-fable-5-1`	`claude-fable-5-1`

As solicitações usando o alias são reescritas para o ID do modelo alvo. Cada chave suporta até 5 mapeamentos, e você pode opcionalmente adicionar modelos de fallback que são tentados, em ordem, quando uma solicitação falha.

Passo 4: Preencher os detalhes da conexão

De volta à tela de URL Personalizada do Amp, preencha os campos:

Chave da API: a chave que você acabou de criar no AIHubMix.
Formato da API: selecione Compatível com a API de Mensagens da Anthropic.
URL Base: https://aihubmix.com — o Amp confirma abaixo do campo que as solicitações vão para https://aihubmix.com/v1/messages.
Modelos: liste os aliases que você mapeou, um por linha (por exemplo anthropic/claude-fable-5-1). O Amp resolve cada um e mostra seu nome de exibição abaixo.

Deixe Ativar após a criação marcado para que novas solicitações comecem a ser roteadas através do provedor imediatamente, e clique em Criar.

Passo 5: Verificar a conexão

Uma vez salvo, a página de Roteamento de Modelos lista sua nova URL Personalizada. Clique em Verificar Acesso para testar a conexão.

Uma chave funcional retorna Chave Válida junto com a GET https://aihubmix.com/v1/models sonda, uma resposta HTTP 200 e uma contagem de modelos visíveis. A lista de modelos abaixo então mostra tudo que esta URL Personalizada pode alcançar.

Parte 2 — Criar um projeto e uma thread

Passo 6: Criar um projeto

Clique na entrada de projetos no canto inferior esquerdo, depois no botão de novo projeto no canto superior direito.

Escolha Começar do zero, insira um nome para o projeto e finalize a criação do projeto.

Passo 7: Criar uma thread

Dentro do projeto, clique em Nova Thread para iniciar uma tarefa.

Parte 3 — Atribuir modelos e começar a trabalhar

Passo 8: Atribuir um modelo a cada função

Volte para Configurações Pessoais e abra Discagem de Modos. Cada modo escolhe seus modelos automaticamente; aqui você pode fixar um modelo específico e o esforço de raciocínio para o Agente Principal de um modo, seu Oráculo e seus Subagentes. Qualquer coisa deixada em Automático continuará seguindo o próprio roteamento do Amp.

Passo 9: Escolher um modo e iniciar a conversa

Clique em Nova Thread, escolha o modo e o modelo que você deseja e comece a conversar ou passe uma tarefa de desenvolvimento para o Amp.

Essa é a configuração completa. Com uma chave do AIHubMix, o Amp pode acessar Claude, GPT e todos os outros modelos na plataforma — e você pode trocar o modelo por trás de qualquer modo sem tocar no restante da sua configuração.

Obtenha sua chave da API do AIHubMix →