Listaa käytettävissä olevat äänet
Tällä sivulla
Päivitetty 3. marraskuuta 2026 xAI Voice API -viitteiden ja Text to Speech -sivun perusteella: vastaus pyyntöön
GET /v1/tts/voicessisältää kentätvoice_id,namejalanguage, ja xAI tarjoaa 28 sisäänrakennettua ääntä. Lähteet: Voice API · Text to Speech.
Tutustu ääniin ohjelmallisesti
Älä kovakoodaa äänilistaa sovellukseesi. xAI-API tarjoaa erillisen päätepisteen käytettävissä olevien äänien dynaamiseen hakemiseen. Näin pysyt ajan tasalla, kun uusia ääniä lisätään.
GET /v1/tts/voices
Tämä päätepiste palauttaa listan kaikista TTS-käyttöön saatavilla olevista äänistä. Se ei vaadi parametreja pyynnön rungossa.
curl -X GET "https://api.x.ai/v1/tts/voices" \
-H "Authorization: Bearer $XAI_API_KEY"
Vastaus on JSON-objekti, joka sisältää voices-taulukon. API-viitteiden mukaan jokaisella äänellä on kolme kenttää: voice_id (pienikirjaiminen tunniste, joka välitetään pyyntöihisi), name (näyttönimi) ja language (kielikoodi, joka voi olla null).
Vastauksen rakenne
{
"voices": [
{"voice_id": "eve", "name": "…", "language": "…"},
{"voice_id": "ara", "name": "…", "language": "…"}
]
}
Pisteet korvaavat arvot, joita viitteet eivät anna esimerkkeinä: tulosta todellinen vastaus kerran ennen kuin luotat siihen. Kunkin äänen sävy ja käyttötarkoitukset eivät sisälly tähän vastaukseen; ne on kuvattu xAI:n Text to Speech -sivulla.
GET /v1/tts/voices/{voice_id}
Saadaksesi tietyn äänen yksityiskohdat, lisää sen tunniste polkuun:
curl -X GET "https://api.x.ai/v1/tts/voices/rex" \
-H "Authorization: Bearer $XAI_API_KEY"
Tämä kutsu palauttaa samat kentät (voice_id, name, language) vain pyydetylle äänelle.
Valitse oikea ääni
xAI tarjoaa 28 sisäänrakennettua ääntä (tilanne 3. marraskuuta 2026) ja kuvaa useimmille niille parhaiten sopivat käyttötarkoitukset. Muutama ohje kyseiseltä sivulta:
- Opetussisältö:
luna,cosmotailumen, lueteltu opetuskäyttöön - Asiakastuki:
carina,iris,rigel,celeste,castor,nakshtaiaurora, lueteltu tukikäyttöön - Mainonta ja demot:
altair,zenith,perseus,keplertailumen, lueteltu mainontaan;eve, energinen ja iloinen, on edelleen oletusääni - Kerronta ja äänikirjat:
orion,zagan,altair,perseustailux - Hyvinvointi:
carina,helios,luxtailiora
Viidellä alkuperäisellä äänellä (eve, ara, rex, sal, leo) ei ole lueteltuja käyttötarkoituksia: xAI kuvaa niitä vain termein energinen ja iloinen (brittiaksentti), lämmin ja ystävällinen, itsevarma ja selkeä, sujuva ja tasapainoinen sekä auktoriteettinen ja voimakas (brittiaksentti).
Sisällytä äänivalinta sovellukseesi
Tässä on esimerkki, joka lataa käytettävissä olevat äänet dynaamisesti:
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
Tämä lähestymistapa suojaa sinua äänitunnisteiden kirjoitusvirheiltä ja antaa sinun tarjota käyttäjillesi ajantasaisen listan.
Parhaat käytännöt
- Välimuistioi äänilista: päätepiste
/v1/tts/voicesei muutu usein, joten yksi kutsu sovelluksen käynnistyessä riittää - Tarjoa esikuuntelu: anna käyttäjiesi kuunnella näyte jokaisesta äänestä ennen valintaa
- Tallenna asetus: kun käyttäjä on valinnut äänen, tallenna valinta tulevia istuntoja varten
- Testi kohdekielellä: ääni, joka kuulostaa hyvältä englanniksi, voi kuulostaa erilaiselta toisella kielellä. Testi aina sovelluksesi kielellä
Keskeiset asiat
GET /v1/tts/voiceslistaa kaikki käytettävissä olevat äänet niiden metatietoineenGET /v1/tts/voices/{voice_id}antaa tietyn äänen yksityiskohdat- Käytettävissä on 28 sisäänrakennettua ääntä; niiden sävy ja käyttötarkoitukset on kuvattu xAI:n Text to Speech -sivulla
- Vastaus pyyntöön
GET /v1/tts/voicesantaa kullekin äänelle kentätvoice_id,namejalanguage - Lataa äänet dynaamisesti äläkä kovakoodaa niitä