Freagairt fuaime agus praghsáil
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026, bunaithe ar leathanaigh Pricing, Rate limits, agus Text to Speech ó xAI. Foinse: Pricing · Rate limits · Text to Speech.
An fhreagairt a láimhseáil agus costais a choinneáil faoi smacht
Nuair a éiríonn leis an API TTS, seolann sé sruth beart fuaime go díreach i gcorp an iarratais HTTP. Tá sé ríthábhachtach a bheith ar an eolas faoin gcaoi a láimhseálann tú an fhreagairt sin agus na costais a thuar chun TTS a rith i dtimpeallacht táirgeachta.
Anatamaíocht na freagartha HTTP
Tá stádas 200 ag an bhfreagairt, agus níl sa chorp ach bearta fuaime. Níl aon chlúdach JSON ann. Seo iad na ceanntáisc HTTP tábhachtacha:
Content-Type: formáid na fuaime (audio/mpegdo MP3,audio/wavdo WAV,audio/pcmdo PCM)Content-Length: méid an chomhaid fuaime i mbearta
response = requests.post("https://api.x.ai/v1/tts", ...)
# Check for success
if response.status_code == 200:
content_type = response.headers["Content-Type"]
audio_size = len(response.content)
print(f"Format: {content_type}, Size: {audio_size} bytes")
Scríobh chuig comhad
Is é an cur chuige is simplí ná an fhreagairt a scríobh go díreach chuig comhad:
with open("output.mp3", "wb") as f:
f.write(response.content)
Sruthú na freagartha
I gcás comhaid mhóra, déan sruthú ar an bhfreagairt ionas nach lódáilfidh tú an fhuaim iomlán isteach sa chuimhne:
response = requests.post(
"https://api.x.ai/v1/tts",
headers={"Authorization": f"Bearer {api_key}"},
json={"text": long_text, "voice_id": "eve", "language": "en"},
stream=True
)
with open("output.mp3", "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
Seinm go díreach sa bhrabhsálaí
I JavaScript taobh an chliaint (tar éis an fhuaim a athsheoladh trí do chúldeireadh), is féidir leat eilimint fuaime a chruthú ar an toirt:
const audioBlob = new Blob([audioBuffer], { type: "audio/mpeg" });
const audioUrl = URL.createObjectURL(audioBlob);
const audio = new Audio(audioUrl);
audio.play();
Cuimhnigh an URL Blob a scaoileadh tar éis na seinmne chun sceitheadh cuimhne a sheachaint (pléitear é seo go mion sa cheacht táirgeachta).
Mapáil Codec go Content-Type
| Codec a iarradh | Content-Type a fuarthas | Leathnú comhaid |
|---|---|---|
mp3 | audio/mpeg | .mp3 |
wav | audio/wav | .wav |
pcm | audio/pcm | .pcm |
mulaw | audio/basic | .ul |
alaw | audio/alaw | .al |
Praghsáil go mion
Costaíonn TTS $15 in aghaidh an mhilliún carachtar (praghsáil xAI ón 3 Samhain 2026). Gearrtar táille ort as ábhar an réimse text de réir mar a sheolann tú é, clúdaithe na clibeanna sloinne.
Meastacháin costais
| Toirt | Carachtair | Costas measta |
|---|---|---|
| 1 abairt | ~100 | $0.0015 |
| 1 mír | ~500 | $0.0075 |
| 1 leathanach clóite | ~2,000 | $0.03 |
| 1 alt blag | ~5,000 | $0.075 |
| 1 leabhar (200 lch) | ~400,000 | $6 |
| 1 milliún carachtar | 1,000,000 | $15 |
Clibeanna agus billeáil
Áirítear clibeanna sloinne ar nós [pause], <whisper>, agus <loud> sa líon carachtar iomlán. Billeáiltear téacs 1,000 carachtar le 50 carachtar de chlibeanna mar 1,050 carachtar. De ghnáth, is lú ná 5% den téacs iomlán é sin.
Teorainneacha comhthreomhaireachta
De réir leathanach Rate limits xAI, glacann TTS le 50 iarratas in aghaidh an tsoicind agus 100 seisiún comhthreomhar ar an leibhéal iontrála, teorainneacha a fhásann le leibhéal do fhoirne (suas go 500 agus 500). Luann an leathanach Text to Speech freisin 50 seisiún WebSocket comhthreomhar in aghaidh na foirne. Thairis sin, filleann an API earráid 429: do thoirt mhór, cuir spás idir d’iarratais nó úsáid ciú.
Fad na fuaime a mheas
Braitheann fad na fuaime ginte ar an téacs, ar an nguth, agus ar an socruithe speed. Mar mheastachán garbh, ritheann caint léite ag thart ar 150 focal in aghaidh an nóiméid, nó thart ar 850 carachtar in aghaidh an nóiméid i mBéarla: déan tomhas leis do ghuth féin sula ngeallann tú fad áirithe. Chun figiúr cruinn a fháil, filleann with_timestamps fad na fuaime (duration) in éineacht leis na stampaí ama.
Ag an luas sin, cruthaíonn téacs 60,000 carachtar, an teorainn d’iarratas amháin, beagán os cionn uair an chloig fuaime.
Príomhphointí
- Is sruth dénártha, seachas JSON, í freagairt an TTS
- Inseoidh an Content-Type duit cén formáid fuaime a fuair tú
- Déan sruthú ar chomhaid mhóra
- Costas $15 in aghaidh an mhilliún carachtar, clibeanna san áireamh
- Ar an leibhéal iontrála: 50 iarratas in aghaidh an tsoicind agus 100 seisiún comhthreomhar
- Cruthaíonn iarratas 60,000 carachtar thart ar uair an chloig fuaime