Une voix de marque définit la façon dont votre produit s’exprime — ton, niveau de formalité et style — avec un texte par langue cible. Elle appartient à l’organisation : c’est un conteneur nommé qui porte une variation pour chaque langue qu’elle couvre, et qui s’applique à un moteur de localisation par rattachement.
Une voix, plusieurs langues
Auparavant, une voix de marque correspondait au texte d’une seule langue, rattaché à un seul moteur. Désormais, une seule voix peut contenir un texte par langue. Les moteurs qui avaient une voix par langue ont été regroupés en une seule voix avec une variation par langue — chaque langue et chaque texte restent exactement là où ils étaient.
Fonctionnement#
| Objet | Champs |
|---|---|
| Voix de marque | Nom, description. Contient un texte par langue cible. |
| Variation | Langue cible (ou *), texte de la voix. |
Lorsqu’un moteur traite une requête pour une langue cible, il sélectionne la variation la plus pertinente parmi toutes les voix rattachées et inclut ce texte dans le prompt du LLM — ce qui influence le choix des mots, la structure des phrases et le registre.
Un seul texte de voix de marque s’applique à chaque requête. Les règles et les termes du glossaire se combinent ; les voix de marque, non.
| Champ | Description |
|---|---|
| Langue cible | La langue à laquelle ce texte s’applique (par ex. de, fr-CA, ja), ou * pour n’importe quelle langue |
| Texte de la voix | Instructions libres décrivant le ton, le niveau de formalité et le style pour cette langue |
Une voix par langue et par moteur#
Un moteur n’utilise qu’une seule voix de marque par langue, et trois garde-fous garantissent ce fonctionnement :
| Tentative | Résultat |
|---|---|
Rattacher deux voix qui portent toutes les deux un texte pour de | Refusé (400), avec indication des langues qui se chevauchent |
Ajouter un texte de à une voix alors qu’une autre voix sur le même moteur couvre déjà de | Refusé (409) |
Ajouter un deuxième texte de à la même voix | Refusé (409) - une voix contient un seul texte par langue |
Une variation * sert de valeur par défaut pour toute langue qui n’a pas son propre texte. Un texte spécifique à une langue a toujours priorité sur elle, et la résolution régionale s’applique comme d’habitude : un texte de-DE répond à une requête générique de. Voir Résolution des langues.
Les voix de marque appartiennent à l’organisation#
| Action | Effet |
|---|---|
| Créer une voix de marque | Elle existe au niveau de l’organisation et ne s’applique à rien tant qu’elle n’est pas rattachée |
| La rattacher à un moteur | Chacune de ses variations s’applique aux langues correspondantes de ce moteur |
| La rattacher à plusieurs moteurs | La même voix les pilote tous — modifiez-la une fois, chaque moteur suit |
| Rattacher plusieurs voix à un moteur | Autorisé tant qu’aucune d’entre elles ne couvre la même langue |
| La détacher d’un moteur | Le moteur cesse de l’appliquer. La voix et ses variations sont conservées. |
| Supprimer une voix de marque | Refusé tant qu’un moteur l’applique encore - détachez-la d’abord. La suppression emporte aussi ses variations. |
| Supprimer un moteur | Les voix de marque restent intactes. Elles appartiennent à l’organisation, pas au moteur. |
Gérez les voix dans Voix de marque de la barre latérale de l’organisation — la liste indique combien de langues chaque voix couvre et combien de moteurs l’appliquent, et la page de détail de chaque voix répertorie ses textes par langue. L’onglet Brand Voice d’un moteur affiche une ligne par langue et permet de détacher des voix entières.
Rédiger un texte de voix de marque#
Le texte de voix est rédigé en langage naturel libre. Écrivez-le comme si vous briefiez un·e traducteur·rice qui n’a jamais travaillé avec votre produit.
Les voix de marque efficaces incluent :
- Niveau de formalité - formel « Sie » vs informel « du » en allemand, « vous » vs « tu » en français
- Ton - professionnel, conversationnel, ludique, technique
- Public - développeurs, acheteurs B2B, consommateurs, équipes internes
- Conventions - comment gérer les nombres, les dates, les devises ou la terminologie propre au produit
Exemple#
Pour une langue allemande destinée à un public de développeurs :
Use informal "du" address. Keep a direct, technical tone - similar
to how Stripe or Vercel write their German documentation. Prefer
short sentences. Use active voice. When a German equivalent exists
for a technical term, use it (e.g., "Bereitstellung" for deployment),
but keep widely-adopted English terms as-is (e.g., API, CLI, Token).Réservez le nom et la description du conteneur aux humains — ils permettent d’identifier la voix dans la liste de l’organisation et d’expliquer à quoi elle sert. Seul le texte de la variation est transmis au modèle.
Utiliser les voix de marque avec l’API#
Les voix de marque sont appliquées automatiquement lorsque vous appelez le point de terminaison localize. Le moteur fait correspondre la targetLocale de la requête aux variations de chaque voix rattachée et inclut la meilleure correspondance dans le prompt. Aucun paramètre supplémentaire n’est nécessaire.
{
"sourceLocale": "en",
"targetLocale": "de",
"data": {
"greeting": "Hey there! Ready to ship?",
"cta": "Get started"
}
}Avec le texte allemand ci-dessus, le moteur produit des traductions informelles et orientées technique plutôt qu’un rendu générique et formel.
| Appel | Objectif |
|---|---|
POST /brand-voices | Créer une voix pour l’organisation |
GET /organizations/:id/brand-voices | Lister les voix de l’organisation avec le nombre de langues et de moteurs |
GET /brand-voices/:id/variations | Lister les textes d’une voix par langue |
POST /brand-voice-variations avec brandVoiceId | Ajouter un texte pour une langue |
PUT /brand-voice-variations/:id | Modifier un texte ou le déplacer vers une autre langue |
PUT /engines/:id/brand-voices | Remplacer l’ensemble des voix qu’un moteur applique |
DELETE /engines/:id/brand-voices/:brandVoiceId | Cesser d’appliquer une voix à un moteur |
GET /engines/:id/brand-voice-variations | Lister chaque texte de langue qu’un moteur applique actuellement |
POST /brand-voices accepte toujours targetLocale et text ensemble et initialise la première variation de la voix, et ownerEngineId continue d’ajouter du contenu à la voix qu’un moteur applique déjà — en la créant et en l’appliquant si ce moteur n’en a aucune.
Accès#
org:brandvoice:read et org:brandvoice:edit régissent les voix et leurs variations ; pour en rattacher une à un moteur, il faut aussi engine:edit sur ce moteur. Une autorisation par voix permet à une personne d’avoir les droits de lecture et de modification sur une seule voix, au lieu de toutes les voix de l’organisation. Voir Rôles et autorisations.
Gérer les voix de marque via MCP#
Si vous utilisez le serveur MCP Lingo.dev, votre assistant de code IA peut créer et mettre à jour des voix de marque directement depuis la conversation :
"Create a brand voice called Product voice and apply it to the
docs engine.""Set its German text to informal du, technical tone, short
sentences, active voice."