Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Verfügbare Stimmen auflisten

Lektion 3 von 14 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Stimmen programmatisch entdecken
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Die richtige Stimme auswählen
  5. Stimmenauswahl in Ihre Anwendung integrieren
  6. Best Practices
  7. Kernaussagen

Aktualisiert am 3. November 2026, basierend auf der xAI Voice API-Referenz und der Seite Text to Speech: Die Antwort auf GET /v1/tts/voices enthält voice_id, name und language, 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, cosmo oder lumen, die für Bildung aufgeführt sind
  • Kundensupport: carina, iris, rigel, celeste, castor, naksh oder aurora, die für Support aufgeführt sind
  • Werbung und Demos: altair, zenith, perseus, kepler oder lumen, die für Werbung aufgeführt sind; eve, energisch und fröhlich, bleibt die Standardstimme
  • Erzählungen und Hörbücher: orion, zagan, altair, perseus oder lux
  • Wohlbefinden: carina, helios, lux oder liora

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/voices listet alle verfügbaren Stimmen mit ihren Metadaten auf
  • GET /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/voices gibt für jede Stimme voice_id, name und language
  • Laden Sie Stimmen dynamisch, anstatt sie fest zu codieren