Démarrage avec l10n.dev

l10n.dev est une plateforme de localisation basée sur l'IA, conçue pour les développeurs et les équipes de localisation. Elle traduit vos fichiers i18n tout en préservant les clés, la structure, les espaces réservés et les formes plurielles — depuis votre agent IA, votre terminal, votre pipeline CI ou l'espace de travail Web. Cette page vous guide lors de votre première traduction et vous montre ce que la plateforme peut accomplir une fois configurée.

Étape 1 : Créer un compte

Créer votre clé API

Tout ce qui se trouve en dehors de l'espace de travail Web — l'agent IA, la CLI, l'action GitHub, les plugins et l'API — s'authentifie avec une clé API. Créez-en une sur la page des clés API et conservez-la en lieu sûr : vous la collerez dans la configuration de votre agent, de votre CLI ou dans vos secrets CI. Vous pouvez révoquer et réémettre une clé à tout moment.

Étape 2 : Choisissez comment vous souhaitez localiser

Il existe trois façons d'utiliser l10n.dev. Elles partagent le même moteur de traduction, le même solde de caractères, les mêmes glossaires et les mêmes instructions linguistiques — choisissez donc celle qui correspond à votre flux de travail actuel, et combinez-les plus tard.

Agent de localisation IA (MCP)

Connecter votre agent IA à notre serveur MCP le transforme en un outil de localisation professionnel. Au lieu de traduire lui-même les chaînes — ce qui consomme du contexte et crée des dérives entre les exécutions — l'agent appelle l10n.dev comme moteur de traduction dédié et reçoit un fichier terminé. C'est comme avoir un expert en localisation dans votre équipe.

• Efficacité des jetons : le contenu traduit ne passe jamais par la fenêtre de contexte de votre agent, ainsi votre assistant de codage continue de travailler sur le code.
• Garanties de format : les clés, l'ordre, les espaces réservés et les formes plurielles reviennent intacts — aucun JSON corrompu à nettoyer par la suite.
• Mémoire persistante : les glossaires et les instructions linguistiques sont stockés de notre côté, la qualité ne dépend donc pas de ce que l'agent se rappelle par hasard.

La configuration se fait avec une seule commande — la voici pour Claude Code (Cursor, Windsurf, Copilot, Claude Desktop et Codex sont couverts dans le guide) :

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Ensuite, demandez simplement à votre agent : "Traduis src/i18n/en en allemand et en japonais." Il détectera la structure de votre projet, traduira et écrira les fichiers pour vous.

Lire le guide de l'agent de localisation IA

CLI & GitHub Actions

Le package npm ai-l10n intègre la localisation dans votre terminal et votre pipeline CI/CD. Traduisez un fichier manuellement pendant le développement, puis déplacez la même commande dans un flux de travail afin que les nouvelles chaînes soient localisées avant même d'atteindre un réviseur.

• Détection de la structure du projet : pointez-le vers votre fichier source et il trouve automatiquement vos locales cibles existantes.
• Incrémentiel par défaut : avec translateOnlyNewStrings, seules les chaînes ajoutées ou modifiées sont envoyées et facturées.
• Prêt pour le pipeline : fonctionne de la même manière localement, dans GitHub Actions, GitLab CI ou Jenkins.

Installez le package, stockez votre clé API et traduisez votre premier fichier :

npm install ai-l10n

npx ai-l10n config --api-key YOUR_API_KEY

# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update

# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update

Pour traduire à chaque push, ajoutez notre action GitHub à votre flux de travail :

name: Auto-translate i18n files

on:
  push:
    branches: [main]
    paths: ['locales/en/**']

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

Lire le guide de l'automatisation de la localisation

Espace de travail Web

L'espace de travail est le moyen le plus rapide de voir ce que produit le service — pas de clé API, pas d'installation. C'est également là que vous gérez vos fichiers, glossaires, instructions et solde.

1. Téléversez votre fichier i18n — JSON, YAML, PO, XLIFF, ARB, Markdown ou texte brut.
2. Choisissez la langue source et une ou plusieurs langues cibles.
3. Attachez éventuellement un glossaire et des instructions linguistiques, et activez la traduction uniquement pour les nouvelles chaînes.
4. Appuyez sur Traduire, suivez la progression, puis téléchargez le résultat ou copiez-le directement dans votre dépôt.

Ouvrir l'espace de travail

Étape 3 : Ajuster la qualité de la traduction

Dès le départ, l'IA perçoit déjà les clés environnantes et la structure du fichier comme contexte. Ces deux fonctionnalités vous permettent de verrouiller le vocabulaire et la voix de votre produit, et elles s'appliquent à tous les chemins ci-dessus — agent, CLI, espace de travail et API.

