Brand Voice

Der Brand-Voice-Service ermoeglicht es Ihnen, Brand Voices zu erstellen, zu verwalten und anzuwenden, um einen konsistenten Ton und Stil in allen generierten Inhalten sicherzustellen.

Konzepte

Brand Voices

Eine Brand Voice definiert, wie Ihre Inhalte klingen sollen -- einschliesslich Tonalitaet, Vokabular, Formatierungsregeln und Schreibstil. Brand Voices koennen:

• Manuell erstellt werden mit detaillierten Stileinstellungen
• Importiert werden aus URLs, Dokumenten oder Textbeschreibungen mittels KI-Analyse
• Dupliziert werden von bestehenden Brand Voices
• Aufgewertet werden fuer verbesserte Qualitaet mittels KI

Marken

Marken repraesentieren das Unternehmen oder Produkt, das mit einer Brand Voice verknuepft ist. Sie enthalten Kontaktinformationen, Social-Media-Links und Markenwerte.

DS Prompt

Jede Brand Voice kann einen "DS Prompt" generieren -- einen formatierten System-Prompt, der an die Content-Generation-API uebergeben werden kann, um die Brand Voice auf generierten Text anzuwenden.

Endpoints

Alle Endpoints verwenden den Basispfad: https://app.neuroflash.com/api/brand-voice-service

Brand Voices

Methode	Endpoint	Beschreibung
POST	/v1/workspaces/{id}/brand-voices	Brand Voice erstellen
GET	/v1/workspaces/{id}/brand-voices	Brand Voices auflisten
GET	/v1/workspaces/{id}/brand-voices/{id}	Brand Voice abrufen
PUT	/v1/workspaces/{id}/brand-voices/{id}	Brand Voice aktualisieren
DELETE	/v1/workspaces/{id}/brand-voices/{id}	Brand Voice loeschen
POST	/v1/workspaces/{id}/brand-voices/{id}/duplicate	Brand Voice duplizieren
POST	/v1/workspaces/{id}/brand-voices/{id}/ds-prompt	DS Prompt fuer Content-Generierung abrufen
POST	/v1/workspaces/{id}/brand-voices/{id}/upgrade	Brand-Voice-Qualitaet aufwerten

Marken

Methode	Endpoint	Beschreibung
POST	/v1/workspaces/{id}/brands	Marke erstellen
GET	/v1/workspaces/{id}/brands	Marken auflisten
GET	/v1/workspaces/{id}/brands/{id}	Marke abrufen
PUT	/v1/workspaces/{id}/brands/{id}	Marke aktualisieren
DELETE	/v1/workspaces/{id}/brands/{id}	Marke loeschen

Importe

Importe geben einen Entwurf zurück — ein zweiter API-Aufruf ist erforderlich zum Speichern

Die drei Import-Endpoints analysieren Ihre Inhalte und geben einen Brand-Voice-Vorschlag zurück. Es werden keine Daten in Ihren Workspace geschrieben, bis Sie POST /brand-voices mit den extrahierten Feldern aufrufen. Siehe den Abschnitt Import-Entwurf speichern für den vollständigen zweistufigen Workflow.

Methode	Endpoint	Beschreibung
POST	/v1/workspaces/{id}/brand-voice-text-imports	Aus Text importieren
POST	/v1/workspaces/{id}/brand-voice-url-imports	Aus URL importieren
POST	/v1/workspaces/{id}/brand-voice-file-imports	Aus Datei importieren

Brand Voice importieren

Alle drei Import-Endpoints (URL, Text, Datei) erfordern neben workspaceId drei weitere Pflichtparameter, die leicht übersehen werden:

Parameter	Typ	Beschreibung
country	string	2-stelliger Ländercode in Kleinbuchstaben (z. B. us, de, gb)
language	string	2-stelliger Sprachcode in Kleinbuchstaben (z. B. en, de, fr)
audienceModelId	string	Embedding-Modell-ID für die Zielgruppe — bei Unsicherheit den Standardwert unten verwenden

Standard-audienceModelId: 538b1efc6f88ad88feebf7acd8c618facb54fe82

Erlaubte Locale-Kombinationen

country und language müssen ein gültiges Paar bilden. Die API prüft dies serverseitig und gibt einen 400-Fehler zurück, wenn die Kombination nicht erlaubt ist. Unterstützte Paare:

country	Gültige language-Werte
us	en
gb	en
uk	en
de	de
at	de
ch	de, fr
fr	fr
es	es, ca
mx	es
it	it
nl	nl
pl	pl
pt	pt
br	pt
se	sv
tr	tr
hu	hu
hr	hr
cz	cs
cn	zh

Sichere Standardwerte: country: "us", language: "en" für englische Inhalte oder country: "de", language: "de" für deutsche Inhalte.

Beispiel: Import aus URL

curl -X POST "https://app.neuroflash.com/api/brand-voice-service/v1/workspaces/{workspace_id}/brand-voice-url-imports" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://ihre-marke.de",
    "country": "de",
    "language": "de",
    "audienceModelId": "538b1efc6f88ad88feebf7acd8c618facb54fe82"
  }'