--- title: "FAQ" description: "Des réponses courtes aux questions qui reviennent le plus avec verbatra, du coût d'une exécution à ce que tu dois commiter." type: "reference" --- # FAQ Des réponses courtes aux questions qui reviennent le plus avec verbatra, du coût d'une exécution à ce que tu dois commiter. Des réponses courtes avec un lien vers la page qui donne les détails. Pour les messages d'erreur, voir [Dépannage](https://verbatra.kreitz-webdev.de/fr/docs/troubleshooting.md) et [Codes d'erreur](https://verbatra.kreitz-webdev.de/fr/docs/error-codes.md). ## Comment je contrôle le coût ? [#comment-je-contrôle-le-coût-] 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](https://verbatra.kreitz-webdev.de/fr/docs/estimating-cost.md). ## Combien coûte réellement une exécution ? [#combien-coûte-réellement-une-exécution-] 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](https://verbatra.kreitz-webdev.de/fr/docs/estimating-cost.md). ## Avec quel fournisseur commencer ? [#avec-quel-fournisseur-commencer-] 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é](https://verbatra.kreitz-webdev.de/fr/docs/data-handling.md#conservation-et-traitement-des-données-chez-le-fournisseur). Tous les fournisseurs sont comparés dans [Fournisseurs](https://verbatra.kreitz-webdev.de/fr/docs/providers.md). ## Je peux faire tourner un modèle local ? [#je-peux-faire-tourner-un-modèle-local-] 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](https://verbatra.kreitz-webdev.de/fr/docs/providers.md#libretranslate). ## Quelles langues verbatra prend-il en charge ? [#quelles-langues-verbatra-prend-il-en-charge-] 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](https://verbatra.kreitz-webdev.de/fr/docs/language-support.md). ## Comment les clés gardent-elles leur ordre ? [#comment-les-clés-gardent-elles-leur-ordre-] 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](https://verbatra.kreitz-webdev.de/fr/docs/formats.md). ## Pourquoi une traduction a-t-elle été signalée pour relecture ? [#pourquoi-une-traduction-a-t-elle-été-signalée-pour-relecture-] 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](https://verbatra.kreitz-webdev.de/fr/docs/error-codes.md#review-reason-codes). ## verbatra fonctionne-t-il dans un monorepo ? [#verbatra-fonctionne-t-il-dans-un-monorepo-] 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](https://verbatra.kreitz-webdev.de/fr/docs/config-file.md). ## Que dois-je commiter ? [#que-dois-je-commiter-] 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](https://verbatra.kreitz-webdev.de/fr/docs/the-lock-file.md). ## Comment je retraduis tout ? [#comment-je-retraduis-tout-] 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 ? [#utiliser-la-cli-implique-t-il-dinstaller-le-sdk-] 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 ? [#où-vivent-les-clés-dapi-] Uniquement dans des variables d'environnement, que la CLI lit aussi depuis [`.env.local` et `.env`](https://verbatra.kreitz-webdev.de/fr/docs/cli.md#fichiers-denvironnement). La config rejette les clés inconnues pour qu'aucun secret ne finisse dans un fichier commité. Voir [Fournisseurs](https://verbatra.kreitz-webdev.de/fr/docs/providers.md). ## verbatra envoie-t-il mes textes quelque part ? [#verbatra-envoie-t-il-mes-textes-quelque-part-] 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é](https://verbatra.kreitz-webdev.de/fr/docs/data-handling.md). ## Que vérifie réellement verbatra doctor ? [#que-vérifie-réellement-verbatra-doctor-] 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`](https://verbatra.kreitz-webdev.de/fr/docs/cli/doctor.md) a le tableau complet des vérifications. ## Un agent IA peut-il configurer ou piloter verbatra à ma place ? [#un-agent-ia-peut-il-configurer-ou-piloter-verbatra-à-ma-place-] Oui, par quatre surfaces : un prompt d'installation pour les agents de code ([Installer avec un agent IA](https://verbatra.kreitz-webdev.de/fr/docs/start-with-ai.md)), la sortie `--json` pour tes propres boucles ([Recettes pour agents et scripts](https://verbatra.kreitz-webdev.de/fr/docs/agent-recipes.md)), des outils WebMCP dans un onglet Studio ouvert ([Piloter Studio avec un agent de navigateur](https://verbatra.kreitz-webdev.de/fr/docs/agent-tools-in-studio.md)) et un serveur MCP en stdio ([`verbatra mcp`](https://verbatra.kreitz-webdev.de/fr/docs/cli/mcp.md)). 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 ? [#ce-site-publie-t-il-quelque-chose-pour-les-agents-ia-et-les-robots-dindexation-] 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`](https://verbatra.kreitz-webdev.de/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`](https://verbatra.kreitz-webdev.de/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`](https://verbatra.kreitz-webdev.de/.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 ? [#le-contenu-de-ce-site-est-il-traduit-par-ia-] 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](https://verbatra.kreitz-webdev.de/fr/docs/formats.md) 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é](https://verbatra.kreitz-webdev.de/privacy) 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.