Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Λίστα διαθέσιμων φωνών

Μάθημα 3 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ανακαλύψτε τις φωνές προγραμματιστικά
  2. GET /v1/tts/voices
  3. GET /v1/tts/voices/{voice_id}
  4. Επιλέξτε τη σωστή φωνή
  5. Ενσωματώστε την επιλογή φωνής στην εφαρμογή σας
  6. Βέλτιστες πρακτικές
  7. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026, με βάση την αναφορά του xAI Voice API και τη σελίδα Text to Speech: η απόκριση του GET /v1/tts/voices περιλαμβάνει τα πεδία voice_id, name και language, ενώ η xAI προσφέρει 28 ενσωματωμένες φωνές. Πηγές: Voice API · Text to Speech.

Ανακαλύψτε τις φωνές προγραμματιστικά

Αντί να κωδικοποιείτε στατικά τη λίστα των φωνών στην εφαρμογή σας, το API της xAI παρέχει ένα ειδικό endpoint για τη δυναμική ανάκτηση των διαθέσιμων φωνών. Με αυτόν τον τρόπο, παραμένετε ενημερωμένοι κάθε φορά που προστίθενται νέες φωνές.

GET /v1/tts/voices

Αυτό το endpoint επιστρέφει τη λίστα όλων των φωνών που είναι διαθέσιμες για TTS. Δεν απαιτεί παραμέτρους στο σώμα του αιτήματος.

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

Η απόκριση είναι ένα αντικείμενο JSON που περιέχει έναν πίνακα voices. Σύμφωνα με την αναφορά του API, κάθε φωνή διαθέτει τρία πεδία: voice_id, το αναγνωριστικό σε πεζά γράμματα που πρέπει να περάσετε στα αιτήματά σας· name, μια εμφανιζόμενη ονομασία· και language, έναν κωδικό γλώσσας που μπορεί να είναι null.

Δομή απόκρισης

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

Οι αποσιωπητικές τελείες αντιπροσωπεύουν τιμές για τις οποίες η αναφορά δεν παρέχει παραδείγματα: εκτυπώστε την πραγματική απόκριση μία φορά πριν βασιστείτε σε αυτήν. Ο τόνος και οι περιπτώσεις χρήσης κάθε φωνής δεν περιλαμβάνονται σε αυτήν την απόκριση· περιγράφονται στη σελίδα Text to Speech της xAI.

GET /v1/tts/voices/{voice_id}

Για να λάβετε τις λεπτομέρειες μιας συγκεκριμένης φωνής, προσθέστε το αναγνωριστικό της στη διαδρομή:

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

Αυτό το κάλεσμα επιστρέφει τα ίδια πεδία (voice_id, name, language) αποκλειστικά για τη ζητούμενη φωνή.

Επιλέξτε τη σωστή φωνή

Η xAI προσφέρει 28 ενσωματωμένες φωνές (στις 3 Νοεμβρίου 2026) και, για τις περισσότερες από αυτές, περιγράφει τις καταλληλότερες χρήσεις τους. Ορισμένες υποδείξεις από αυτήν τη σελίδα:

  • Εκπαιδευτικό περιεχόμενο: luna, cosmo ή lumen, που αναφέρονται για εκπαίδευση
  • Εξυπηρέτηση πελατών: carina, iris, rigel, celeste, castor, naksh ή aurora, που αναφέρονται για υποστήριξη
  • Διαφήμιση και επιδείξεις: altair, zenith, perseus, kepler ή lumen, που αναφέρονται για διαφήμιση· η eve, ενεργητική και αισιόδοξη, παραμένει η προεπιλεγμένη φωνή
  • Αφήγηση και audiobooks: orion, zagan, altair, perseus ή lux
  • Ευεξία: carina, helios, lux ή liora

Οι πέντε αρχικές φωνές (eve, ara, rex, sal, leo) δεν έχουν καταχωρημένες περιπτώσεις χρήσης: η xAI τις περιγράφει απλώς ως ενεργητικές και αισιόδοξες (βρετανική προφορά), ζεστές και φιλικές, αυτοπεποιθημένες και καθαρές, ομαλές και ισορροπημένες, καθώς και επιβλητικές και δυναμικές (βρετανική προφορά).

Ενσωματώστε την επιλογή φωνής στην εφαρμογή σας

Ακολουθεί ένα παράδειγμα που φορτώνει δυναμικά τις διαθέσιμες φωνές:

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

Αυτή η προσέγγιση σας προστατεύει από τυπογραφικά λάθη στα αναγνωριστικά φωνών και σας επιτρέπει να προσφέρετε στους χρήστες σας μια ενημερωμένη λίστα.

Βέλτιστες πρακτικές

  • Αποθηκεύστε προσωρινά τη λίστα φωνών: το endpoint /v1/tts/voices δεν αλλάζει συχνά, επομένως αρκεί ένα κάλεσμα κατά την εκκίνηση της εφαρμογής σας
  • Προσφέρετε προεπισκόπηση: επιτρέψτε στους χρήστες σας να ακούσουν ένα δείγμα κάθε φωνής πριν την επιλέξουν
  • Αποθηκεύστε την προτίμηση: μόλις ο χρήστης επιλέξει μια φωνή, αποθηκεύστε την επιλογή για μελλοντικές συνεδρίες
  • Δοκιμάστε στη γλώσσα στόχο: μια φωνή που ακούγεται εξαιρετική στα Αγγλικά μπορεί να ακούγεται διαφορετικά σε άλλη γλώσσα. Δοκιμάστε πάντα στη γλώσσα της εφαρμογής σας

Βασικά σημεία

  • Το GET /v1/tts/voices παραθέτει όλες τις διαθέσιμες φωνές με τα μεταδεδομένα τους
  • Το GET /v1/tts/voices/{voice_id} παρέχει τις λεπτομέρειες μιας συγκεκριμένης φωνής
  • Διατίθενται 28 ενσωματωμένες φωνές· ο τόνος και οι περιπτώσεις χρήσης τους περιγράφονται στη σελίδα Text to Speech της xAI
  • Η απόκριση του GET /v1/tts/voices παρέχει τα voice_id, name και language για κάθε φωνή
  • Φορτώνετε τις φωνές δυναμικά αντί να τις κωδικοποιείτε στατικά