Documentação

Chatbox

O Chatbox divide o endpoint entre host e caminho e preenche o caminho por você. Isso significa que o host é a origem — colocar /v1 nele é o erro que esse cliente induz.

Adicione um provedor do tipo OpenAI API Compatible com o API Host definido como a raiz do serviço — o Chatbox acrescenta /v1/chat/completions por conta própria.

Configurações do Chatbox

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

O API Host é https://api.kunavo.com, sem /v1. O Chatbox tem um campo separado para API Path, cujo valor padrão é /v1/chat/completions; por isso, um host que já termina em /v1 gera solicitações para /v1/v1/chat/completions. Deixe o caminho vazio, a menos que saiba que precisa de outro valor.

O seletor de tipo de provedor do Chatbox indica um formato de comunicação. Escolha OpenAI API 兼容 (compatível com a API OpenAI) e depois digite um ID de modelo Claude — o ID é resolvido no endpoint, então os dois não entram em conflito.

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

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra Configurações → Provedores de modelos e clique em Adicionar.
Dê um nome ao provedor, defina o tipo como OpenAI API 兼容 e cole a chave da API.
Defina API 主机 / API Host como https://api.kunavo.com e deixe API 路径 / API Path vazio.
Adicione os IDs de modelo desejados, salve e inicie uma conversa.

Verificado em Guia de configuração de provedores do Chatbox em 6 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.

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

# 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 Chatbox
`claude-sonnet-5`	$1.40 / $7.00	o modelo padrão das conversas
`claude-haiku-4-5`	$0.70 / $3.50	trocas curtas, em que latência e preço importam igualmente
`claude-opus-5`	$3.50 / $17.50	uma segunda entrada de provedor, mantida para perguntas difíceis
`gpt-5-6-terra`	$0.70 / $4.20	uma família diferente 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

Qual deve ser o API Host do Chatbox para um endpoint compatível com OpenAI?

A origem, sem caminho — por exemplo, https://api.example.com. O Chatbox tem um campo separado para API Path, cujo valor padrão é /v1/chat/completions e que, segundo a documentação, geralmente não precisa ser preenchido; portanto, /v1 vem do caminho, não do host. Um host que termina em /v1 gera solicitações para /v1/v1/chat/completions e retorna 404.

Como adiciono um provedor de modelos personalizado no Chatbox?

Abra Configurações → Provedores de modelos e clique em Adicionar; depois, dê um nome ao provedor, escolha o tipo de API compatível com OpenAI, cole a chave da API, defina o API Host como a origem do endpoint e deixe o API Path vazio. Adicione os IDs dos modelos que deseja usar e salve; o provedor aparecerá no seletor de modelos de todas as conversas.

O Chatbox consegue se comunicar com modelos Claude?

Sim, por meio de um endpoint compatível com OpenAI que os ofereça. O Chatbox envia o ID do modelo digitado ao host configurado, então o ID Claude é resolvido ali, e o aplicativo não precisa de credenciais Anthropic próprias. O seletor de tipo de provedor escolhe um formato de comunicação, não um fornecedor.

Quando devo preencher o API Path do Chatbox?

Somente quando o endpoint não oferecer chat completions em /v1/chat/completions. O campo existe para gateways com roteamento incomum; em um serviço padrão compatível com OpenAI, deixá-lo vazio é o correto, e digitar um caminho é uma causa comum de erros 404 que parecem problemas de autenticação.