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

An pointe deiridh WebSocket agus an nasc fíor-ama

Ceacht 1 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An API Gníomhaire Gutha fíor-ama
  2. Oscail an nasc WebSocket
  3. Saolré an tseisiúin
  4. Príomhphointí

Nuashonraithe an 3 Samhain 2026, bunaithe ar leathanaigh Speech to Speech, Pricing, agus Rate limits de chuid xAI: $0.08 in aghaidh na nóiméide, seisiúin chomhthreomhara de réir céime, agus grok-voice-3.0 mar an tsamhail reatha. Foincí: Speech to Speech · Pricing · Rate limits.

An API Gníomhaire Gutha fíor-ama

Ligeann API Gníomhaire Gutha Grok duit gníomhairí gutha comhráite a thógáil a labhraíonn le d’úsáideoirí i bhfíor-am. Murab ionann agus APIanna REST clasaiceacha, a oibríonn ar bhonn iarratais ar iarratas, úsáideann an API seo an prótacal WebSocket chun nasc leanúnach dhá bhealach a choinneáil oscailte idir d’aip agus freastalaithe xAI.

Doiciméadú API Gníomhaire Gutha

Níl ach pointe deiridh amháin ann:

wss://api.x.ai/v1/realtime

Roghnaíonn tú an tsamhail leis an bparaiméadar URL model, mar shampla wss://api.x.ai/v1/realtime?model=grok-voice-latest. Tugann grok-voice-latest ar grok-voice-3.0, an tsamhail reatha, agus is é seo an réamhshocrú freisin. Sa táirgeadh, molann xAI leagan ainmnithe a phionnú.

Déanann an pointe deiridh seo láimhseáil ar shaolré iomlán comhrá gutha: fuaim a fháil, caint a bhrath, an freagra a ghiniúint, agus an fhuaim shintéiseach a sheoladh ar ais.

WebSocket
Prótacal fíor-ama
grok-voice-3.0
Samhail reatha
10
Seisiúin chomhthreomhara ar an gcéad tosaigh
$0.08/min
Praghas

Oscail an nasc WebSocket

Chun nasc a dhéanamh, cuir do eochair API xAI sa cheanntásc údaraithe. Seo sampla i JavaScript:

const ws = new WebSocket("wss://api.x.ai/v1/realtime", {
  headers: {
    "Authorization": "Bearer " + process.env.XAI_API_KEY
  }
});

ws.on("open", () => {
  console.log("WebSocket connection established");
});

ws.on("message", (data) => {
  const event = JSON.parse(data);
  console.log("Event received:", event.type);
});

ws.on("close", (code, reason) => {
  console.log("Connection closed:", code, reason);
});

ws.on("error", (err) => {
  console.error("WebSocket error:", err);
});

I bPython, is féidir leat an leabharlann websockets a úsáid:

import asyncio
import websockets
import json
import os

async def connect():
    uri = "wss://api.x.ai/v1/realtime"
    headers = {
        "Authorization": f"Bearer {os.environ['XAI_API_KEY']}"
    }

    async with websockets.connect(uri, additional_headers=headers) as ws:
        async for message in ws:
            event = json.loads(message)
            print(f"Event: {event['type']}")

asyncio.run(connect())

Saolré an tseisiúin

Chomh luath agus a osclaítear an nasc WebSocket, seolann an freastalaí imeacht session.created ag dearbhú go bhfuil an seisiún gníomhach. Ansin, seolann tú imeacht session.update chun an comhrá a chumrú (guth, treoracha, uirlisí, braiteadh casadh).

Seo mar a bhíonn an timthriall tipiciúil:

  1. Nasc: oscail an WebSocket le fíordheimhniú
  2. Cumraíocht: seol session.update le do shocruithe
  3. Deimhniú: faigh session.updated ón bhfreastalaí
  4. Comhrá: malartaigh imeachtaí fuaime agus téacs
  5. Dúnadh: dícheangail an WebSocket go glan

Láimhseáil earráidí nasctha

Is féidir leis an bhfreastalaí an nasc a dhúnadh nó a dhiúltú ar chúiseanna éagsúla: earráid fíordheimhnithe, sárú ar theorainn do chéime maidir le seisiúin chomhthreomhara (10 ar an gcéad tosaigh, suas le 200 ar an gcéim is airde), nó teagmhas. Ní shocraíonn an doiciméadú reatha uasmhéid faid seisiúin, agus ligeann athshumú seisiúin (ceacht 4) duit comhrá a thógáil arís tar éis titim. Ba chóir go mbeadh loighic athnascadh le cúlú easpónantúil san áireamh i d’aip.

Seiceáladh praghsanna an 3 Samhain 2026. Athraíonn praghsanna go minic: sula ndéanann tú aon bhuiséadú, seiceáil na rátaí reatha ar leathanach oifigiúil praghsanna xAI.

Príomhphointí

  • Is é an pointe deiridh WebSocket wss://api.x.ai/v1/realtime an t-aon iontráil do gach comhrá gutha
  • Déanann tú fíordheimhniú leis an gceanntásc Authorization: Bearer {eochair API}
  • Braitheann líon na seisiún comhthreomhar ar do chéim: 10 ar an gcéad tosaigh, suas le 200
  • Seolann an freastalaí session.created ar nascadh, ansin fanann sé le do session.update chun an comhrá a chumrú
  • Is é $0.08 in aghaidh na nóiméide an praghas, nó $4.80 in aghaidh na huaire, móide $0.004 in aghaidh gach ionchur téacs