Documentação

Amp

O Amp encaminha as solicitações aos modelos pelo servidor, então não há variável de URL base para configurar na sua máquina — você adiciona uma conexão Custom URL em Model Routing, e a nuvem do Amp chama o endpoint. Esse recurso está disponível em um plano pago, então essa é a primeira coisa a verificar.

Uma conexão Custom URL no Model Routing do Amp — formato de API chat-completions, URL base https://api.kunavo.com/v1, chave como token bearer — transfere modelos mapeados para uma única chave, nas faixas que oferecem a opção.

Settings → Model Routing → Add → Custom URL

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

Verifique seu plano do Amp antes de qualquer outra coisa. A página Model Routing do Amp informa, em 2026-09-21, que “os roteadores e gateways de modelos de IA são experimentais e estão em acesso antecipado apenas para clientes Megawatt, Gigawatt e Enterprise. Em breve, vamos disponibilizá-los para todos”. Uma conexão Custom URL faz parte dessa categoria, então, em uma conta Hobby, o menu Add não oferecerá essa opção. O Amp não publicou uma data para a disponibilização, e esta página não faz previsões a esse respeito.

O Kunavo não foi executado no Amp contra este endpoint. Todos os campos acima foram consultados na documentação do próprio Amp, e não em uma sessão concluída por alguém daqui — o recurso está disponível apenas em um plano pago do Amp. Considere isto uma transcrição das especificações do Amp, e use Check Access para confirmar se funciona.

chat-completions mantém o sufixo /v1 na URL base, porque o Amp acrescenta apenas a rota. O exemplo prático da própria documentação esclarece a questão: “uma URL base https://api.example.com/v1 com chat-completions envia solicitações para https://api.example.com/v1/chat/completions”. A mesma página acrescenta que uma URL base que já termina em /v1 é “aceita e não duplicada”, e que o formulário da conexão mostra a URL da solicitação enquanto você digita — assim, você pode conferir a URL resultante antes de salvar.

Os modelos de sistema Dictation e Realtime Voice do Amp são recursos de voz, e o Kunavo não oferece modelos de conversão de fala em texto nem de conversão de texto em fala. Uma conexão Custom URL aqui não pode atender a nenhum dos dois; deixe essas opções no Amp.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Amp.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra Model Routing nas suas configurações pessoais (admins do workspace usam Workspace Model Routing para compartilhar uma conexão com todos os membros), abra o menu Add e escolha Custom URL.
Defina o formato da API como chat-completions, cole https://api.kunavo.com/v1 como URL base e sua chave sk-kn- no campo da chave. O Amp a envia como Authorization: Bearer <key> em todos os formatos, que é o cabeçalho usado pelo Kunavo para autenticação; por isso, deixe Headers e Query Parameters vazios.
Escreva o mapeamento de modelos, com um padrão por linha. O lado esquerdo é o ID canônico do modelo no Amp, e o lado direito após -> é o ID recebido pelo Kunavo — as grafias diferem (o Amp usa openai/gpt-5.6-sol, e o Kunavo aceita gpt-5-6-sol), então a seta é necessária. Use o seletor Models para inserir os IDs canônicos em vez de digitá-los de memória.
Pressione Check Access. O Amp lista os modelos do endpoint quando o mapeamento é abrangente e envia uma solicitação de um token quando o mapeamento especifica exatamente um modelo. Em seguida, confirme que o gráfico de roteamento abaixo da lista de conexões mostra o Kunavo atendendo aos modelos mapeados e que todos os modelos sem mapeamento continuam indicando Amp.

Verificado em Documentação de Model Routing do Amp em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em quanto o Amp realmente custa e como uma conexão afeta ou não a cobrança.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Amp.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Amp
`gpt-5-6-sol`	$2.00 / $12.00	agente principal do modo Medium e Puck — o modelo de trabalho padrão do Amp
`gpt-6-astra`	$4.00 / $20.00	agente principal do modo High e subagente Oracle na maioria dos modos
`claude-fable-5-1`	$7.00 / $35.00	agente principal do modo Ultra, reservado para tarefas difíceis e abertas
`gpt-5-6-terra`	$0.70 / $4.20	o subagente Search — recuperação na base de código, em que o volume predomina
`claude-haiku-4-5`	$0.70 / $3.50	View Media, o modelo do Amp para imagens, PDFs e vídeo — Claude lê imagens, não vídeo

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

O que uma conexão não altera

O roteamento de modelos muda quem cobra pelos seus tokens, e nada mais. O uso de computação orb pelo Amp é medido separadamente, por minuto, então uma conexão não altera essa cobrança — e ferramentas que não são modelos, como a pesquisa na web, continuam consumindo créditos do Amp, independentemente do roteamento dos modelos. A assinatura do Amp que libera a opção Custom URL também é um custo fixo, cobrado antes do primeiro token.

Dois modelos que o Amp executa por padrão não aparecem na tabela acima porque o Kunavo não os oferece: os modelos GLM usados no modo Low e o subagente Read Thread. Uma conexão não pode reproduzir a configuração da opção mais barata do Amp, então um mapeamento de */* deixará silenciosamente esses dois modelos no Amp. Esse é o resultado correto, não um erro de configuração — a própria regra do Amp diz que tudo o que nenhuma conexão atende fica a cargo do Amp.

Perguntas frequentes

O Amp pode usar um endpoint de API personalizado?

Sim, por meio de uma conexão Custom URL em Model Routing, mas não em todos os planos. A documentação de Model Routing do Amp diz que os roteadores e gateways de modelos de IA — categoria à qual Custom URL pertence — são experimentais e estão em acesso antecipado apenas para clientes Megawatt, Gigawatt e Enterprise, e que o Amp os disponibilizará para todos em breve, sem informar uma data. Essa era a situação em 21 de setembro de 2026. Em uma conta Hobby, o menu Add nem sequer oferece essa opção; por isso, verifique primeiro o plano, não a URL base.

A URL base do Amp precisa terminar em /v1?

Depende do formato de API escolhido, e é por isso que esse campo costuma ser interpretado incorretamente. Com chat-completions, o Amp acrescenta apenas /chat/completions, então a URL base precisa ser a raiz /v1 — o exemplo documentado pelo próprio Amp transforma https://api.example.com/v1 em https://api.example.com/v1/chat/completions. Com anthropic-messages, o Amp acrescenta /v1/messages, então a origem sem caminho é a opção correta. O Amp também informa que uma URL base que já termina em /v1 é aceita sem duplicação, e que o formulário da conexão mostra a URL de solicitação resultante enquanto você digita, para que possa conferi-la antes de salvar.

Onde o Amp armazena a chave da API para um endpoint personalizado?

Nos servidores do Amp, não na sua máquina. O Amp intermedeia a inferência a partir da própria nuvem, então uma conexão Custom URL é configurada em Model Routing, nas configurações da sua conta, e não em um arquivo de configuração local ou variável de ambiente; além disso, o endpoint especificado precisa estar acessível pela infraestrutura do Amp. O Amp envia a credencial como um cabeçalho Authorization: Bearer em todos os três formatos de API. A referência publicada das configurações de CLI do Amp não inclui uma opção de URL base nem de chave de API; é o mesmo fato visto pelo lado do cliente.

Por que o Amp ainda usa os próprios modelos depois que adiciono uma conexão?

Porque uma conexão atende apenas aos modelos incluídos no mapeamento, e o Amp atende a todos os demais. Verifique três coisas, nesta ordem: se a conexão está ativa, onde aparece na lista de precedência — primeiro as conexões pessoais, depois as do workspace e, por último, o Amp, com prioridade 0 sendo testada primeiro — e se o mapeamento de modelos corresponde ao modelo executado pelo modo em uso. O gráfico de roteamento abaixo da lista de conexões mostra qual conexão atende cada modelo, e amp config model-providers check-access --provider-model executa uma inferência curta e informa qual conexão realmente a atendeu.

O Kunavo testou o Amp contra seu endpoint?

Não. O Kunavo não testou o Amp em tempo de execução, e esta página é uma transcrição da documentação de Model Routing do próprio Amp, consultada em 21 de setembro de 2026, não um relato de uma sessão concluída. O recurso Custom URL está restrito a um plano pago do Amp, então os campos aqui foram conferidos com base nas especificações publicadas pelo Amp, e não em um cliente em execução. O botão Check Access do Amp verifica a credencial com o provedor e é o teste definitivo; se o nome de algum campo nesta página já não corresponder ao que aparece no Amp, a documentação do Amp é a referência.