Le CLI Lingo.dev connecte votre base de code à un moteur de localisation via un seul champ de configuration. Chaque appel lingo.dev run passe par votre moteur, qui applique automatiquement votre voix de marque, votre glossaire, vos instructions et votre configuration de modèle. Aucun changement de code, aucune nouvelle dépendance.
Ce qui change#
| Avant | Après | |
|---|---|---|
| Pipeline de traduction | Pipeline Lingo.dev par défaut | Votre moteur de localisation |
| Voix de marque | Aucune | Appliquée par langue cible |
| Glossaire | Aucun | Association sémantique à chaque requête |
| Instructions | Aucune | Incluses par langue cible |
| Sélection du modèle | Par défaut Lingo.dev | Votre configuration de modèle avec basculement |
| Contrôle qualité | Aucun | Vos évaluateurs IA configurés s'exécutent automatiquement |
Configuration#
Ajoutez engineId à i18n.json (facultatif)
Pour cibler un moteur spécifique, ajoutez le champ engineId à votre configuration i18n.json. Vous trouverez l'ID de votre moteur dans le tableau de bord : il commence par eng_ (par ex. eng_SxjMwMsfOIsvV1wh).
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Tout le reste de votre configuration reste identique : langue source, cibles, buckets. Si vous omettez engineId, le CLI utilise le moteur par défaut de votre organisation.
Définissez votre clé API
Le CLI s'authentifie avec votre clé API Lingo.dev. Définissez-la comme variable d'environnement :
export LINGO_API_KEY="your-api-key"Ou enregistrez-la dans ~/.lingodotdevrc :
[auth.vnext]
apiKey = your-api-keyGénérez une clé API depuis la page API Keys du tableau de bord.
Lancez les traductions
lingo.dev runLe CLI envoie les requêtes de traduction à votre moteur et réécrit les résultats dans vos fichiers de langue, en appliquant automatiquement votre voix de marque, votre glossaire, vos instructions et votre configuration de modèle.
Référence de configuration#
i18n.json#
| Champ | Description |
|---|---|
engineId | Facultatif. ID de votre moteur (eng_...). S'il est omis, le moteur par défaut de votre organisation est utilisé. |
Tous les autres champs i18n.json de version (locale, buckets) fonctionnent exactement comme dans la configuration CLI standard.
Variables d'environnement#
| Variable | Obligatoire | Par défaut | Description |
|---|---|---|---|
LINGO_API_KEY | Oui | - | Votre clé API Lingo.dev |
LINGO_API_URL | Non | https://api.lingo.dev | URL de base de l'API personnalisée (pour l'auto-hébergement ou la préproduction) |
À quoi vous attendre#
Chaque traduction produite par le CLI passe par l'ensemble du pipeline de votre moteur :
- Voix de marque définit le ton et le niveau de formalité selon la langue
- Éléments du glossaire imposent une terminologie exacte grâce à une association sémantique
- Instructions appliquent des règles linguistiques propres à chaque langue
- Configurations de modèle sélectionnent le bon LLM avec basculement automatique
- Évaluateurs IA évaluent automatiquement la qualité après chaque requête
Les traductions apparaissent dans Reports avec le type de déclenchement api, aux côtés des requêtes provenant de l'API et des intégrations.
