DEV Community

Cover image for كيفية استخدام Grok 4.3 API؟
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

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

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

جرّب Apidog اليوم

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

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

ملخص سريع

  • Grok 4.3 متاح بشكل عام منذ 6 مايو 2026.
  • سيتم إيقاف ثمانية نماذج Grok قديمة في 15 مايو 2026.
  • التسعير:
    • 1.25 دولار لكل مليون رمز إدخال
    • 2.50 دولار لكل مليون رمز إخراج
    • 0.20 دولار لكل مليون رمز إدخال مخزّن مؤقتًا
  • نافذة السياق: 1,000,000 رمز.
  • يدعم إدخال الفيديو الأصلي.
  • يدعم التفكير المستمر عبر:
    • low
    • medium
    • high
  • الافتراضي هو medium.
  • نقطة النهاية: 
https://api.x.ai/v1/chat/completions
Enter fullscreen mode Exit fullscreen mode
  • عنوان URL الأساسي متوافق مع OpenAI.
  • الإنتاجية المعلنة: نحو 159 رمز/ثانية.
  • مؤشر الذكاء 53 وفق تحليل اصطناعي، والمرتبة العاشرة من بين 146 نموذجًا عالميًا.
  • يمكنك استخدام Apidog لحفظ الطلبات، تبديل إعدادات التفكير، وإعادة تشغيل نفس الاختبار عبر Grok وOpenAI.

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

أهم التغييرات العملية للمطورين:

1. سعر أقل

انخفض السعر بنحو 40% مقارنة بـ Grok 4.20:

  • الإدخال أقل بنحو 37.5%.
  • الإخراج أقل بنحو 58.3%.
  • الإدخال المخزّن مؤقتًا أصبح 0.20 دولار/مليون رمز.

هذا مهم إذا كانت لديك مطالبات نظام طويلة وثابتة أو وكلاء يعتمدون على سياق كبير.

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

ارتفع السياق من 256 ألف رمز في Grok 4.20 إلى مليون رمز. هذا يفتح حالات استخدام مثل:

  • مراجعة مستودع كود كبير.
  • تحليل عقد طويل.
  • إدخال سجل محادثات طويل.
  • تمرير مستندات تقنية كاملة داخل طلب واحد.

3. إدخال فيديو أصلي

Grok 4.3 هو أول نموذج في خط Grok يدعم إدخال الفيديو الأصلي. يمكنك تمرير رابط فيديو، وسيحلل النموذج الإطارات دون الحاجة إلى استخراجها يدويًا.

4. تفكير مستمر

كل طلب يمر بخطوة تفكير أساسية. يتحكم reasoning_effort في العمق، لكن النموذج لا يعمل بدون تفكير نهائيًا.

5. أداء أفضل للوكلاء

يحقق Grok 4.3 زيادة +300 Elo على GDPval-AA مقارنة بـ Grok 4.20. عمليًا، هذا يظهر في:

  • اختيار أدوات أفضل.
  • تقليل استدعاءات الأدوات غير الضرورية.
  • تحسن في تنفيذ المهام متعددة الخطوات.

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

قبل تنفيذ أول طلب، جهّز التالي:

  • حساب في xAI Console على: 
console.x.ai
Enter fullscreen mode Exit fullscreen mode
  • مفتاح API من فئة مدفوعة.
  • يفضل استخدام مفاتيح محددة النطاق حسب المشروع في الإنتاج.
  • OpenAI SDK أو xAI SDK.
  • عميل API مثل Apidog لتجربة الطلبات وتكرارها بسهولة.

صورة من xAI Console

صدّر مفتاح API في الطرفية:

export XAI_API_KEY="xai-..."
Enter fullscreen mode Exit fullscreen mode

وفي Python ستحتاج إلى قراءة المتغير البيئي:

import os
Enter fullscreen mode Exit fullscreen mode

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

يعمل Grok 4.3 عبر واجهة Chat Completions المتوافقة مع OpenAI.

POST https://api.x.ai/v1/chat/completions
Enter fullscreen mode Exit fullscreen mode

الرؤوس المطلوبة:

Authorization: Bearer $XAI_API_KEY
Content-Type: application/json
Enter fullscreen mode Exit fullscreen mode

بما أن الواجهة متوافقة مع OpenAI، يمكنك استخدام OpenAI SDK وتغيير base_url فقط.

مثال Python:

import os
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)
Enter fullscreen mode Exit fullscreen mode

إذا كنت تستخدم xAI SDK، فشكل الطلب مشابه؛ الفرق الأساسي يكون في الاستيراد وإعداد العميل.

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

المعامل النوع القيم الملاحظات
model string grok-4.3 مطلوب
messages array شكل رسائل OpenAI مطلوب. يدعم 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 أخذ عينات النواة
stream bool true / false تفعيل البث عبر Server-Sent Events
tools array شكل أدوات OpenAI لاستدعاء الوظائف
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"
  }'
Enter fullscreen mode Exit fullscreen mode

الرد يأتي بنفس شكل OpenAI تقريبًا:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 300,
    "reasoning_tokens": 80,
    "total_tokens": 500
  }
}
Enter fullscreen mode Exit fullscreen mode

اقرأ النص من:

response.choices[0].message.content
Enter fullscreen mode Exit fullscreen mode

وتابع التكلفة والتحليل من كائن usage.

اختيار جهد التفكير

يحتوي Grok 4.3 على ثلاثة مستويات:

low

استخدمه مع:

  • التصنيف.
  • التلخيص السريع.
  • استخراج الحقول.
  • الأسئلة والأجوبة البسيطة.

مثال:

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "user", "content": "Classify this support ticket as billing, bug, or feature request: ..."}
    ],
    reasoning_effort="low",
)
Enter fullscreen mode Exit fullscreen mode

medium

هذا هو الخيار الافتراضي. استخدمه مع:

  • خدمة العملاء.
  • تحليل بيانات متوسط.
  • استدعاء وظائف بسيط.
  • أدوات أحادية الخطوة. 
response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "user", "content": "Analyze this API error log and suggest likely causes: ..."}
    ],
    reasoning_effort="medium",
)
Enter fullscreen mode Exit fullscreen mode

high

استخدمه مع:

  • الوكلاء متعددَي الخطوات.
  • مراجعة كود طويلة.
  • التخطيط.
  • الرياضيات أو المنطق المعقد.
  • تحليل مستندات كبيرة. 
response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "user", "content": "Review this multi-service architecture and propose a migration plan: ..."}
    ],
    reasoning_effort="high",
)
Enter fullscreen mode Exit fullscreen mode

ملاحظة مهمة: حتى low يحتوي على تفكير أساسي. لذلك لا تتوقع إلغاء تكلفة التفكير بالكامل؛ يمكنك فقط تقليل العمق.

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

يدعم Grok 4.3 شكل أدوات OpenAI القياسي. المسار العملي هو:

  1. عرّف الأدوات في tools.
  2. أرسل الطلب.
  3. اقرأ tool_calls.
  4. نفّذ الوظيفة في تطبيقك.
  5. أعد نتيجة الأداة برسالة role: 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

print(tool_calls)
Enter fullscreen mode Exit fullscreen mode

مثال مبسط لمعالجة أول استدعاء:

import json

message = response.choices[0].message

if message.tool_calls:
    call = message.tool_calls[0]
    function_name = call.function.name
    arguments = json.loads(call.function.arguments)

    if function_name == "lookup_user":
        user_id = arguments["user_id"]

        # نفّذ الاستعلام في نظامك الحقيقي هنا
        result = {
            "user_id": user_id,
            "last_login": "2026-05-06T10:15:00Z"
        }

        followup = client.chat.completions.create(
            model="grok-4.3",
            messages=[
                {
                    "role": "user",
                    "content": "Find user u_42 and tell me their last login."
                },
                message,
                {
                    "role": "tool",
                    "tool_call_id": call.id,
                    "content": json.dumps(result)
                }
            ],
            tools=tools,
            reasoning_effort="medium",
        )

        print(followup.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

إذا كنت تختبر تدفقات أدوات أكثر تعقيدًا، راجع اختبار خادم MCP في Apidog.

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

Grok 4.3 يدعم إدخال الفيديو الأصلي. مرر رابط الفيديو داخل محتوى الرسالة:

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"
                    }
                }
            ],
        }
    ],
    reasoning_effort="medium",
)

print(response.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

نقاط مهمة عند استخدام الفيديو:

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

استخدام سياق المليون رمز

نافذة السياق الكبيرة مفيدة عندما تريد تقليل طبقة التجزئة والاسترجاع. أمثلة عملية:

مراجعة كود واسعة

اجمع:

  • الملفات التي تغيّرت.
  • ناتج git diff.
  • نتائج lint.
  • نتائج الاختبارات.
  • وصف المهمة.

ثم اطلب مراجعة مركزة:

راجع التغييرات التالية. ركّز على:
1. أخطاء التزامن
2. مشاكل الأداء
3. التغييرات التي قد تكسر التوافق الخلفي
4. الاختبارات الناقصة
Enter fullscreen mode Exit fullscreen mode

تحليل مستندات طويلة

يمكنك تمرير عقد طويل أو مواصفات تقنية كاملة، ثم طرح أسئلة محددة:

استخرج البنود المتعلقة بإنهاء الخدمة، المسؤولية، وملكية البيانات. أعد النتيجة كجدول JSON.
Enter fullscreen mode Exit fullscreen mode

ذاكرة محادثة طويلة

يمكنك الاحتفاظ بسجل محادثات أطول لوكيل دعم أو وكيل داخلي، ثم مطالبة النموذج بالاستمرار بناءً على السياق الكامل.

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

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

سيتم إيقاف ثمانية نماذج Grok قديمة في 15 مايو 2026، الساعة 12:00 ظهرًا بتوقيت المحيط الهادئ.

أبسط ترحيل:

- model="grok-4"
+ model="grok-4.3"
Enter fullscreen mode Exit fullscreen mode

أو:

- "model": "grok-3"
+ "model": "grok-4.3"
Enter fullscreen mode Exit fullscreen mode

معظم الطلبات تعمل دون تغييرات إضافية لأن شكل Chat Completions لم يتغير.

انتبه إلى نقطتين:

1. reasoning_effort

بعض النماذج القديمة لم تكن تقبل reasoning_effort. في Grok 4.3، التفكير دائم. إذا كان مسارك السابق يعتمد على زمن استجابة منخفض جدًا، ابدأ بـ:

{
  "reasoning_effort": "low"
}
Enter fullscreen mode Exit fullscreen mode

ثم قارن الدقة ووقت الاستجابة.

2. تنسيق الإخراج

Grok 4.3 أكثر تنظيمًا افتراضيًا من Grok 4.20. إذا كانت لديك معالجة لاحقة تعتمد على regex أو نص حر، أعد الاختبار قبل التبديل.

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

اختبار Grok 4.3 في Apidog

طريقة عملية لاختبار النموذج قبل إدخاله للإنتاج:

  1. أنشئ بيئة في Apidog.
  2. أضف المتغيرات: 
XAI_API_KEY = xai-...
BASE_URL = https://api.x.ai/v1
Enter fullscreen mode Exit fullscreen mode
  1. أنشئ طلبًا جديدًا: 
POST {{BASE_URL}}/chat/completions
Enter fullscreen mode Exit fullscreen mode
  1. أضف الرؤوس: 
Authorization: Bearer {{XAI_API_KEY}}
Content-Type: application/json
Enter fullscreen mode Exit fullscreen mode
  1. استخدم جسم الطلب: 
{
  "model": "grok-4.3",
  "messages": [
    {
      "role": "system",
      "content": "You are a senior backend engineer."
    },
    {
      "role": "user",
      "content": "Review this API design and identify risks."
    }
  ],
  "reasoning_effort": "medium"
}
Enter fullscreen mode Exit fullscreen mode
  1. انسخ الطلب ثلاث مرات وغيّر فقط: 
"reasoning_effort": "low"
Enter fullscreen mode Exit fullscreen mode

ثم:

"reasoning_effort": "medium"
Enter fullscreen mode Exit fullscreen mode

ثم:

"reasoning_effort": "high"
Enter fullscreen mode Exit fullscreen mode
  1. قارن:
  • جودة الإجابة.
  • زمن الاستجابة.
  • usage.reasoning_tokens.
  • usage.total_tokens.

يمكنك أيضًا إنشاء بيئة ثانية لـ OpenAI وتغيير BASE_URL وmodel فقط للمقارنة على نفس المطالبة.

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

واجهة Apidog

حدود المعدل

تختلف حدود المعدل حسب الطبقة في xAI Console. تبدأ من بضعة آلاف من الطلبات في الدقيقة في الطبقات الأساسية، وتصل إلى مئات الآلاف في الطبقات المؤسسية.

تحقق دائمًا من لوحة التحكم لأن الأرقام قد تتغير.

معدل 159 رمز/ثانية يشير إلى سرعة إخراج لكل تدفق، وليس إجمالي الحساب. الطلبات المتزامنة تتوسع ضمن حدود طبقتك.

عند تجاوز الحد، تتوقع استجابة:

429 Too Many Requests
Enter fullscreen mode Exit fullscreen mode

مع رأس:

retry-after
Enter fullscreen mode Exit fullscreen mode

تعامل معها بتراجع أسي:

import time
import random

def backoff_sleep(attempt):
    delay = min(60, (2 ** attempt) + random.random())
    time.sleep(delay)
Enter fullscreen mode Exit fullscreen mode

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

هل Grok 4.3 متوافق مع OpenAI؟

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

هل يدعم Responses API؟

واجهة xAI الحالية هي Chat Completions. Responses API خاص بـ OpenAI.

ما الحد الفعلي للسياق؟

الحد هو 1,000,000 رمز. لكنه ليس مجانيًا؛ المدخلات الطويلة تكلّف مالًا حتى مع السعر الأقل. استخدم التخزين المؤقت عندما تكون المطالبة ثابتة.

كيف يؤثر التفكير المستمر على وقت الاستجابة؟

وقت أول رمز قد يكون أعلى قليلًا من النماذج غير التفكيرية. لكن 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 إدخال الصور؟

نعم، بالإضافة إلى إدخال الفيديو. مرر رابط الصورة داخل كتلة محتوى بنفس شكل OpenAI.

الخلاصة

Grok 4.3 تحديث مهم من xAI للمطورين الذين يبنون وكلاء أو تطبيقات تعتمد على سياق طويل. أهم ما تحصل عليه: سعر أقل، سياق مليون رمز، تفكير مستمر، إدخال فيديو أصلي، وتوافق عملي مع OpenAI SDK.

أسرع مسار للتحقق: أنشئ ثلاثة طلبات في Apidog بقيم low وmedium وhigh، شغّل نفس المطالبات الحقيقية، ثم قارن زمن الاستجابة ورموز التفكير وجودة الإجابة. إذا كنت تستخدم نماذج Grok قديمة، رحّل قبل 15 مايو.

Top comments (0)