Verfügbare Stimmen auflisten
Auf dieser Seite
Aktualisiert am 3. November 2026, basierend auf der xAI Voice API-Referenz und der Seite Text to Speech: Die Antwort auf
GET /v1/tts/voicesenthältvoice_id,nameundlanguage, und xAI bietet 28 integrierte Stimmen an. Quellen: Voice API · Text to Speech.
Stimmen programmatisch entdecken
Anstatt die Liste der Stimmen in Ihrer Anwendung fest zu codieren, stellt die xAI-API einen dedizierten Endpunkt bereit, um die verfügbaren Stimmen dynamisch abzurufen. Auf diese Weise bleiben Sie auf dem Laufenden, wenn neue Stimmen hinzugefügt werden.
GET /v1/tts/voices
Dieser Endpunkt gibt die Liste aller für TTS verfügbaren Stimmen zurück. Er benötigt keine Parameter im Anforderungsbody.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Die Antwort ist ein JSON-Objekt, das ein voices-Array enthält. Laut API-Referenz verfügt jede Stimme über drei Felder: voice_id, die kleingeschriebene ID, die Sie in Ihren Anforderungen übergeben; name, ein Anzeigename; und language, ein Sprachcode, der null sein kann.
Antwortstruktur
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Die Ellipsen stehen für Werte, die die Referenz nicht als Beispiele angibt: Drucken Sie die echte Antwort einmal aus, bevor Sie sich darauf verlassen. Der Ton und die Anwendungsfälle jeder Stimme finden sich nicht in dieser Antwort; sie werden auf der xAI-Text to Speech-Seite beschrieben.
GET /v1/tts/voices/{voice_id}
Um die Details einer bestimmten Stimme zu erhalten, fügen Sie ihre ID zum Pfad hinzu:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Dieser Aufruf gibt für die angeforderte Stimme nur die gleichen Felder (voice_id, name, language) zurück.
Die richtige Stimme auswählen
xAI bietet 28 integrierte Stimmen an (Stand 3. November 2026) und beschreibt für die meisten davon, wofür sie am besten geeignet sind. Hier einige Hinweise aus dieser Seite:
- Bildungsinhalte:
luna,cosmooderlumen, die für Bildung aufgeführt sind - Kundensupport:
carina,iris,rigel,celeste,castor,nakshoderaurora, die für Support aufgeführt sind - Werbung und Demos:
altair,zenith,perseus,kepleroderlumen, die für Werbung aufgeführt sind;eve, energisch und fröhlich, bleibt die Standardstimme - Erzählungen und Hörbücher:
orion,zagan,altair,perseusoderlux - Wohlbefinden:
carina,helios,luxoderliora
Die fünf ursprünglichen Stimmen (eve, ara, rex, sal, leo) haben keine aufgeführten Anwendungsfälle: xAI beschreibt sie lediglich als energisch und fröhlich (britischer Akzent), warm und freundlich, selbstbewusst und klar, sanft und ausgewogen sowie autoritär und kraftvoll (britischer Akzent).
Stimmenauswahl in Ihre Anwendung integrieren
Hier ist ein Beispiel, das die verfügbaren Stimmen dynamisch lädt:
import requests
def get_available_voices(api_key):
response = requests.get(
"https://api.x.ai/v1/tts/voices",
headers={"Authorization": f"Bearer {api_key}"}
)
response.raise_for_status()
return response.json()["voices"]
def synthesize(api_key, text, voice_id="eve", language="en"):
voices = get_available_voices(api_key)
valid_ids = [v["voice_id"] for v in voices]
if voice_id.lower() not in valid_ids:
raise ValueError(f"Unknown voice '{voice_id}'. Available: {valid_ids}")
response = requests.post(
"https://api.x.ai/v1/tts",
headers={"Authorization": f"Bearer {api_key}"},
json={"text": text, "voice_id": voice_id, "language": language}
)
return response.content
Dieser Ansatz schützt Sie vor Tippfehlern bei den Stimmen-IDs und ermöglicht es Ihnen, Ihren Nutzern eine aktuelle Liste anzubieten.
Best Practices
- Stimmenliste zwischenspeichern: Der Endpunkt
/v1/tts/voicesändert sich nicht oft, sodass ein Aufruf beim Start Ihrer Anwendung ausreicht - Vorschau anbieten: Lassen Sie Ihre Nutzer vor der Auswahl eine Probe jeder Stimme anhören
- Präferenz speichern: Sobald ein Nutzer eine Stimme ausgewählt hat, speichern Sie die Auswahl für zukünftige Sitzungen
- Im Zielsprachraum testen: Eine Stimme, die auf Englisch gut klingt, kann in einer anderen Sprache anders klingen. Testen Sie immer in der Sprache Ihrer Anwendung
Kernaussagen
GET /v1/tts/voiceslistet alle verfügbaren Stimmen mit ihren Metadaten aufGET /v1/tts/voices/{voice_id}gibt die Details einer bestimmten Stimme- 28 integrierte Stimmen sind verfügbar; ihr Ton und ihre Anwendungsfälle werden auf der xAI-Text to Speech-Seite beschrieben
- Die Antwort auf
GET /v1/tts/voicesgibt für jede Stimmevoice_id,nameundlanguage - Laden Sie Stimmen dynamisch, anstatt sie fest zu codieren