Documentação

ChatWise

O ChatWise mantém todos os provedores por trás dos mesmos três campos. Dê um nome ao provedor personalizado, informe uma URL base da API e uma chave, pressione Buscar e o seletor de modelos será preenchido com IDs Claude e GPT usando o mesmo saldo.

Settings → Providers → "+" cria um provedor personalizado a partir de três campos — Provider name, API Base URL definida como https://api.kunavo.com/v1 e API Key — depois Fetch lê a lista de modelos do endpoint.

Settings → Providers → "+" → configuração personalizada

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

A URL base da API mantém o /v1. O ChatWise imprime a regra abaixo do próprio campo — “Não inclua /chat/completions na URL” —, então o valor é a raiz a partir da qual a rota parte, não a própria rota. O único gateway hospedado que a documentação mostra com esse campo preenchido tem o mesmo formato: https://aihubmix.com/v1. Uma URL base que já contém a rota falha com 404, não com um erro de autenticação.

Esta configuração é uma leitura da documentação do próprio ChatWise na data indicada abaixo. A Kunavo não executou o ChatWise contra seu endpoint — nem uma sessão, nem uma interação em streaming, nem uma chamada e resposta de ferramenta — e o mesmo vale para todos os clientes desta família. Uma página de configuração publicada não é um teste de compatibilidade. Mantenha disponível qualquer rota que já esteja funcionando enquanto experimenta esta.

A Kunavo não oferece modelos de embeddings, conversão de texto em fala nem conversão de fala em texto, então esta rota atende a conversas e geração de imagens, e nada mais. O recurso de entrada de áudio do ChatWise é diferente e não é afetado: ele anexa um arquivo de áudio à mensagem para um modelo que o aceite, em vez de chamar um serviço de transcrição.

Preencher este campo desativa uma extensão do ChatWise. A página de observabilidade alerta: “Verifique se a URL base da API do respectivo provedor está vazia; caso contrário, a observabilidade não será habilitada.” O painel do Cloudflare AI Gateway e uma URL base redirecionada são opções mutuamente exclusivas por provedor — por isso, faz sentido adicionar a Kunavo como uma entrada própria de provedor em vez de editar uma predefinida.

Vários produtos sem relação entre si usam o nome ChatWise. Esta página trata do cliente para desktop em chatwise.app — macOS, Windows e Linux — cuja documentação está em docs.chatwise.app. O feed público de lançamentos no GitHub termina muito antes da versão disponibilizada, então consulte os downloads do próprio aplicativo, e não esse feed, se uma captura de tela desta página não corresponder ao que você vê.

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

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
No ChatWise, abra Configurações → Provedores e clique em "+" para adicionar um novo provedor. A documentação oferece dois caminhos: escolher uma das predefinições integradas ou criar uma configuração personalizada — a Kunavo não é uma predefinição, então escolha a segunda opção.
Preencha Nome do provedor, URL base da API e Chave da API conforme indicado acima. Nenhuma opção do formulário seleciona um fornecedor: o endpoint resolve o ID do modelo, então usar um ID Claude por meio de um provedor compatível com OpenAI é a combinação pretendida, não uma incompatibilidade.
Na linha Modelos, pressione Buscar. A documentação do ChatWise diz que, se a API oferecer suporte ao endpoint /models, ele poderá adicionar os modelos disponíveis para você; a Kunavo responde em GET /v1/models, então a lista é preenchida automaticamente. A opção + Novo serve para adicionar IDs manualmente.
Se adicionar um modelo manualmente, a documentação especifica os campos: ID do modelo é o identificador da API e Nome de exibição é apenas um rótulo, então o ID precisa corresponder exatamente ao catálogo. Marque Recursos e defina Tamanho do contexto de acordo com o modelo — esses sinalizadores informam ao cliente o que oferecer, não o que o endpoint deve fazer.
Selecione o provedor no seletor de modelos e envie uma mensagem. Para modelos de imagem, a página de geração de imagens do ChatWise acrescenta uma etapa: o tipo do modelo precisa ser definido como Imagem antes que ele apareça no seletor de imagens.

Verificado em Página de provedores personalizados do ChatWise 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 o custo real de uso do ChatWise.

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

# 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 ChatWise
`claude-sonnet-5`	$1.40 / $7.00	a conversa do dia a dia — chats longos em que a qualidade por dólar é decisiva
`claude-opus-5`	$3.50 / $17.50	a pergunta difícil que, de outra forma, levaria você a abrir um segundo aplicativo
`claude-haiku-4-5`	$0.70 / $3.50	títulos, resumos e chamadas em segundo plano feitas pelo próprio cliente de chat
`gpt-5-6-terra`	$0.70 / $4.20	documentos longos colados, em que o limite é a janela de contexto
`gpt-5-6-sol`	$2.00 / $12.00	uma segunda opinião de outra família usando a mesma chave

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.

Perguntas frequentes

Como adiciono um provedor de API personalizado ao ChatWise?

Abra Configurações, acesse Provedores e clique em "+" para adicionar um novo provedor; em seguida, escolha uma predefinição ou crie uma configuração personalizada. Preencha o Nome do provedor, a URL base da API e a Chave da API, e adicione modelos pelo botão Buscar ou por "+ Novo". A documentação de provedores personalizados do próprio ChatWise descreve a integração de qualquer serviço de IA compatível com OpenAI ou Anthropic, então um gateway é um caso previsto, não uma solução improvisada.

A URL base da API do ChatWise precisa terminar em /v1?

Para um endpoint compatível com OpenAI, sim. O ChatWise imprime a regra abaixo do campo: não inclua /chat/completions na URL. O cliente acrescenta a rota por conta própria, então o valor deve ser a raiz /v1 — https://api.kunavo.com/v1 — e o único gateway hospedado que o ChatWise documenta com o campo preenchido segue o mesmo formato, https://aihubmix.com/v1. Omitir /v1 produz um 404, e não uma falha de autenticação, o que permite distinguir rapidamente os dois erros.

Por que a opção Buscar não retorna modelos no ChatWise?

A lista vem da rota /models do endpoint usando a chave informada, então um resultado vazio geralmente aponta para a chave ou a URL base, não para um catálogo vazio. Teste o mesmo par fora do aplicativo com um curl simples para /v1/models: uma resposta JSON indica que o problema está no formulário do provedor; 401 indica a chave; 404 indica a URL. Também é possível adicionar os modelos manualmente com "+ Novo"; nesse caso, o ID do modelo precisa corresponder exatamente ao ID no catálogo.

É necessária uma assinatura ou licença do ChatWise para usar minha própria chave de API?

São duas relações de pagamento separadas. Você compra o ChatWise uma vez, e o acesso aos modelos é cobrado por quem detém sua chave — com uma chave da Kunavo, o saldo pré-pago é consumido por token, sem mensalidade adicional. A configuração de provedores não aparece entre os recursos liberados pelo plano pago, mas nenhuma página do ChatWise afirma explicitamente que o plano gratuito permite adicionar um provedor personalizado; confirme isso durante o período de avaliação antes de contar com esse recurso.

O ChatWise pode usar modelos Claude sem uma conta Anthropic?

Sim, por meio de uma entrada de provedor compatível com OpenAI. O ID do modelo é resolvido no endpoint configurado, não dentro do ChatWise, então a credencial que você possui é a desse endpoint. Esse caminho é diferente de entrar no aplicativo com uma assinatura existente, opção que o ChatWise também anuncia: esse caminho depende dos termos de outro fornecedor, enquanto uma chave cobrada diretamente a você não. A Kunavo não executou o ChatWise contra seu endpoint, então considere esta página uma análise de configuração, não um resultado testado.