Diferente de muitas ferramentas que aprisionam os escritores em um único modelo proprietário e embutem margens exorbitantes sobre o custo dos tokens em assinaturas mensais, o Novelcrafter adota a arquitetura BYOK (Bring Your Own Key, ou traga sua própria chave). A plataforma fornece toda a infraestrutura especializada para romancistas — um editor de manuscrito livre de distrações, planejamento por batidas de cena (Scene Beats) e uma enciclopédia narrativa estruturada (Codex) —, deixando a escolha do poder computacional e dos modelos de IA integralmente sob controle do autor. O escritor pode conectar provedores comerciais de ponta, agregadores globais ou modelos de código aberto rodando de forma 100% offline em sua própria máquina.
Para extrair o potencial máximo dessa arquitetura, o autor precisa dominar três etapas fundamentais: conectar as credenciais de API, vincular modelos aos perfis de comandos (prompts) e calibrar os parâmetros de amostragem generativa (como temperature, top P e penalidades de repetição) de acordo com o ritmo e o estilo da sua narrativa.
1. Conexão de provedores de IA e chaves de API
No Novelcrafter, as conexões de inteligência artificial são configuradas no nível da conta. Para acessá-las, clique na sua foto de perfil → Open Settings → AI Credentials (ou AI Connections). Uma característica crucial que todo escritor deve saber: todas as chaves de API são armazenadas exclusivamente no navegador local (Local Storage) e nunca sincronizadas em servidores na nuvem. Se você limpar os dados de navegação, utilizar janelas anônimas ou alternar entre diferentes computadores, precisará reconectar suas chaves ou exportar e importar suas configurações.
Opção A: OpenRouter (Recomendado para a maioria dos autores)
Para quem busca acesso a uma vasta gama de modelos sem a complicação de gerenciar dezenas de faturas e cartões, o OpenRouter é a alternativa mais versátil:
- No menu AI Credentials, localize o OpenRouter e clique em Connect.
- Selecione Continue to OpenRouter, faça login ou crie sua conta e aprove a autorização.
- Durante a vinculação, é possível estipular um limite de gastos por chave (Credit Limit). Atenção: caso você atinja esse limite, o Novelcrafter acusará erro de chave inválida ou saldo insuficiente; para restabelecer o acesso, basta ajustar ou remover o teto no painel do OpenRouter.
- Por meio de um saldo pré-pago único, o OpenRouter desbloqueia o uso de modelos consagrados, incluindo a linha Claude da Anthropic, os modelos GPT da OpenAI, Mistral, Llama e modelos refinados pela comunidade para escrita criativa.
Opção B: Conexão direta com a API da OpenAI
Se você possui uma conta de desenvolvedor na plataforma da OpenAI:
- Acesse o console de desenvolvedores da OpenAI e gere uma chave de API secreta. Lembre-se de que a assinatura do ChatGPT Plus não inclui chamadas via API; são serviços e contas com tarifação separada.
- No menu AI Credentials do Novelcrafter, clique em OpenAI, cole sua chave e salve.
Opção C: Endpoints compatíveis com a OpenAI (Nuvens alternativas e modelos locais)
O Novelcrafter também oferece suporte completo a qualquer provedor que implemente a especificação padrão da API da OpenAI:
- Role a lista de AI Credentials até o final e clique em OpenAI Compatible Connection → Add.
- Defina um nome para o serviço (como Fireworks, Grok / xAI, Groq, Mancer, NanoGPT ou NovitaAI) e insira a Base URL correspondente. A imensa maioria desses endereços termina com
/v1(por exemplo,https://api.groq.com/openai/v1ouhttps://api.x.ai/v1). - Insira a respectiva chave de API. Em geral, o Novelcrafter detecta automaticamente os modelos disponibilizados pelo provedor. Se a listagem automática não ocorrer, marque Use custom model list e digite os nomes exatos dos modelos separados por vírgulas ou quebras de linha.
- Escrita offline e com privacidade absoluta: Autores que executam modelos localmente em seus computadores via LM Studio ou Ollama podem preencher a Base URL com o endereço local (como
http://localhost:1234/v1). Isso garante confidencialidade total da obra e custo zero em tokens. - Observação sobre a API direta da Anthropic: Devido às políticas de segurança e CORS dos navegadores modernos, requisições diretas a partir de páginas web para o console oficial da Anthropic são bloqueadas. Para usar o Claude, o caminho recomendado é a integração via OpenRouter ou um proxy intermediário como o LiteLLM.
2. Gerenciando modelos e perfis de comandos na biblioteca (Prompts)
Após a inserção das credenciais, os modelos não são ativados de maneira indistinta para todo o projeto; eles são atrelados a tarefas narrativas específicas dentro da Prompt Library. O Novelcrafter divide as funções de IA em blocos dedicados: redação por batida de cena (Scene Beat Completion), continuação de prosa (Continue Writing), resumo de capítulos (Scene Summarization) e assistentes de bate-papo (Workshop Chat).
Para personalizar os modelos atribuídos a uma tarefa:
- Abra a Prompt Library pelo menu principal ou pela barra lateral esquerda do projeto.
- Selecione o comando que deseja customizar (por exemplo, o modelo padrão General Purpose Scene Beat Completion).
- Se o comando selecionado for nativo do sistema (somente leitura), clique em Clone (clonar) para criar uma cópia editável, já que os padrões oficiais são protegidos contra alterações diretas.
- No editor do comando, vá até a aba General e clique em Models.
- Nessa tela, você pode adicionar ou remover modelos específicos, ou conectar Model Collections (coleções de modelos). Uma boa prática é criar coleções temáticas — como "Brainstorming Rápido" (usando Groq Llama 3) e "Prosa Literária Densa" (usando Claude 3.5 Sonnet) —, possibilitando alternar com facilidade durante a escrita.
3. Calibrando os parâmetros de geração de prosa
Na ficção, o ajuste fino dos parâmetros de amostragem tem impacto direto na naturalidade, no ritmo e na consistência das frases. Ao clicar na seta de expansão (>) ao lado de qualquer modelo na lista de Models, surgem os controles detalhados:
1. Temperature: Criatividade versus Fidelidade
- Como funciona: Determina a dispersão e a previsibilidade dos tokens gerados.
- Valores baixos (0.3 a 0.6): Resultam em um texto mais comedido, lógico e fiel às diretrizes. Indicado para resumir cenas, manter a consistência de vozes de personagens específicos ou conduzir passagens de mistério com pistas rígidas.
- Valores altos (0.7 a 1.0+): Conferem maior liberdade criativa, ousadia metafórica e riqueza sensorial. Excelente quando a narrativa parecer mecânica ou clichê, ou para cenas de sonhos, devaneios e batalhas intensas.
2. Top P: Amplitude vocabular e eliminação de artefatos
- Como funciona: Restringe as opções do modelo aos tokens cuja probabilidade acumulada atinja uma porcentagem de corte.
- Na prática: Caso o modelo comece a inventar termos desconexos ou símbolos estranhos sob altas temperaturas (algo comum em modelos abertos), reduza o Top P para 0.85 a 0.90. Isso força a IA a selecionar palavras mais usuais e seguras. Eleve o valor se desejar maior variedade de sinônimos.
3. Max Tokens: Extensão e ritmo de entrega
- Como funciona: Fixa um limite máximo inegociável para a quantidade de tokens gerados em cada chamada.
- Na prática: Os modelos interrompem a geração abruptamente ao bater nesse limite, mesmo no meio de uma frase. Por isso, não utilize Max Tokens muito baixos para controlar o tamanho de um parágrafo. Estabeleça uma margem confortável para a cena inteira (de 800 a 1.500 tokens) e defina a extensão desejada em palavras dentro do próprio prompt ou por meio de variáveis de entrada.
4. Penalidades: Evitando vícios de linguagem e repetições
- Frequency Penalty: Pune palavras de acordo com a quantidade de vezes que já surgiram no trecho atual. Se a IA apresentar o vício de repetir determinados termos (como "repentinamente", "olhar fixo" ou "sussurrou"), eleve discretamente o valor (+0.1 a +0.3); tome cuidado para não exagerar, ou o modelo evitará até mesmo o nome dos protagonistas.
- Presence Penalty: Desestimula a retomada de tópicos e conceitos já mencionados. É útil em discussões e diálogos dinâmicos para fazer a conversa avançar e impedir que os personagens repitam os mesmos argumentos.
- Repetition Penalty: Parâmetro tradicional em modelos abertos e locais (geralmente entre 1.05 e 1.15), muito eficaz para anular voltas em círculos.
- Reasoning / Thinking Effort: Em modelos com suporte a raciocínio avançado (como os modos de pensamento do Claude ou a família o da OpenAI), este controle define quanto tempo o modelo investirá analisando a coerência do enredo e as notas do Codex antes de redigir a prosa final.
4. O fluxo prático na interface Write
Após configurar as chaves e os comandos, a aplicação no cotidiano de escrita é intuitiva:
- Abra qualquer capítulo ou cena na tela Write.
- No corpo do editor de texto, digite a barra
/para abrir o menu de ações rápidas e escolha Scene Beat. - Escreva o que deve acontecer no trecho (ações, reações emocionais e diálogos pretendidos). O Novelcrafter detectará e integrará automaticamente os registros pertinentes do seu Codex (personagens, locais e itens).
- No menu suspenso ao lado do botão Play (▶), selecione o modelo ou perfil ajustado, ou clique em Tweak and Generate para afinar os parâmetros pontualmente.
- Ao concluir a geração, você tem quatro alternativas:
- Apply: Aceita e incorpora o texto diretamente ao manuscrito.
- Retry: Descarta o trecho gerado e executa uma nova tentativa com os mesmos parâmetros.
- Discard: Apaga a geração sem alterar o manuscrito.
- Section: Agrupa o texto em uma seção sanfonada (recolhível). Essa função viabiliza gerar versões com múltiplos modelos e fazer uma colagem narrativa (kitbashing), selecionando as melhores frases de cada rascunho para a versão definitiva.
Com o controle local das conexões BYOK, a biblioteca personalizável de prompts e a calibração precisa dos parâmetros de prosa, os romancistas garantem domínio pleno sobre seus custos de IA e conquistam total autonomia para lapidar a voz de suas obras.