דילוג לתוכן

Grok Voice

שילוב

מזהה מודל 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"

עד ⁨‏1.494 ‏$⁩ להרצה החיוב מתבצע לפי השימוש בפועל, והיתרה מוחזרת הרצה בדף הזה

קבלת מפתח API
xAI אודיו #xai#grok#voice#agent

סוכן קולי שמאזין לקטע שמע מוקלט ומשיב בדיבור לצד תמליל

xAI · אודיו

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

0 / 20000

הוראות מערכת אופציונליות המספקות הקשר לשיחה ומגדירות פרסונה במקום ברירת המחדל של Grok; השמטתן משמרת את פרסונת ברירת המחדל.

•חובה audio_url
גרור קובץ, או

כתובת URL של אודיו לדיבור המשתמש, מוגבלת ל-10 דקות ול-50 MB. ניתן לספק את רוב פורמטי האודיו הנפוצים; לפני ש-Grok מקבל את האודיו, הוא מומר ל-mono PCM עם דגימות של 16-bit בקצב 24 kHz. הסוכן מגיב להקלטה בדיבור.

מתקדם voice · enable_safety_checker · tools

בחירת קול xAI מובנה שיחליף את ברירת המחדל של Grok לתגובת הסוכן; השארת השדה ללא ערך משמרת את קול ברירת המחדל.

ברירת מחדל {"mcp_servers":[],"we...

תצורת כלי הסוכן לשימוש בצד השרת, ללא file_search/collections מהתצורה המוקלדת בגלל ZDR. כל הכלים מתחילים כשהם מושבתים; האפשרויות הנתמכות כוללות כלי MCP מרוחקים, כלי אינטרנט וכלי X.

POST /run/xai/grok-voice?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.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"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Grok Voice

שלחו הקלטה דרך `audio_url` והסוכן משיב בשמע מדובר, המוחזר כ-WAV מונו בתדר 24 kHz לצד משכו ותמליל כאשר זמין. ‏`prompt` אופציונלי (עד 20000 תווים) מגדיר אישיות והקשר, ו-`voice` בוחר קול מובנה. האובייקט `tools` יכול להפעיל חיפוש באינטרנט, חיפוש ב-X או שרתי MCP מרוחקים; כולם מושבתים כברירת מחדל.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
audio_urlחובה audio
סוגurl · audio
כתובת URL של אודיו לדיבור המשתמש, מוגבלת ל-10 דקות ול-50 MB. ניתן לספק את רוב פורמטי האודיו הנפוצים; לפני ש-Grok מקבל את האודיו, הוא מומר ל-mono PCM עם דגימות של 16-bit בקצב 24 kHz. הסוכן מגיב להקלטה בדיבור.
promptאופציונלי
סוגstring | null
≤ 20,000 תווים
הוראות מערכת אופציונליות המספקות הקשר לשיחה ומגדירות פרסונה במקום ברירת המחדל של Grok; השמטתן משמרת את פרסונת ברירת המחדל.
voiceאופציונלי
סוגenum
carinazaganhelixorionlunairisaltairzenithperseusheliosluxkeplerrigelcosmocelesteursa
עוד 12siriuslumencastornakshatlasauroralioraaraeveleorexsal
בחירת קול xAI מובנה שיחליף את ברירת המחדל של Grok לתגובת הסוכן; השארת השדה ללא ערך משמרת את קול ברירת המחדל.
toolsאופציונלי
סוגobject
ברירת מחדל{"mcp_servers":[],"web_search":{"enabled":false},"x_search":{"enabled":false}}
תצורת כלי הסוכן לשימוש בצד השרת, ללא file_search/collections מהתצורה המוקלדת בגלל ZDR. כל הכלים מתחילים כשהם מושבתים; האפשרויות הנתמכות כוללות כלי MCP מרוחקים, כלי אינטרנט וכלי X.
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, אם הצד הקורא מורשה לכך.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

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"
  }
}
הקבצים שלכם, הבחירה שלכםכל 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/he/developers/models/xai/grok-voice.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt