Λίστα διαθέσιμων φωνών
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 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για κάθε φωνή - Φορτώνετε τις φωνές δυναμικά αντί να τις κωδικοποιείτε στατικά