FAQ

Des réponses courtes avec un lien vers la page qui donne les détails. Pour les messages d'erreur, voir Dépannage et Codes d'erreur.

Comment je contrôle le coût ?Copier le lien vers cette section

Les exécutions sont incrémentales, donc seules les clés manquantes ou modifiées atteignent le fournisseur, et relancer un projet inchangé ne coûte rien. verbatra translate --estimate dimensionne une exécution sans appeler de fournisseur, et --max-tokens ou maxTokens dans la config la plafonnent. Voir Estimer le coût.

Combien coûte réellement une exécution ?Copier le lien vers cette section

Peu : 400 clés vers 3 locales avec gemini-2.5-flash font environ 72 000 tokens, que tu chiffres au tarif actuel de ton fournisseur, et les exécutions suivantes ne paient que les textes que tu as modifiés. Comment estimer une exécution, où chaque fournisseur publie ses tarifs et la façon de calibrer sur ton propre projet sont dans Estimer le coût.

Avec quel fournisseur commencer ?Copier le lien vers cette section

Gemini, parce que son niveau d'API gratuit te permet de traduire tout un projet sans frais, et changer plus tard revient à modifier un id. Garde les textes confidentiels hors du niveau gratuit : voir Traitement des données et confidentialité. Tous les fournisseurs sont comparés dans Fournisseurs.

Je peux faire tourner un modèle local ?Copier le lien vers cette section

Oui : le fournisseur openai-compatible fait pointer verbatra vers tout serveur qui parle l'API de chat d'OpenAI, comme LM Studio, Ollama ou vLLM, en général sans clé. Sans aucun modèle de langage, libretranslate utilise un serveur LibreTranslate auto-hébergé. Voir Fournisseurs.

Quelles langues verbatra prend-il en charge ?Copier le lien vers cette section

Toute langue que ton fournisseur prend en charge, écrite sous forme de code BCP 47 valide comme pt-BR ou zh-Hant. DeepL et Google Cloud Translation ont des listes fixes ; les fournisseurs LLM n'en ont aucune. Voir Prise en charge des langues.

Comment les clés gardent-elles leur ordre ?Copier le lien vers cette section

Les clés existantes gardent leur position et les nouvelles sont ajoutées dans l'ordre de la source, donc un fichier traduit donne un diff propre. Voir Formats.

Pourquoi une traduction a-t-elle été signalée pour relecture ?Copier le lien vers cette section

Une heuristique de relecture a trouvé quelque chose qui mérite un second regard, comme une traduction identique à sa source, et l'a signalée sans la retenir. Chaque code de motif figure dans Motifs de relecture.

verbatra fonctionne-t-il dans un monorepo ?Copier le lien vers cette section

Oui. La recherche de la config remonte depuis le répertoire de travail et s'arrête au .git le plus proche, donc un paquet trouve sa propre config et la racine celle de la racine ; --cwd et --config pointent n'importe où ailleurs. Voir Fichier de configuration.

Que dois-je commiter ?Copier le lien vers cette section

Commite tes fichiers de locale, verbatra.lock.json et verbatra.provenance.json ; jamais .env, .env.local, .verbatra-local/ ni verbatra.cache.json, que verbatra init ajoute au .gitignore. Voir Le fichier de verrouillage.

Comment je retraduis tout ?Copier le lien vers cette section

Supprime le fichier de locale et lance verbatra translate : chaque clé manque alors et est retraduite. Supprimer le fichier de verrouillage ne suffit pas, car sans référence les traductions existantes comptent comme à jour. Pour une seule clé, utilise l'action de retraduction de Studio ou retranslateEntry.

Utiliser la CLI implique-t-il d'installer le SDK ?Copier le lien vers cette section

Aucune étape de plus : @verbatra/cli dépend de @verbatra/sdk, donc il vient avec. Seuls @verbatra/studio et @verbatra/mcp sont des installations séparées et facultatives.

Où vivent les clés d'API ?Copier le lien vers cette section

Uniquement dans des variables d'environnement, que la CLI lit aussi depuis .env.local et .env. La config rejette les clés inconnues pour qu'aucun secret ne finisse dans un fichier commité. Voir Fournisseurs.

verbatra envoie-t-il mes textes quelque part ?Copier le lien vers cette section

Uniquement au fournisseur que tu configures, et uniquement quand une commande traduit ; il n'y a aucune télémétrie. Avec provider: { id: "none" }, rien ne quitte la machine. Voir Traitement des données et confidentialité.

Que vérifie réellement verbatra doctor ?Copier le lien vers cette section

L'installation en une seule passe, sans appel de traduction et sans lire la valeur d'une clé, sauf si tu passes --live, qui l'envoie pour récupérer la liste des langues du fournisseur : la config, le format, le fournisseur, la variable de la clé d'API, la politique réseau, le fichier source et la prise en charge des locales, plus des rapports informatifs sur les pluriels, les codes de locale et l'état de locale restant. verbatra doctor a le tableau complet des vérifications.

Un agent IA peut-il configurer ou piloter verbatra à ma place ?Copier le lien vers cette section

Oui, par quatre surfaces : un prompt d'installation pour les agents de code (Installer avec un agent IA), la sortie --json pour tes propres boucles (Recettes pour agents et scripts), des outils WebMCP dans un onglet Studio ouvert (Piloter Studio avec un agent de navigateur) et un serveur MCP en stdio (verbatra mcp). Studio et le serveur MCP ne dépensent chez un fournisseur que derrière l'option --allow-spend ; dans la boucle --json, un vrai translate dépense aussitôt, donc ton script ou ton agent doit d'abord obtenir l'accord d'une personne.

Ce site publie-t-il quelque chose pour les agents IA et les robots d'indexation ?Copier le lien vers cette section

Oui, trois fichiers statiques, générés au moment du build et toujours en anglais, quelle que soit la locale que tu consultes :

• /llms.txt : un index organisé avec le titre et la description de chaque page de documentation, groupé comme la barre latérale, sous forme de liens Markdown.
• /llms-full.txt : toute la documentation dans un seul fichier, le contenu rendu de chaque page concaténé dans l'ordre, pour un agent qui ingère le contenu directement plutôt que de suivre des liens.
• /.well-known/ai.txt : une politique d'usage qui indique aux robots d'indexation IA que ce projet est sous licence MIT et que crawler, indexer et citer ce contenu est bienvenu.

Les trois sont accessibles depuis la colonne du pied de page dédiée aux agents IA.

Le contenu de ce site est-il traduit par IA ?Copier le lien vers cette section

En grande partie, par deux mécanismes différents. Le texte de l'interface (libellés de navigation, boutons, le pied de page, le texte de la landing page, la FAQ de la landing page) vit dans messages/en.json et ses fichiers frères de, es et fr ; ceux-ci sont traduits automatiquement avec verbatra lui-même, avec le format next-intl-json, via le fournisseur Gemini, en exécutant pnpm i18n après chaque changement de la source anglaise. C'est le projet qui utilise ici son propre outil (dogfooding), et le workflow docs-i18n-check fait échouer une pull request dont les fichiers de locale ne correspondent plus à la source anglaise. La prose de la documentation que tu lis en ce moment, chaque guide et chaque page de référence y compris celle-ci, est du MDX à suffixe de locale (page.mdx, page.de.mdx, page.es.mdx, page.fr.mdx) et elle aussi traduite par IA, mais en dehors de cette chaîne automatisée : pnpm i18n ne traduit que les formats de fichiers de locale structurés, jamais le Markdown, donc il ne touche jamais ces pages. À la place, un agent IA traduit chaque page de documentation dans le même changement que celui qui modifie sa source anglaise, pour que les quatre langues arrivent ensemble ; c'est pour ça que chaque page non anglaise affiche l'avis de traduction automatique.

Tout ne sort pas tel quel de ces deux étapes : certains textes, dont des parties des pages juridiques, ont été rédigés ou corrigés directement dans les fichiers de locale. Les traductions sont vérifiées dans la mesure du possible, et tous les textes traduits ne sont pas relus par une personne avant leur publication, une traduction peut donc contenir des erreurs. La politique de confidentialité décrit le même processus.

Si quelque chose sonne bizarre en allemand, en espagnol ou en français, ouvre une issue dans les deux cas : pour le texte de l'interface, la correction va dans la source anglaise puis est retraduite, ou directement dans le fichier de locale concerné ; pour la prose de la documentation, modifie le fichier MDX directement et envoie une pull request.