Eine Markenstimme legt fest, wie dein Produkt spricht — Ton, Formalität und Stil — mit einem Text pro Zielsprache. Sie gehört der Organisation: ein benannter Container, der für jede abgedeckte Sprache eine Variation enthält und per Verknüpfung auf eine Lokalisierungs-Engine angewendet wird.
Eine Stimme, viele Sprachen
Früher war eine Markenstimme der Text für genau eine Sprache und gehörte zu einer Engine. Heute ist sie eine einzige Stimme mit je einem Text pro Sprache. Engines, die zuvor pro Sprache eine eigene Stimme hatten, wurden zu einer einzigen Stimme mit einer Variation pro Sprache zusammengeführt — jede Sprache und jeder Text ist genau dort geblieben, wo er war.
So funktioniert's#
| Objekt | Felder |
|---|---|
| Markenstimme | Name, Beschreibung. Enthält einen Text pro Zielsprache. |
| Variation | Zielsprache (oder *), Stimmtext. |
Wenn die Engine eine Anfrage für eine Zielsprache verarbeitet, ermittelt sie über alle verknüpften Stimmen hinweg die am besten passende Variation und fügt deren Text in den LLM-Prompt ein — so prägt sie Wortwahl, Satzbau und Register.
Pro Anfrage gilt genau ein Markenstimmen-Text. Regeln und Glossarbegriffe werden kombiniert; Markenstimmen nicht.
| Feld | Beschreibung |
|---|---|
| Zielsprache | Die Sprache, für die dieser Text gilt (z. B. de, fr-CA, ja), oder * für jede Sprache |
| Text der Markenstimme | Freiform-Anweisungen, die Ton, Formalität und Stil für diese Sprache beschreiben |
Eine Stimme pro Sprache pro Engine#
Eine Engine verwendet für eine Sprache genau eine Markenstimme — und drei Schutzmechanismen sorgen dafür, dass das so bleibt:
| Versuch | Ergebnis |
|---|---|
Zwei Stimmen verknüpfen, die beide einen Text für de enthalten | Abgelehnt (400), mit Angabe der sich überschneidenden Sprachen |
Einer Stimme einen de-Text hinzufügen, während eine andere Stimme auf derselben Engine bereits de abdeckt | Abgelehnt (409) |
Einen zweiten de-Text zu derselben Stimme hinzufügen | Abgelehnt (409) - eine Stimme enthält genau einen Text pro Sprache |
Eine *-Variation ist der Standard für jede Sprache, die keinen eigenen Text hat. Ein sprachspezifischer Text hat immer Vorrang, und die regionale Auflösung funktioniert wie gewohnt: Ein de-DE-Text beantwortet auch eine allgemeine de-Anfrage. Siehe Sprachauflösung.
Markenstimmen gehören der Organisation#
| Aktion | Auswirkung |
|---|---|
| Eine Markenstimme erstellen | Sie existiert auf Organisationsebene und gilt für nichts, bis sie verknüpft wird |
| Mit einer Engine verknüpfen | Jede ihrer Variationen gilt für die passenden Sprachen dieser Engine |
| Mit mehreren Engines verknüpfen | Dieselbe Stimme steuert sie alle — einmal bearbeiten, und jede Engine übernimmt es |
| Mehrere Stimmen mit einer Engine verknüpfen | Erlaubt, solange keine zwei davon dieselbe Sprache abdecken |
| Von einer Engine trennen | Die Engine wendet sie nicht mehr an. Die Stimme und ihre Variationen bleiben erhalten. |
| Eine Markenstimme löschen | Abgelehnt, solange sie noch von einer Engine verwendet wird — zuerst trennen. Beim Löschen werden auch ihre Variationen entfernt. |
| Eine Engine löschen | Markenstimmen bleiben bestehen. Sie gehören der Organisation, nicht der Engine. |
Verwalte Stimmen unter Brand voices in der Organisations-Seitenleiste — die Liste zeigt, wie viele Sprachen jede Stimme abdeckt und in wie vielen Engines sie verwendet wird, und auf der Detailseite jeder Stimme findest du ihre Texte pro Sprache. Der Tab Brand Voice einer Engine zeigt eine Zeile pro Sprache und trennt immer ganze Stimmen.
Einen Markenstimmen-Text schreiben#
Der Stimmtext ist frei formulierte natürliche Sprache. Schreib ihn so, als würdest du einen Übersetzerin briefen, die oder der noch nie mit deinem Produkt gearbeitet hat.
Eine wirksame Markenstimme enthält:
- Formalitätsgrad – formelles „Sie“ vs. informelles „du“ im Deutschen, „vous“ vs. „tu“ im Französischen
- Ton – professionell, nahbar, verspielt, technisch
- Zielgruppe – Entwickler, Enterprise-Käufer, Endkunden, interne Teams
- Konventionen – wie Zahlen, Datumsangaben, Währungen oder produktspezifische Terminologie behandelt werden sollen
Beispiel#
Für eine deutsche Sprache mit Entwickler:innen als Zielgruppe:
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).Lass Name und Beschreibung des Containers für Menschen — sie kennzeichnen die Stimme in der Organisationsliste und erklären, wofür sie gedacht ist. Nur der Variationstext erreicht das Modell.
Markenstimmen mit der API verwenden#
Markenstimmen werden automatisch angewendet, wenn du den localize endpoint aufrufst. Die Engine gleicht die targetLocale der Anfrage mit den Variationen aller verknüpften Stimmen ab und nimmt den besten Treffer in den Prompt auf. Zusätzliche Parameter sind nicht nötig.
{
"sourceLocale": "en",
"targetLocale": "de",
"data": {
"greeting": "Hey there! Ready to ship?",
"cta": "Get started"
}
}Mit dem deutschen Text oben erzeugt die Engine informelle, technisch geprägte Übersetzungen statt generischer formeller Ausgaben.
| Aufruf | Zweck |
|---|---|
POST /brand-voices | Eine Stimme für die Organisation erstellen |
GET /organizations/:id/brand-voices | Die Stimmen der Organisation mit Anzahl der Sprachen und Engines auflisten |
GET /brand-voices/:id/variations | Die Texte einer Stimme pro Sprache auflisten |
POST /brand-voice-variations mit brandVoiceId | Einen Text für eine Sprache hinzufügen |
PUT /brand-voice-variations/:id | Einen Text ändern oder in eine andere Sprache verschieben |
PUT /engines/:id/brand-voices | Die Menge der Stimmen ersetzen, die eine Engine verwendet |
DELETE /engines/:id/brand-voices/:brandVoiceId | Die Anwendung einer Stimme auf eine Engine beenden |
GET /engines/:id/brand-voice-variations | Alle Sprachtexte auflisten, die eine Engine aktuell verwendet |
POST /brand-voices akzeptiert weiterhin targetLocale und text zusammen und legt damit die erste Variation der Stimme an, und ownerEngineId fügt weiterhin Text zu der Stimme hinzu, die eine Engine bereits verwendet — und erstellt und verknüpft eine, wenn noch keine vorhanden ist.
Zugriff#
org:brandvoice:read und org:brandvoice:edit steuern Stimmen und ihre Variationen; um eine davon mit einer Engine zu verknüpfen, ist zusätzlich engine:edit auf dieser Engine erforderlich. Eine Berechtigung pro Stimme gibt jemandem Lese- und Bearbeitungszugriff auf genau eine Stimme statt auf alle Stimmen der Organisation. Siehe Roles & Permissions.
Markenstimmen über MCP verwalten#
Wenn Sie den Lingo.dev MCP server verwenden, kann Ihr KI-Coding-Assistent Markenstimmen direkt aus der Unterhaltung heraus erstellen und aktualisieren:
"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."