Contrairement à la majorité des outils d'écriture qui enferment les créateurs dans un modèle propriétaire unique et appliquent de lourdes marges sur les jetons (tokens) via des abonnements mensuels, Novelcrafter repose sur une architecture BYOK (Bring Your Own Key, ou apportez votre propre clé). La plateforme fournit l'échafaudage indispensable aux écrivains — un éditeur de texte épuré, la gestion des scènes par temps forts (Scene Beats) et une bible d'univers structurée (Codex) —, tout en laissant l'auteur totalement maître du choix de ses moteurs d'IA et de sa puissance de calcul. Les romanciers peuvent y connecter les modèles commerciaux les plus performants, des passerelles d'agrégation ou encore des modèles open source exécutés localement et hors ligne.
Pour exploiter pleinement ce dispositif, trois étapes fondamentales doivent être maîtrisées : associer les identifiants d'API, assigner les modèles aux profils d'instructions (prompts) et ajuster les paramètres d'échantillonnage génératif (tels que la temperature, le top P et les pénalités de répétition) selon le souffle et le style du récit.
1. Connexion des fournisseurs d'IA et des clés API
Dans Novelcrafter, les connexions d'IA sont gérées au niveau du compte utilisateur. Elles sont accessibles via Photo de profil → Open Settings → AI Credentials (ou AI Connections). Un impératif technique majeur doit être gardé à l'esprit : toutes les clés API sont enregistrées exclusivement dans le stockage local de votre navigateur (Local Storage) et ne sont jamais sauvegardées sur des serveurs distants. Si vous effacez vos données de navigation, travaillez en navigation privée ou changez d'ordinateur, vous devrez reconnecter vos clés ou migrer vos paramètres via la fonction d'exportation/importation.
Option A : OpenRouter (Recommandé pour la majorité des romanciers)
Pour accéder à une grande diversité de modèles sans avoir à multiplier les comptes et les moyens de paiement, OpenRouter constitue l'approche la plus souple :
- Dans la liste AI Credentials, repérez OpenRouter et cliquez sur Connect.
- Cliquez sur Continue to OpenRouter, connectez-vous ou créez votre compte, puis validez l'autorisation.
- Lors de la connexion, vous pouvez définir une limite de dépenses par clé (Credit Limit). Attention : si vous fixez un plafond et que celui-ci est atteint, Novelcrafter affichera un message d'erreur indiquant une clé invalide ou des crédits épuisés ; vous devrez alors ajuster cette limite sur le tableau de bord d'OpenRouter.
- Grâce à un solde prépayé unique, OpenRouter donne accès aux modèles phares du marché : la gamme Claude d'Anthropic, les modèles GPT d'OpenAI, Mistral, Llama, ainsi que diverses variantes affinées pour la fiction par la communauté.
Option B : Connexion directe à l'API OpenAI
Si vous disposez d'un compte développeur sur la plateforme OpenAI :
- Rendez-vous sur votre console de développement OpenAI pour générer une clé secrète. Notez bien que l'abonnement grand public ChatGPT Plus ne comprend aucun accès à l'API ; ce sont deux facturations distinctes.
- Dans le menu AI Credentials de Novelcrafter, sélectionnez OpenAI, collez votre clé et validez.
Option C : Points de terminaison compatibles OpenAI (Clouds alternatifs et modèles locaux)
Novelcrafter prend en charge n'importe quel fournisseur respectant les spécifications standard de l'API OpenAI :
- Faites défiler le menu AI Credentials vers le bas et cliquez sur OpenAI Compatible Connection → Add.
- Nommez le fournisseur (par exemple Fireworks, Grok / xAI, Groq, Mancer, NanoGPT ou NovitaAI) et renseignez son Base URL. La plupart de ces adresses se terminent par
/v1(commehttps://api.groq.com/openai/v1ouhttps://api.x.ai/v1). - Saisissez votre clé API. En règle générale, Novelcrafter interroge le serveur et liste automatiquement les modèles disponibles. Si ce n'est pas le cas, cochez Use custom model list et indiquez manuellement les identifiants exacts des modèles, séparés par des virgules ou des retours à la ligne.
- Écriture 100 % confidentielle et hors ligne : Les auteurs exécutant des modèles en local sur leur machine via LM Studio ou Ollama peuvent indiquer leur adresse locale (comme
http://localhost:1234/v1). Le texte ne quitte jamais votre ordinateur et aucun coût par jeton n'est facturé. - Précision concernant l'API directe d'Anthropic : En raison des restrictions de sécurité CORS imposées par les navigateurs modernes, les requêtes directes depuis un navigateur vers la console officielle d'Anthropic sont bloquées. Les auteurs souhaitant utiliser Claude doivent passer par OpenRouter ou déployer un proxy local comme LiteLLM.
2. Gérer les modèles dans la bibliothèque de prompts
Une fois vos clés configurées, les modèles ne sont pas appliqués aveuglément à toute l'application : ils sont affectés à des tâches d'écriture spécifiques dans la Prompt Library. Novelcrafter compartimente les interventions de l'IA : rédaction à partir de temps forts (Scene Beat Completion), poursuite de texte (Continue Writing), résumé de scènes (Scene Summarization) et assistants d'atelier (Workshop Chat).
Pour personnaliser les modèles d'une tâche d'écriture :
- Ouvrez la Prompt Library depuis le menu principal ou la barre latérale du projet.
- Choisissez le prompt à modifier (par exemple le prompt système par défaut General Purpose Scene Beat Completion).
- S'il s'agit d'un prompt système verrouillé en lecture seule, cliquez sur Clone pour en créer un duplicata modifiable.
- Dans l'éditeur de prompt, rendez-vous dans l'onglet General puis dans la section Models.
- Vous pouvez y ajouter ou enlever des modèles, ou lier des Model Collections (collections de modèles). Il est très pratique de structurer des collections par usage — par exemple « Remue-méninges rapide » (avec Groq Llama 3) et « Prosa soignée » (avec Claude 3.5 Sonnet) — pour basculer aisément d'un profil à l'autre en cours de rédaction.
3. Ajuster les paramètres de génération de prose
En fiction romanesque, l'étalonnage des paramètres d'échantillonnage conditionne la voix, le rythme et la rigueur narrative bien plus que la seule puissance brute du modèle. En cliquant sur la flèche de déploiement (>) située à côté du nom de chaque modèle dans votre liste, vous accédez aux paramètres précis :
1. Temperature : Créativité contre Respect des consignes
- Fonctionnement : Régule la courbe de distribution des probabilités lors de la sélection du jeton suivant.
- Valeurs basses (0.3 à 0.6) : La prose gagne en logique, en retenue et en précision. Parfait pour résumer un chapitre antérieur, préserver la diction stricte d'un personnage ou faire progresser une intrigue policière reposant sur des indices immuables.
- Valeurs hautes (0.7 à 1.0+) : Le texte devient plus audacieux, les métaphores plus inventives et le vocabulaire plus sensoriel. À privilégier lorsque le texte paraît plat ou stéréotypé, ou pour peindre des visions oniriques et des scènes de combat épiques.
2. Top P : Richesse lexicale et suppression des anomalies
- Fonctionnement : Restreint les choix aux jetons appartenant au pourcentage cumulé supérieur de probabilité.
- Conseil pratique : Si un modèle sous haute température commence à produire des néologismes incompréhensibles ou des caractères erratiques (un travers fréquent sur certains modèles ouverts), abaissez le Top P à 0.85 – 0.90 pour cantonner le choix à des termes plus sûrs et attestés. Rehaussez-le pour enrichir le registre de langue.
3. Max Tokens : Longueur maximale et maîtrise du rythme
- Fonctionnement : Établit un plafond strict et infranchissable sur le nombre de jetons retournés en un appel.
- Conseil pratique : Les modèles de langage s'arrêtent net dès qu'ils atteignent ce plafond, même au beau milieu d'une phrase. N'utilisez donc jamais un Max Tokens trop étriqué pour calibrer la longueur de vos paragraphes. Accordez une marge suffisante pour couvrir un temps fort complet (800 à 1 500 jetons) et précisez le volume souhaité en nombre de mots via les instructions du prompt ou les variables d'entrée.
4. Pénalités : Bannir les répétitions et les tics de langage
- Frequency Penalty : Pénalise les mots à mesure qu'ils reviennent dans le texte généré. Si l'IA abuse d'un adverbe ou d'une expression fétiche (« soudain », « fixa du regard »), augmentez légèrement la valeur (+0.1 à +0.3). Ne forcez pas trop le trait sous peine de voir le modèle éviter le prénom de vos personnages.
- Presence Penalty : Décourage la réintroduction de sujets ou d'idées déjà abordés. Idéal dans les dialogues pour éviter que deux protagonistes ne tournent en boucle autour du même argument.
- Repetition Penalty : Paramètre standard des modèles open source et locaux (souvent calé entre 1.05 et 1.15), très efficace pour stopper les boucles syntaxiques.
- Reasoning / Thinking Effort : Sur les modèles dotés de capacités d'analyse préalable (comme le mode Thinking de Claude ou les modèles de raisonnement d'OpenAI), ce curseur dose le temps consacré par le modèle à vérifier la logique de l'intrigue et la conformité au Codex avant d'amorcer la rédaction de la prose.
4. Application concrète dans l'éditeur Write
Une fois la configuration terminée, l'utilisation dans le flux de travail quotidien se fait de manière très naturelle :
- Rendez-vous dans l'onglet Write et ouvrez la scène souhaitée.
- Sur une ligne vierge, tapez une barre oblique
/pour ouvrir le menu contextuel et sélectionnez Scene Beat. - Saisissez les indications de la scène (actions, tournants dramatiques, émotions). Novelcrafter détecte et relie automatiquement les fiches pertinentes de votre Codex (personnages, lieux, objets).
- Dans le menu déroulant situé près du bouton Play (▶), choisissez le modèle ou la collection souhaitée, ou cliquez sur Tweak and Generate pour affiner les paramètres à la volée.
- Une fois le texte produit, quatre choix s'offrent à vous :
- Apply : Insère directement la prose générée dans le corps du manuscrit.
- Retry : Supprime la proposition et relance une nouvelle génération avec les mêmes paramètres.
- Discard : Efface le résultat sans toucher au manuscrit.
- Section : Conserve la génération dans un bloc repliable (Section). Vous pouvez ainsi faire générer plusieurs variantes par des modèles différents et pratiquer le « kitbashing », en prélevant les meilleures répliques et descriptions de chaque essai pour composer votre scène définitive.
Grâce à la sécurité des connexions BYOK locales au navigateur, à la modularité de la bibliothèque de prompts et à la précision des réglages d'échantillonnage, les auteurs conservent une maîtrise intégrale de leur budget d'IA tout en façonnant l'identité littéraire singulière de leurs récits.