שפּרינגען צו אינהאַלט

Grok Voice · Realtime

אינטעגרירן

מאָדעל־id xai/grok-voice/realtime
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-voice/realtime?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ביז ⁨$ 1.494⁩ פּער לויפן באַצאָלט לויטן בפועלדיקן באַניץ, דער רעשט ווערט צוריקגעצאָלט לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
xAI אַודיאָ #xai#grok#voice#agent

רעאַל־טײַם־וועריאַנט פֿון דעם Grok קול־אַגענט פֿאַר סטרימינג און ביידירעקטיאָנעלע אַודיאָ־ און טעקסט־שמועסן

xAI · אַודיאָ

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

0 / 20000

אָפּציאָנאַלע סיסטעם־אנווײַזונגען וואָס צושטעלן שמועס־קאָנטעקסט און ספּעציפֿיצירן אַ פּערסאָנאַ אַנשטאָט פון Grok'ס סטאַנדאַרט; אָפּלאָזן זיי האַלט דעם סטאַנדאַרט־פּערסאָנאַ.

•פארלאנגט audio_url
לייגט אַרײַן אַ טעקע, אָדער

אַודיאָ־URL פֿאַרן באַניצערס רעדע, באַגרענעצט צו 10 מינוט און 50 MB. מע קען צושטעלן די מערסט געוויינטלעכע אַודיאָ־פֿאָרמאַטן; איידער Grok באַקומט די אַודיאָ, ווערט זי קאָנווערטירט צו מאָנאָ PCM מיט 16־ביט סאַמפּלס ביי 24 kHz. דער אַגענט ענטפֿערט אויף דער רעקאָרדירונג מיט רעדע.

פֿאָרגעשריטן voice · enable_safety_checker · tools

אויסקלײַבן אַן אינגעבויטע xAI קול צו איבערשרײַבן Grok'ס סטאַנדאַרט פֿאַר דעם אַגענט'ס ענטפֿער; אָן באַשטעטיקן דעם בלײַבט דער סטאַנדאַרט־קול.

סטאַנדאַרט {"mcp_servers":[],"we...

אַגענט־געצייג־קאָנפֿיגוראַציע פֿאַר סערווער־זײַטיקן באַניץ, אויסשליסנדיק file_search/collections פון דער טיפּיזירטער קאָנפֿיגוראַציע צוליב ZDR. אַלע געצייג אָנהייבן אויסגעלאָשן; געשטיצטע אָפּציעס אַרײַננעמען remote MCP tools, web tools און X tools.

POST /run/xai/grok-voice/realtime?wait=20 פּרײַז → ⁨$ 1.494⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-voice/realtime?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Grok Voice · Realtime

אַ קול־אַגענט פֿאַר לייוו־אַפּליקאַציעס ווי אַסיסטענטן און טעלעפֿאָן־אַגענטן, געבויט אַרום סטרימינג פֿון אַודיאָ און טעקסט אין ביידע ריכטונגען. די אַרייַנגעבער שטימען מיטן נאָרמאַלן קול־מאָדעל: `audio_url` פֿאַר דעם באַניצערס רייד, אַן אָפּציאָנאַלער `prompt` פֿאַר פּערזענלעכקייט־אנווײַזונגען, אַ `voice`־ברירה און אָפּציאָנאַלע `tools` פֿאַר וועב־, X־ אָדער MCP־צוטריט. עס גיט צוריק גערעדט WAV־אַודיאָ, זײַן געדויער און אַ טראַנסקריפּט.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
audio_urlפארלאנגט audio
טיפּurl · audio
אַודיאָ־URL פֿאַרן באַניצערס רעדע, באַגרענעצט צו 10 מינוט און 50 MB. מע קען צושטעלן די מערסט געוויינטלעכע אַודיאָ־פֿאָרמאַטן; איידער Grok באַקומט די אַודיאָ, ווערט זי קאָנווערטירט צו מאָנאָ PCM מיט 16־ביט סאַמפּלס ביי 24 kHz. דער אַגענט ענטפֿערט אויף דער רעקאָרדירונג מיט רעדע.
promptאָפּציאָנעל
טיפּstring | null
≤ 20,000 כאַראַקטערן
אָפּציאָנאַלע סיסטעם־אנווײַזונגען וואָס צושטעלן שמועס־קאָנטעקסט און ספּעציפֿיצירן אַ פּערסאָנאַ אַנשטאָט פון Grok'ס סטאַנדאַרט; אָפּלאָזן זיי האַלט דעם סטאַנדאַרט־פּערסאָנאַ.
voiceאָפּציאָנעל
טיפּenum
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
+12 נאָךsiriuslumencastornakshatlasauroralioraaraeveleorexsal
אויסקלײַבן אַן אינגעבויטע xAI קול צו איבערשרײַבן Grok'ס סטאַנדאַרט פֿאַר דעם אַגענט'ס ענטפֿער; אָן באַשטעטיקן דעם בלײַבט דער סטאַנדאַרט־קול.
toolsאָפּציאָנעל
טיפּobject
סטאַנדאַרט{"mcp_servers":[],"web_search":{"enabled":false},"x_search":{"enabled":false}}
אַגענט־געצייג־קאָנפֿיגוראַציע פֿאַר סערווער־זײַטיקן באַניץ, אויסשליסנדיק file_search/collections פון דער טיפּיזירטער קאָנפֿיגוראַציע צוליב ZDR. אַלע געצייג אָנהייבן אויסגעלאָשן; געשטיצטע אָפּציעס אַרײַננעמען remote MCP tools, web tools און X tools.
tools.mcp_serversאָפּציאָנעל
טיפּobject[]
רימאָוט MCP סערווערס צו וועלכע דער מאָדעל־פּראָווײַדער פֿאַרבינדט זיך פֿאַר דורכפֿירן געצייג־אָפּעראַציעס.
tools.mcp_servers[].allowed_toolsאָפּציאָנעל
טיפּstring[]
≥ 1 items
אָפּציאָנאַלע רשימה וואָס ספּעציפֿיצירט וועלכע געצייג־נעמען דער סערווער אַנטפּלעקט.
tools.mcp_servers[].authorizationאָפּציאָנעל
טיפּstring | null
סענסיטיווע אָטעריזאַציע־ווערט געשיקט אויסשליסלעך צום מאָדעל־פּראָווײַדער.
tools.mcp_servers[].enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סערווער־אַרײַננעמונג־פֿאָן; false שליסט דעם סערווער אויס.
tools.mcp_servers[].headersאָפּציאָנעל
טיפּobject | null
סענסיטיווע העדערס פֿאַר MCP בקשות, געשיקט אויסשליסלעך צום מאָדעל־פּראָווײַדער.
tools.mcp_servers[].server_descriptionאָפּציאָנעל
טיפּstring | null
≤ 2000 characters
באַשרײַבונג וואָס צייכנט אויס די מעגלעכקייטן וואָס דער סערווער מאַכט צוטריטלעך.
tools.mcp_servers[].server_labelפארלאנגט
טיפּstring
1 – 128 characters
סערווער־לאַבעל געניצט דורך דעם מאָדעל־פּראָווײַדער צו אידענטיפֿיצירן זײַנע געצייג און צולייגן אַ פּרעפֿיקס צו זייערע נעמען.
tools.mcp_servers[].server_urlפארלאנגט
טיפּstring
≥ 1 characters
HTTP(S) אַדרעס צוגעשטעלט דורך דעם רופֿער פֿאַר אַן MCP סערווער צו וועלכן Grok פֿאַרבינדט זיך רימאָוט דורך Streaming HTTP/SSE טראַנספּאָרטן.
tools.web_search.allowed_domainsאָפּציאָנעל
טיפּstring[]
1 – 5 items
דאָמיין־באַגרענעצונג פֿאַר זוך־רעזולטאַטן: ספּעציפֿיצירן ביז פֿינף דאָמיינס אָן פּראָטאָקאָלן און פּאַטס.
tools.web_search.enable_image_understandingאָפּציאָנעל
טיפּboolean | null
דערלויבעניש פֿאַרן אַגענט צו באַטראַכטן בילדער אַנטדעקט דורך וועב־זוכן.
tools.web_search.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
וועב־זוך־צוטריט פֿאַרן אַגענט: true לייגט web_search צו session.tools און דערלויבט וועב־זוכן; דער סטאַנדאַרט לאָזט עס אויסגעלאָשן.
tools.web_search.excluded_domainsאָפּציאָנעל
טיפּstring[]
1 – 5 items
דאָמיינס צו אויסשליסן פון זוך־רעזולטאַטן, באַגרענעצט צו פֿינף איינטראָגן אָן פּראָטאָקאָלן און פּאַטס.
tools.web_search.locationאָפּציאָנעל
טיפּobject
אָפּציאָנאַלע אָרט פֿאַר געאָגראַפֿישער צופּאַסונג פון זוך־רעזולטאַטן.
tools.x_search.allowed_x_handlesאָפּציאָנעל
טיפּstring[]
1 – 20 items
X האַנדלעס וועמענס פּאָסטס קענען זיך באַווײַזן אין די רעזולטאַטן, באַגרענעצט צו 20 האַנדלעס.
tools.x_search.enable_image_understandingאָפּציאָנעל
טיפּboolean | null
דערלויבעניש פֿאַרן אַגענט צו באַטראַכטן בילדער אַנטדעקט אויף X.
tools.x_search.enable_video_understandingאָפּציאָנעל
טיפּboolean | null
דערלויבעניש פֿאַרן אַגענט צו באַטראַכטן ווידעאָס אַנטדעקט אויף X.
tools.x_search.enabledאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צוטריט צו X פּאָסטס דורך זוכן: true לייגט x_search צו session.tools, כּדי דער אַגענט זאָל קענען זוכן די פּאָסטס; דער סטאַנדאַרט לאָזט עס אויסגעלאָשן.
tools.x_search.excluded_x_handlesאָפּציאָנעל
טיפּstring[]
1 – 20 items
X האַנדלעס וועמענס פּאָסטס ווערן אויסגעשלאָסן, באַגרענעצט צו 20 האַנדלעס.
tools.x_search.from_dateאָפּציאָנעל
טיפּstring | null
פריסטע דאַטע פֿאַר פּאָסטס, אויסגעדריקט אין ISO פֿאָרמאַט YYYY-MM-DD.
tools.x_search.to_dateאָפּציאָנעל
טיפּstring | null
לעצטע דאַטע פֿאַר פּאָסטס, אויסגעדריקט אין ISO פֿאָרמאַט YYYY-MM-DD.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-voice/realtime",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
audio
object {url, content_type, file_name, file_size}גערעדטע ענטפער פֿונעם Grok אַגענט, איבערגעגעבן ווי מאָנאָ WAV ביי 24 kHz.
text
stringטעקסט וואָס באַגלייט דעם אַגענטס רעדע: אַן ליידיקע שטריקל מיינט, אַז Grok האָט נישט צוגעשטעלט קיין טראַנסקריפּט; אַנדערש אַנטהאַלט עס דעם טראַנסקריפּט.
duration
numberלענג פֿונעם גענערירטן אַודיאָ, געמאסטן אין סעקונדעס.

מער מאָדעלן: אַודיאָ

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/xai/grok-voice/realtime.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt