Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Listaa käytettävissä olevat äänet

Oppitunti 3 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Tutustu ääniin ohjelmallisesti
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Valitse oikea ääni
  5. Sisällytä äänivalinta sovellukseesi
  6. Parhaat käytännöt
  7. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 xAI Voice API -viitteiden ja Text to Speech -sivun perusteella: vastaus pyyntöön GET /v1/tts/voices sisältää kentät voice_id, name ja language, 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, cosmo tai lumen, lueteltu opetuskäyttöön
  • Asiakastuki: carina, iris, rigel, celeste, castor, naksh tai aurora, lueteltu tukikäyttöön
  • Mainonta ja demot: altair, zenith, perseus, kepler tai lumen, lueteltu mainontaan; eve, energinen ja iloinen, on edelleen oletusääni
  • Kerronta ja äänikirjat: orion, zagan, altair, perseus tai lux
  • Hyvinvointi: carina, helios, lux tai liora

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/voices ei 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/voices listaa kaikki käytettävissä olevat äänet niiden metatietoineen
  • GET /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/voices antaa kullekin äänelle kentät voice_id, name ja language
  • Lataa äänet dynaamisesti äläkä kovakoodaa niitä