Glossaire assisté par IA

Un glossaire définit la manière dont les noms de vos produits, les noms de fonctionnalités et les termes du domaine doivent être traduits. Activez la génération de glossaire et l10n.dev en construira un automatiquement à partir de votre contenu source et traduit, en l'enregistrant comme glossaire actif pour cette paire de langues — ainsi, chaque traduction future reste cohérente et fidèle à la marque. Vous pouvez également importer votre propre glossaire ou en générer un avec l'IA.

Gérer les glossaires

Instructions linguistiques

Les instructions linguistiques indiquent à l'IA comment écrire : formel ou décontracté, quelle forme d'adresse utiliser, comment gérer les noms de marque, les conventions spécifiques au produit ou tout autre élément définissant votre voix. Écrivez-les une fois et elles seront appliquées à chaque traduction pour cette langue.

Gérer les instructions linguistiques

Règle empirique : utilisez un glossaire pour ce qu'un mot doit devenir, et des instructions linguistiques pour la manière dont le texte entier doit sonner.

Ce que vous obtenez en plus

Traduction incrémentielle

Nous suivons vos chaînes sources par contenu, ainsi la relance d'une traduction n'envoie que ce qui a réellement changé. Les traductions existantes et révisées restent intactes, vos diffs Git restent petits et vous n'êtes facturé que pour le nouveau texte. Nous ne stockons pas votre contenu ; il est uniquement haché pour détecter les changements, vos chaînes sources restent donc privées.

165 langues et tous les formats courants

Traduisez dans 165 langues, y compris celles moins couramment prises en charge où les traducteurs humains sont difficiles à trouver. JSON, YAML, PO, XLIFF, ARB, Markdown, texte brut et spécifications OpenAPI sont tous gérés nativement — y compris les messages ICU et les formes plurielles CLDR complètes.

Garantie de format et modèles LLM multiples

Chaque résultat est validé par rapport à la source : si un espace réservé, une clé ou la structure est perdu, le bloc est automatiquement retenté. Les fichiers volumineux sont divisés en blocs qui conservent leur contexte, et nous exploitons plusieurs LLM afin que chaque langue et type de contenu obtienne le modèle qui le gère le mieux.

Intégrations pour toute votre équipe

La localisation n'est pas seulement une tâche de développeur. Intégrez l10n.dev dans les outils que votre équipe utilise déjà — plugins pour Figma, Obsidian, une extension VS Code, le package NPM, MCP et une API REST documentée.

Parcourir toutes les intégrations

Votre confidentialité compte

Nous ne stockons pas vos données de traduction. Lorsque vous traduisez des fichiers dans l'espace de travail, vous en gardez le contrôle total — supprimez-les à tout moment.

Gérer vos fichiers

Instance dédiée

Si votre organisation a besoin d'une infrastructure isolée, de sa propre base de données et de son propre stockage, de ses propres déploiements de modèles ou de garanties de conformité personnalisées, nous pouvons exécuter l10n.dev en tant qu'instance dédiée pour vous.

En savoir plus sur les instances dédiées

Forfait gratuit et forfaits

Chaque compte reçoit 10,000 caractères gratuits chaque mois. Aucun frais, aucune carte de crédit requise — c'est suffisant pour localiser une petite application ou pour évaluer correctement la qualité avant de vous engager.

Si vous avez besoin de plus que le quota mensuel gratuit, vous pouvez acheter un forfait pour augmenter votre solde de caractères. Utilisez l'adresse e-mail associée à la commande pour vous connecter et accéder à vos avantages.

Forfaits disponibles :

• 100K Characters
  Prix : $4.90
  Traduisez 100,000 caractères.*
• 1M Characters
  Prix : $14.90
  Traduisez 1,000,000 caractères.*
• 5M Characters
  Prix : $39.90
  Traduisez 5,000,000 caractères.*

*Chaque forfait est valide pour 90 jours, et le solde inutilisé est reporté lorsque vous achetez à nouveau avant son expiration.

Comparer tous les forfaits et tarifs

Où aller ensuite

Choisissez l'étape suivante qui correspond à votre façon de travailler — ou traduisez simplement un fichier et voyez le résultat par vous-même.

Pourquoi choisir l10n.dev ?

l10n.dev combine la puissance de l'IA avec des outils conviviaux pour rationaliser votre processus de localisation. Que vous soyez développeur ou membre d'une équipe de localisation, notre plateforme garantit des traductions précises, efficaces et abordables adaptées à vos besoins.