كيفية استخدام Grok 4.3 API؟

طرحت xAI نموذج Grok 4.3 على مراحل: النسخة التجريبية في 17 أبريل 2026، ثم إتاحة واجهة برمجة التطبيقات (API) في 30 أبريل، والتوافر العام الكامل في 6 مايو. الملخص مباشر: نافذة سياق بحجم 1,000,000 رمز، إدخال فيديو أصلي لأول مرة على خط Grok، تفكير مستمر، وتخفيض في السعر بنسبة 40% تقريبًا مقارنة بـ Grok 4.20. سيتم إيقاف ثمانية نماذج Grok قديمة في 15 مايو، لذا يجب على أي شخص يعمل على سلسلة grok-3 أو grok-4 التخطيط لترحيل بياناته هذا الأسبوع.

يشرح هذا الدليل كيفية استدعاء Grok 4.3 من التعليمات البرمجية الخاصة بك: شكل نقطة النهاية، والمصادقة، وعنوان URL الأساسي المتوافق مع OpenAI، ومعامل جهد التفكير، وإدخال الفيديو، واستدعاء الوظائف، وإعداد اختبار عملي في Apidog.

للاطلاع على الجانب الصوتي من نفس الإصدار، راجع كيفية استخدام Grok Voice مجانًا. وللمقارنة المباشرة مع نموذج OpenAI الصوتي الرائد، راجع Grok Voice vs GPT-Realtime.

زر

ملخص سريع (TL;DR)

Grok 4.3 أصبح متاحًا بشكل عام في 6 مايو 2026. سيتم إيقاف ثمانية نماذج قديمة في 15 مايو 2026.
التسعير: 1.25 دولار لكل مليون رمز إدخال، 2.50 دولار لكل مليون رمز إخراج، الإدخال المخزّن مؤقتًا 0.20 دولار لكل مليون. تخفيض حوالي 40% مقارنة بـ Grok 4.20.
نافذة سياق بحجم مليون رمز. إدخال فيديو أصلي. تفكير مستمر.
جهد التفكير: low / medium / high. الافتراضي هو medium.
نقطة النهاية: https://api.x.ai/v1/chat/completions (عنوان URL أساسي متوافق مع OpenAI).
الإنتاجية: ~159 رمز/ثانية على المستويات القياسية.
مؤشر الذكاء 53 (تحليل اصطناعي)، ويحتل المرتبة العاشرة من بين 146 نموذجًا عالميًا.
استخدم Apidog لبرمجة الطلب، والاحتفاظ بتكوينات التفكير كمتغيرات، وإعادة التشغيل عبر وضعَي التوافق مع Grok وOpenAI.

ما الذي تغير في Grok 4.3

الترقيات الرئيسية، حسب ترتيب التأثير على معظم الفرق:

انخفاض الأسعار بنسبة 40%. انخفض الإدخال بنسبة 37.5% مقارنة بـ Grok 4.20؛ وانخفض الإخراج بنسبة 58.3%. أصبح سعر الإدخال المخزّن مؤقتًا الآن 0.20 دولار/مليون، وهو تخفيض كبير يجعل المطالبات النظامية الطويلة المستقرة أرخص بكثير.
سياق بحجم مليون رمز. بزيادة عن 256 ألف رمز في Grok 4.20. يكفي لاستيعاب قاعدة بيانات متوسطة الحجم، أو مكالمة أرباح كاملة، أو عقد قانوني كامل في مطالبة واحدة.
إدخال فيديو أصلي. لأول مرة في خط Grok. مرر عنوان URL للفيديو ويقوم النموذج بالتفكير في الإطارات بشكل أصلي.
تفكير مستمر. يأتي Grok 4.3 مزودًا بخطوة تفكير أساسية في كل طلب. يعمل معامل reasoning_effort على قياس العمق، لكن النموذج لا يفكر أبدًا بأقل من low.
مكسب كبير في قدرات الوكلاء. +300 نقطة Elo على GDPval-AA مقابل Grok 4.20. أصبح إرسال الأدوات وسير العمل متعدد الخطوات يتصرف بشكل أفضل بشكل ملحوظ.

يضع مؤشر الذكاء البالغ 53 (تحليل اصطناعي) Grok 4.3 فوق المتوسط البالغ 35 لفئته السعرية، والعاشر من أصل 146 نموذجًا تم تتبعها.

المتطلبات الأساسية

قبل الطلب الأول، قم بتجهيز أربعة أشياء:

حساب xAI Console على console.x.ai. نفس سير تسجيل الدخول الخاص بـ Grok Voice.
فئة مدفوعة مع مفتاح API. يوصى بمفاتيح ذات نطاق مشروع للإنتاج.
OpenAI SDK (Grok 4.3 متوافق مع OpenAI) أو xAI SDK. كلاهما يعمل.
عميل API يمكنه إعادة تشغيل الطلبات دون إغراق محطتك الطرفية.

قم بتصدير المفتاح مرة واحدة:

export XAI_API_KEY="xai-..."

نقطة النهاية والمصادقة

يعمل Grok 4.3 على واجهة Chat Completions المتوافقة مع OpenAI، مع عنوان URL الأساسي الخاص بـ xAI.

POST https://api.x.ai/v1/chat/completions

المصادقة هي رمز مميز للحامل (bearer token). الرؤوس قياسية:

Authorization: Bearer $XAI_API_KEY
Content-Type: application/json

يعني التوافق مع OpenAI أنه يمكنك تضمين OpenAI Python أو Node SDK وتغيير base_url. هذا هو المسار الأسهل لمعظم الفرق التي تنتقل من gpt-4 أو gpt-5.

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "user", "content": "Summarize the trade-offs of GraphQL vs REST in three bullets."}
    ],
    reasoning_effort="medium",
)

print(response.choices[0].message.content)

إذا كنت تفضل xAI SDK، فإن شكل الاستدعاء هو نفسه؛ التغيير الوحيد هو الاستيراد.

معاملات الطلب

خريطة المعاملات الكاملة لـ Grok 4.3:

المعامل (Parameter)	النوع (Type)	القيم (Values)	الملاحظات (Notes)
`model`	سلسلة نصية (string)	`grok-4.3`	مطلوب.
`messages`	مصفوفة (array)	شكل رسالة OpenAI	مطلوب. يدعم `role: system / user / assistant`.
`reasoning_effort`	سلسلة نصية (string)	`low`, `medium`, `high`	اختياري. الافتراضي: `medium`. المستويات الأعلى تزيد من وقت الاستجابة ورموز الإخراج.
`max_tokens`	عدد صحيح (int)	1–32768	يحدد حدًا للإخراج.
`temperature`	رقم عشري (float)	0.0–2.0	الافتراضي 1.0.
`top_p`	رقم عشري (float)	0.0–1.0	أخذ عينات النواة (Nucleus sampling).
`stream`	منطقي (bool)	true / false	أحداث مرسلة من الخادم عندما يكون true.
`tools`	مصفوفة (array)	شكل أداة OpenAI	استدعاء الوظائف (Function calling).
`tool_choice`	سلسلة نصية / كائن (string / object)	`auto`, `none`, أو أداة محددة	دلالات OpenAI القياسية.
`response_format`	كائن (object)	`{ type: "json_object" }`	إخراج منظم.
`seed`	عدد صحيح (int)	أي قيمة	للتكرارية عند `temperature: 0`.

طلب curl يعمل:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "messages": [
      {"role": "system", "content": "You are a senior backend engineer."},
      {"role": "user", "content": "Review this query plan and flag the bottleneck."}
    ],
    "reasoning_effort": "high"
  }'

يحمل الرد شكل OpenAI القياسي: choices[].message.content، بالإضافة إلى كائن usage مع تفاصيل prompt_tokens، وcompletion_tokens، وreasoning_tokens، وtotal_tokens.

جهد التفكير

ثلاثة مستويات، مع توجيهات ملموسة:

low (منخفض). استخدمه للتصنيف، والتلخيص، واستخراج القواعد، والأسئلة والأجوبة البسيطة. وقت الاستجابة قصير، والإخراج مباشر.
medium (متوسط). الافتراضي. استخدمه لخدمة العملاء، واستدعاء الوظائف، وتحليل البيانات، واستخدام الأدوات أحادي الخطوة. عمق التفكير كافٍ لمعظم حركة المرور الإنتاجية.
high (مرتفع). استخدمه للوكلاء متعددي الخطوات، ومراجعة التعليمات البرمجية طويلة السلسلة، والرياضيات المعقدة، والمهام التي يتطلب فيها النموذج التخطيط قبل الإجابة.

يعني التفكير المستمر أن حتى المستوى low يقوم ببعض التفكير؛ وهذا ما يدفع زيادة الدقة الواقعية مقارنة بـ Grok 4.20. لا تتوقع توفير المال بتجنب التفكير تمامًا؛ فهو جزء لا يتجزأ.

استدعاء الوظائف

يعمل شكل OpenAI القياسي مباشرةً. قم بالإعلان عن الأدوات، ويقوم النموذج بإصدار مصفوفة tool_calls على رسالة المساعد، ثم تقوم بالتنفيذ، وترد برسالة دور tool:

tools = [{
    "type": "function",
    "function": {
        "name": "lookup_user",
        "description": "Look up a user by ID.",
        "parameters": {
            "type": "object",
            "properties": {"user_id": {"type": "string"}},
            "required": ["user_id"],
        },
    },
}]

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Find user u_42 and tell me their last login."}],
    tools=tools,
    reasoning_effort="medium",
)

tool_calls = response.choices[0].message.tool_calls

يظهر مكسب 300 Elo على GDPval-AA هنا في الممارسة العملية؛ يختار Grok 4.3 أدوات أفضل، وعدد أقل من الاستدعاءات الزائدة، ويتعافى من خطأ في الأداة دون تعثر. إذا كنت تختبر تدفقات الأدوات، فإن اختبار خادم MCP في Apidog يغطي إعداد إعادة التشغيل الذي نستخدمه داخليًا.

إدخال الفيديو

Grok 4.3 هو أول نموذج Grok يدعم إدخال الفيديو الأصلي. قم بتمرير عنوان URL للفيديو داخل كتلة محتوى:

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe what happens in this clip and flag any anomalies."},
            {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}},
        ],
    }],
)

تحتسب رموز الفيديو ضمن عداد الإدخال. المقاطع الطويلة تستهلك السياق بسرعة؛ قم بتقليل العينات أو تقليمها قبل الإرسال إذا كانت التكلفة مهمة. يقوم النموذج بالتفكير في الإطارات بشكل أصلي، لذلك لا تحتاج إلى استخراج الإطارات الرئيسية يدويًا.

سياق بحجم مليون رمز

نافذة السياق بحجم مليون رمز هي أداة إنتاج حقيقية، وليست مجرد إنجاز قياسي. الأنماط الشائعة:

مراجعة التعليمات البرمجية لقاعدة بيانات كاملة. قم بتجميع الفروقات وجميع الملفات التي تم لمسها ومخرجات فحص الكود (lint). اطلب من Grok مراجعتها.
الأسئلة والأجوبة حول المستندات طويلة الأمد. قم بإسقاط عقد من 200 صفحة واسأل أسئلة محددة.
ذاكرة المحادثة. احتفظ بشهر كامل من محادثات الوكيل في السياق للتخصيص.

الإدخال المخزّن مؤقتًا بسعر 0.20 دولار/مليون يجعل هذا ميسور التكلفة. مطالبة نظام بحجم 400 ألف رمز تحافظ عليها مستقرة تكلف 0.08 دولار لكل استدعاء مخزّن مؤقتًا بدلاً من 0.50 دولار لطلب جديد.

الترحيل من نماذج Grok القديمة

سيتم إيقاف ثمانية نماذج Grok قديمة في 15 مايو 2026، الساعة 12:00 ظهرًا بتوقيت المحيط الهادئ. إذا كنت تستخدم أيًا منها، فاستبدل سلسلة model بـ grok-4.3 قبل الموعد النهائي. تعمل معظم الاستدعاءات دون تغيير إضافي لأن شكل الطلب لم يتغير.

أمران يجب الانتباه إليهما:

جهد التفكير. بعض النماذج القديمة لم تقبل reasoning_effort. Grok 4.3 يفكر دائمًا؛ إذا كانت التعليمات البرمجية السابقة تعتمد على مسار سريع غير تفكيري، فاقبل زيادة وقت الاستجابة أو ابق على low.
تنسيق الإخراج. Grok 4.3 أكثر تنظيمًا من Grok 4.20 افتراضيًا. إذا كنت تستخدم معالجة لاحقة مكثفة بالتعابير العادية (regex)، أعد الاختبار قبل التبديل.

للاطلاع على مقارنة الأسعار الكاملة عبر خط OpenAI، راجع تسعير GPT-5.5؛ ولنماذج التفكير المباشرة، راجع كيفية استخدام واجهة برمجة تطبيقات GPT-5.5.

الاختبار في Apidog

أسرع طريقة للتحقق من Grok 4.3 مقابل حالة استخدامك الخاصة:

أنشئ بيئة Apidog باستخدام XAI_API_KEY و BASE_URL = https://api.x.ai/v1.
احفظ مجموعة طلبات بثلاثة متغيرات: تفكير low وmedium وhigh. نفس المطالبة، بجهد مختلف.
شغل الثلاثة. قارن الاستجابة، ووقت الاستجابة، وعدد usage.reasoning_tokens جنبًا إلى جنب.
أضف متغيرًا رابعًا يشير إلى عنوان URL الأساسي لـ OpenAI لمقارنة Grok 4.3 بـ GPT-5.5 على نفس الإدخال. نفس SDK، نموذج وعنوان URL أساسي مختلف.

حمل Apidog لتشغيل المقارنة. المجموعة تنتقل بسلاسة عند تبديل المزودين، وهذا هو بيت القصيد. لاستراتيجية اختبار API أوسع، راجع أداة اختبار API لمهندسي ضمان الجودة.

حدود المعدل

تتراوح حدود الطبقات على وحدة تحكم xAI من خط أساسي يبلغ بضعة آلاف من الطلبات في الدقيقة على الطبقة 1 إلى مئات الآلاف على الطبقات المؤسسية. تتغير الأرقام الملموسة؛ تحقق من لوحة تحكم وحدة التحكم. يبلغ معدل نقل البيانات البالغ 159 رمزًا/ثانية الذي تعلن عنه xAI سرعة إخراج لكل تدفق، وليس إجماليًا؛ تتوسع الطلبات المتزامنة خطيًا ضمن حدود الطبقة.

إذا وصلت إلى حدود المعدل، تعيد واجهة برمجة التطبيقات 429 مع رأس retry-after. يتم التعامل معها بواسطة التراجع الأسي القياسي.

الأسئلة الشائعة

هل Grok 4.3 متوافق مع OpenAI من البداية إلى النهاية؟بالنسبة لـ Chat Completions، نعم. قم بإسقاط OpenAI SDK، قم بتغيير base_url، قم بتغيير model. يعمل استدعاء الوظائف، والإخراج المنظم، والبث كلها بشكل متطابق.

هل يدعم Responses API؟واجهة xAI هي Chat Completions اليوم. Responses API خاص بـ OpenAI فقط.

ما هو الحد الفعلي للسياق في الممارسة العملية؟1,000,000 رمز. تكلف المدخلات الطويلة أموالاً حقيقية حتى بسعر 1.25 دولار/مليون؛ قم بالتخزين المؤقت بقوة إذا كانت المطالبة لديك مستقرة.

كيف يؤثر التفكير المستمر على وقت الاستجابة؟وقت استجابة الرمز الأول أعلى قليلاً من النماذج غير التفكيرية، ولكن Grok 4.3 يبث الإخراج بسرعة ~159 رمزًا/ثانية، لذا فإن وقت الاستجابة من البداية إلى النهاية تنافسي. المقايضة تستحق العناء في أعباء العمل الحساسة للدقة.

هل يمكنني استخدام Grok 4.3 مع Grok Voice؟نعم. يقوم وكيل الصوت (grok-voice-think-fast-1.0) باستدعاء Grok 4.3 في الخلفية عندما يفكر. يمكنك أيضًا استدعاء Grok 4.3 مباشرةً من حلقة صوتية تقوم بإنشائها على أساسيات TTS و STT.

ماذا يحدث لاستدعاءاتي القديمة لـ Grok 3 / Grok 4 بعد 15 مايو؟ستفشل مع 410 (النموذج متقاعد). قم بالترحيل قبل الموعد النهائي.

هل يدعم Grok 4.3 إدخال الصور؟نعم، بالإضافة إلى إدخال الفيديو الجديد. مرر عنوان URL للصورة في كتلة محتوى، بنفس شكل OpenAI.

الخلاصة

Grok 4.3 هو التحرك الأكثر جرأة من xAI في مجال السعر مقابل الأداء. التخفيض بنسبة 40%، وسياق المليون رمز، والتفكير المستمر، والفيديو الأصلي، كلها تجعله أداة يومية جديرة بالثقة لمعظم أعباء عمل الوكلاء. توافق OpenAI يعني أن الترحيل هو تغيير في عنوان URL الأساسي، وليس إعادة كتابة.

أسرع مسار للتحقق: قم ببرمجة ثلاثة أنواع مختلفة من التفكير في Apidog، وقم بإسقاط مطالباتك الحقيقية، وقم بقياس وقت الاستجابة ورموز التفكير. قم بالترحيل قبل 15 مايو.

زر