Conectando um provedor de IA
Predefinições, chaves, o teste de conexão e como interpretar os erros.
NovelKnow não está vinculado a nenhum fornecedor de modelos — você traz sua própria chave de API, e qual modelo usar e quanto ele custa é decisão sua.
O caminho rápido
Configurações de IA → clique em uma predefinição de provedor → cole sua chave → teste a conexão → salve.
A predefinição preenche a URL base, o modelo padrão e a janela de contexto. Esses são os três pontos em que as pessoas mais erram e a causa mais comum de uma configuração não funcionar.
Predefinições integradas: DeepSeek, OpenRouter, OpenAI, Kimi / Moonshot, Qwen / DashScope, SiliconFlow e Ollama local.
Qualquer endpoint compatível com OpenAI funciona — escolha a opção personalizada e digite você mesmo a URL base.
Listas de modelos
Depois de salvar, "Sincronizar modelos" busca a lista real de modelos do provedor. A partir daí, os menus suspensos de modelos são preenchidos com ela, para que você nunca precise digitar o nome de um modelo manualmente.
Marque como favoritos os que você usa com frequência e eles aparecem no topo.
Interpretando os erros
Os testes de conexão e as falhas de geração incluem a própria resposta do provedor, para que você consiga diferenciar:
| O erro contém | Geralmente significa |
|---|---|
401 / Incorrect API key | Chave incorreta ou expirada |
404 / model does not exist | O nome do modelo está incorreto, ou sua conta não tem acesso a ele |
429 | Limite de requisições atingido, ou a conta está sem créditos |
fetch failed / ECONNREFUSED | O servidor não consegue acessar o provedor — veja a nota sobre proxy abaixo |
Proxy de saída
Se a sua implantação não consegue acessar um provedor, habilite o proxy de saída na caixa de diálogo de configurações de IA.
Esse endereço é resolvido a partir do servidor de implantação, não do seu próprio computador. Apontá-lo para 127.0.0.1:7890 só faz sentido se houver um proxy em execução no próprio servidor.
Como sua chave é armazenada
As chaves são criptografadas com uma chave derivada da sua conta e só são retornadas ao navegador mascaradas. Você nunca mais verá sua própria chave por inteiro — para trocá-la, cole uma nova.