Neidio i'r cynnwys

Grok Voice

Integreiddio

ID y model xai/grok-voice
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-voice?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Hyd at $1.494 fesul rhediad codir tâl yn ôl y defnydd gwirioneddol, a chaiff y gweddill ei ad-dalu Ei redeg ar y dudalen hon

Cael allwedd API
xAI Sain #xai#grok#voice#agent

Asiant llais sy'n gwrando ar glip sain wedi'i recordio ac yn ateb â lleferydd ynghyd â thrawsgrifiad

xAI · Sain

Mae eich canlyniad cyntaf yn mynd yma

Adeiladwch gais isod a'i redeg gyda'ch allwedd API. Mae allbynnau'n cael eu copïo i'n storio, wedi'u cadw am byth neu am 7 diwrnod am ddim.

Adeiladu cais

Cynhyrchir rheolyddion o sgema'r model. Mae'r cod a'r pris yn diweddaru wrth i chi eu newid.

0 / 20000

Cyfarwyddiadau system dewisol sy'n darparu cyd-destun sgwrs ac yn pennu persona yn lle rhagosodiad Grok; mae eu hepgor yn cadw'r persona rhagosodedig hwnnw.

•gofynnol audio_url
Gollyngwch ffeil, neu

URL sain ar gyfer lleferydd y defnyddiwr, wedi'i gyfyngu i 10 munud a 50 MB. Gellir darparu'r fformatau sain mwyaf cyffredin; cyn i Grok dderbyn y sain, caiff ei throsi i PCM mono gyda samplau 16-did ar 24 kHz. Mae'r asiant yn ymateb i'r recordiad gyda lleferydd.

Uwch voice · enable_safety_checker · tools

Dewiswch lais xAI mewnol i ddiystyru rhagosodiad Grok ar gyfer ymateb yr asiant; mae gadael hwn heb ei osod yn cadw'r llais rhagosodedig hwnnw.

rhagosodedig {"mcp_servers":[],"we...

Cyfluniad offer asiant ar gyfer defnydd ochr y gweinydd, gan eithrio file_search/collections o'r cyfluniad wedi'i deipio oherwydd ZDR. Mae pob offeryn yn dechrau wedi'i analluogi; mae'r opsiynau a gefnogir yn cynnwys offer MCP pell, offer gwe ac offer X.

POST /run/xai/grok-voice?wait=20 dyfynbris → $1.494
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-voice?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Rhedeg y cais hwn

Mae'ch allwedd yn aros yn y porwr hwn: caiff ei hanfon at Doitong API yn unig a'i chadw (localStorage) dim ond os ticiwch Cofio. Cael allwedd API

Ynglŷn â Grok Voice

Anfonwch recordiad drwy `audio_url` ac mae'r asiant yn ateb mewn sain lafar, wedi'i dychwelyd fel WAV mono 24 kHz ynghyd â'i hyd a thrawsgrifiad pan fydd ar gael. Mae `prompt` dewisol (hyd at 20000 nod) yn gosod persona a chyd-destun, ac mae `voice` yn dewis llais mewnol. Gall gwrthrych `tools` alluogi chwilio'r we, chwilio X neu weinyddion MCP anghysbell, gyda phob un wedi'i ddiffodd yn ddiofyn.

Paramedrau

Anfonwch naill ai'r enw canonaidd neu'r enw brodorol, nid y ddau. Enwau canonaidd

EnwMath RhagosodedigCaniateir Disgrifiad
audio_urlgofynnol audio
Mathurl · audio
URL sain ar gyfer lleferydd y defnyddiwr, wedi'i gyfyngu i 10 munud a 50 MB. Gellir darparu'r fformatau sain mwyaf cyffredin; cyn i Grok dderbyn y sain, caiff ei throsi i PCM mono gyda samplau 16-did ar 24 kHz. Mae'r asiant yn ymateb i'r recordiad gyda lleferydd.
promptdewisol
Mathstring | null
≤ 20,000 nod
Cyfarwyddiadau system dewisol sy'n darparu cyd-destun sgwrs ac yn pennu persona yn lle rhagosodiad Grok; mae eu hepgor yn cadw'r persona rhagosodedig hwnnw.
voicedewisol
Mathenum
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
+12 yn rhagorsiriuslumencastornakshatlasauroralioraaraeveleorexsal
Dewiswch lais xAI mewnol i ddiystyru rhagosodiad Grok ar gyfer ymateb yr asiant; mae gadael hwn heb ei osod yn cadw'r llais rhagosodedig hwnnw.
toolsdewisol
Mathobject
Rhagosodedig{"mcp_servers":[],"web_search":{"enabled":false},"x_search":{"enabled":false}}
Cyfluniad offer asiant ar gyfer defnydd ochr y gweinydd, gan eithrio file_search/collections o'r cyfluniad wedi'i deipio oherwydd ZDR. Mae pob offeryn yn dechrau wedi'i analluogi; mae'r opsiynau a gefnogir yn cynnwys offer MCP pell, offer gwe ac offer X.
tools.mcp_serversdewisol
Mathobject[]
Gweinyddion MCP pell y mae darparwr y model yn cysylltu â nhw ar gyfer gweithredu offer.
tools.mcp_servers[].allowed_toolsdewisol
Mathstring[]
≥ 1 items
Rhestr ddewisol sy'n pennu pa enwau offer y mae'r gweinydd hwn yn eu datgelu.
tools.mcp_servers[].authorizationdewisol
Mathstring | null
Gwerth awdurdodi sensitif a anfonir yn gyfan gwbl at ddarparwr y model.
tools.mcp_servers[].enableddewisol
Mathboolean
Rhagosodedigtrue
Ban cynnwys gweinydd; mae false yn eithrio'r gweinydd.
tools.mcp_servers[].headersdewisol
Mathobject | null
Penawdau sensitif ar gyfer ceisiadau MCP, a anfonir yn gyfan gwbl at ddarparwr y model.
tools.mcp_servers[].server_descriptiondewisol
Mathstring | null
≤ 2000 characters
Disgrifiad sy'n amlinellu'r galluoedd y mae'r gweinydd hwn yn eu darparu.
tools.mcp_servers[].server_labelgofynnol
Mathstring
1 – 128 characters
Label gweinydd a ddefnyddir gan ddarparwr y model i adnabod ei offer ac i roi rhagddodiad i'w henwau.
tools.mcp_servers[].server_urlgofynnol
Mathstring
≥ 1 characters
Cyfeiriad HTTP(S) a ddarperir gan y galwr ar gyfer gweinydd MCP y mae Grok yn cysylltu ag ef o bell dros gludiant Streaming HTTP/SSE.
tools.web_search.allowed_domainsdewisol
Mathstring[]
1 – 5 items
Cyfyngiad parthau ar gyfer canlyniadau chwilio: nodwch hyd at bum parth, gan hepgor protocolau a llwybrau.
tools.web_search.enable_image_understandingdewisol
Mathboolean | null
Caniatâd i'r asiant archwilio delweddau a ddarganfuwyd drwy chwiliadau gwe.
tools.web_search.enableddewisol
Mathboolean
Rhagosodedigfalse
Mynediad chwilio gwe i'r asiant: mae true yn ychwanegu web_search at session.tools ac yn caniatáu chwiliadau gwe; mae'r rhagosodedig yn ei adael wedi'i analluogi.
tools.web_search.excluded_domainsdewisol
Mathstring[]
1 – 5 items
Parthau i'w heithrio o ganlyniadau chwilio, wedi'u cyfyngu i bum cofnod heb brotocolau a llwybrau.
tools.web_search.locationdewisol
Mathobject
Lleoliad dewisol ar gyfer teilwra canlyniadau chwilio yn ddaearyddol.
tools.x_search.allowed_x_handlesdewisol
Mathstring[]
1 – 20 items
Dolenni X y gall eu postiadau ymddangos yn y canlyniadau, wedi'u cyfyngu i 20 dolen.
tools.x_search.enable_image_understandingdewisol
Mathboolean | null
Caniatâd i'r asiant archwilio delweddau a ddarganfuwyd ar X.
tools.x_search.enable_video_understandingdewisol
Mathboolean | null
Caniatâd i'r asiant archwilio fideos a ddarganfuwyd ar X.
tools.x_search.enableddewisol
Mathboolean
Rhagosodedigfalse
Mynediad at bostiadau X drwy chwilio: mae true yn ychwanegu x_search at session.tools fel y gall yr asiant chwilio'r postiadau hynny; mae'r rhagosodedig yn ei adael wedi'i analluogi.
tools.x_search.excluded_x_handlesdewisol
Mathstring[]
1 – 20 items
Dolenni X y mae eu postiadau wedi'u heithrio, wedi'u cyfyngu i 20 dolen.
tools.x_search.from_datedewisol
Mathstring | null
Dyddiad cynharaf ar gyfer postiadau, wedi'i fynegi mewn fformat ISO YYYY-MM-DD.
tools.x_search.to_datedewisol
Mathstring | null
Dyddiad diweddaraf ar gyfer postiadau, wedi'i fynegi mewn fformat ISO YYYY-MM-DD.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Gellir llacio'r sgrinio drwy osod false, ar yr amod bod y galwr wedi'i awdurdodi.
gofynnol Enw canonaidd, derbyniol hefyd

Mae paramedrau ffeil yn derbyn URL cyhoeddus https://, URI data: hyd at 10 MB, neu file_url uwchlwythiad. Ffeiliau

Allbwn

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-voice",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1494,
    "usd": "1.494",
    "charged": 1494,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "text": "",
    "duration": 5
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Eich ffeiliau, eich dewisMae pob outputs[].url yn gopi ar ein storio: wedi'i gadw am byth (telir fesul GB-mis) neu am 7 diwrnod am ddim, yn ôl gosodiad eich cyfrif neu ?storage=.
Yr un siâp ar bob modeltype, url, content_type, width, height a duration, ar gyfer delweddau, fideo a sain fel ei gilydd. Gwrthrych canlyniad y model ei hun yw output.
Meysydd yr allbwn
audio
object {url, content_type, file_name, file_size}Ymateb llafar gan asiant Grok, wedi'i ddarparu fel WAV mono ar 24 kHz.
text
stringTestun sy'n cyd-fynd â lleferydd yr asiant: mae llinyn gwag yn dangos na ddarparodd Grok drawsgrifiad; fel arall, mae'n cynnwys y trawsgrifiad.
duration
numberHyd y sain a gynhyrchir, wedi'i fesur mewn eiliadau.

Mwy o fodelau: Sain

Ar gyfer asiantau AI: mae'r dudalen hon fel Markdown ar gael yn https://doitong.com/cy/developers/models/xai/grok-voice.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt