Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Liste over tilgængelige stemmer

Lektion 3 af 14 Opdateret 3. november 2026 Udvikler
På denne side
  1. Opdag stemmer programmatisk
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Vælg den rigtige stemme
  5. Indbyg valg af stemme i din app
  6. Bedste praksis
  7. Vigtige pointer

Opdateret 3. november 2026 baseret på xAI Voice API-referencen og siden Text to Speech: Svaret fra GET /v1/tts/voices indeholder voice_id, name og language, og xAI tilbyder 28 indbyggede stemmer. Kilder: Voice API · Text to Speech.

Opdag stemmer programmatisk

I stedet for at hardkode listen over stemmer i din app, tilbyder xAI API’en et dedikeret endpoint til dynamisk at hente de tilgængelige stemmer. På den måde holder du dig opdateret, når nye stemmer tilføjes.

GET /v1/tts/voices

Dette endpoint returnerer listen over alle stemmer, der er tilgængelige til TTS. Det kræver ingen parametre i request-bodyen.

curl -X GET "https://api.x.ai/v1/tts/voices" \
  -H "Authorization: Bearer $XAI_API_KEY"

Svaret er et JSON-objekt, der indeholder et voices-array. Ifølge API-referencen har hver stemme tre felter: voice_id, det lille ID, du skal sende i dine requests; name, et visningsnavn; og language, en sprogkode, der kan være null.

Responsens struktur

{
  "voices": [
    {"voice_id": "eve", "name": "…", "language": "…"},
    {"voice_id": "ara", "name": "…", "language": "…"}
  ]
}

Ellipserne står for værdier, som referencen ikke giver som eksempler: Udprint det faktiske svar én gang, før du baserer din logik på det. Hver stemmes tone og anvendelsesområder fremgår ikke af dette svar; de er beskrevet på xAI-siden Text to Speech.

GET /v1/tts/voices/{voice_id}

For at hente detaljer om en specifik stemme skal du tilføje dens ID til stien:

curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
  -H "Authorization: Bearer $XAI_API_KEY"

Dette kald returnerer de samme felter (voice_id, name, language) kun for den anmodede stemme.

Vælg den rigtige stemme

xAI tilbyder 28 indbyggede stemmer (pr. 3. november 2026), og for de fleste af dem beskrives det, hvad de egner sig bedst til. Her er nogle pointer fra den side:

  • Uddannelsesindhold: luna, cosmo eller lumen, listet under uddannelse
  • Kundesupport: carina, iris, rigel, celeste, castor, naksh eller aurora, listet under support
  • Reklame og demoer: altair, zenith, perseus, kepler eller lumen, listet under reklame; eve, der er energisk og munter, forbliver standardstemmen
  • Oplæsning og lydbøger: orion, zagan, altair, perseus eller lux
  • Trivsel: carina, helios, lux eller liora

De fem oprindelige stemmer (eve, ara, rex, sal, leo) har ingen listede anvendelsesområder: xAI beskriver dem blot som energiske og muntre (britisk accent), varme og venlige, selvsikre og klare, glatte og afbalancerede samt autoritative og kraftfulde (britisk accent).

Indbyg valg af stemme i din app

Her er et eksempel, der indlæser de tilgængelige stemmer dynamisk:

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

Denne tilgang beskytter dig mod tastefejl i stemme-ID’er og giver dig mulighed for at tilbyde dine brugere en opdateret liste.

Bedste praksis

  • Cacheliste over stemmer: Endpointet /v1/tts/voices ændrer sig ikke ofte, så ét kald, når din app starter, er nok
  • Tilbyd forhåndsvisning: Lad dine brugere lytte til en prøve af hver stemme, før de vælger
  • Gem præferencen: Når en bruger har valgt en stemme, så gem valget til fremtidige sessioner
  • Test på målsproget: En stemme, der lyder fantastisk på engelsk, kan lyde anderledes på et andet sprog. Test altid på dit apps sprog

Vigtige pointer

  • GET /v1/tts/voices lister alle tilgængelige stemmer med deres metadata
  • GET /v1/tts/voices/{voice_id} giver detaljer om en specifik stemme
  • Der er 28 indbyggede stemmer tilgængelige; deres tone og anvendelsesområder er beskrevet på xAI-siden Text to Speech
  • Svaret fra GET /v1/tts/voices giver voice_id, name og language for hver stemme
  • Indlæs stemmer dynamisk i stedet for at hardkode dem