تخطّي إلى المحتوى

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 الصوت، يُحوّل إلى PCM أحادي بقيم عينات 16 بت عند 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 الصوت، يُحوّل إلى 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. تبدأ جميع الأدوات معطلة؛ وتشمل الخيارات المدعومة أدوات 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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طول الصوت المُولّد، مقاساً بالثواني.

مزيد من النماذج: الصوت

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/xai/grok-voice.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt