Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Freagairt fuaime agus praghsáil

Ceacht 4 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An fhreagairt a láimhseáil agus costais a choinneáil faoi smacht
  2. Anatamaíocht na freagartha HTTP
  3. Mapáil Codec go Content-Type
  4. Praghsáil go mion
  5. Fad na fuaime a mheas
  6. Príomhphointí

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/mpeg do MP3, audio/wav do WAV, audio/pcm do 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 iarradhContent-Type a fuarthasLeathnú comhaid
mp3audio/mpeg.mp3
wavaudio/wav.wav
pcmaudio/pcm.pcm
mulawaudio/basic.ul
alawaudio/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

ToirtCarachtairCostas 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 carachtar1,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