DEV Community

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

Posted on • Originally published at apidog.com

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

Grok 4.5 انطلق في 8 يوليو 2026، وأسرع طريقة لتجربته هي عبر API. معرف النموذج هو grok-4.5، والتسعير هو 2 دولار لكل مليون رمز إدخال و6 دولارات لكل مليون رمز إخراج، ونافذة السياق 500 ألف رمز. يضع إعلان xAI النموذج للبرمجة، والمهام الوكيلية، وأعمال المعرفة بقدرات “من فئة أوبوس” على حد تعبير ماسك.

جرّب Apidog اليوم

يركز هذا الدليل على التنفيذ: إنشاء مفتاح API، إرسال أول طلب، الاختيار بين grok-4.5 وgrok-4.3، ثم اختبار نقطة النهاية في Apidog قبل استخدامها في الإنتاج.

ملاحظة توفر: Grok 4.5 غير متاح بعد في الاتحاد الأوروبي، سواء في المنتجات أو في وحدة تحكم API. تتوقع xAI إتاحة الوصول في الاتحاد الأوروبي بحلول منتصف يوليو 2026.

Grok 4.5

الخطوة 1: الحصول على مفتاح API من xAI

  1. انتقل إلى وحدة تحكم xAI وسجّل الدخول.
  2. افتح قسم مفاتيح API.
  3. أنشئ مفتاحًا جديدًا.
  4. خزّنه كمتغير بيئة، ولا تضعه مباشرة داخل الكود:
export XAI_API_KEY="xai-..."
Enter fullscreen mode Exit fullscreen mode

تلقت بعض حسابات وحدة التحكم الجديدة أرصدة تجريبية في الماضي، مع تقارير تتراوح بين 25 و150 دولارًا. لا تعتمد على رقم ثابت؛ تحقق من صفحة الفواتير في حسابك. إذا أردت الاستكشاف دون أرصدة، راجع كيفية استخدام Grok 4.5 مجانًا.

xAI Console

الخطوة 2: إرسال أول طلب إلى Grok 4.5

تستخدم البداية السريعة الرسمية من xAI نقطة نهاية Responses. أرسل طلبًا مباشرًا باستخدام curl:

curl -s https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Find and fix the bug, then explain it: function median(a){a.sort();return a[a.length/2]}"
  }'
Enter fullscreen mode Exit fullscreen mode

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

  • معرف النموذج يحتوي على نقطة: استخدم grok-4.5. استخدام grok-4-5 يؤدي إلى خطأ مثل “النموذج غير موجود”.
  • نقطة Responses تستخدم input: لا تستخدم مصفوفة messages هنا. إذا كنت تريد ترحيل كود موجود متوافق مع OpenAI، استخدم مسار Chat Completions بدلًا من ذلك.

استخدام حزمة OpenAI SDK مع xAI

تحافظ xAI على توافق مع مكتبات عميل OpenAI. غالبًا ما يكون التغيير الأساسي هو ضبط base_url إلى https://api.x.ai/v1. هذا هو نفس النمط الذي شرحناه في دليل API الخاص بـ Grok 4.3:

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.5",
    messages=[
        {"role": "system", "content": "You are a code review assistant."},
        {"role": "user", "content": "Review this handler for race conditions: ..."},
    ],
)

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

راجع وثائق xAI لمعرفة المعلمات الحالية. تتغير ميزات مثل استدعاء الأدوات والمخرجات المنظمة بسرعة في الأسابيع الأولى بعد الإطلاق.

تفعيل التدفق Streaming

للتطبيقات التفاعلية مثل أدوات البرمجة أو واجهات الدردشة، فعّل التدفق واستهلك الأحداث تدريجيًا:

stream = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "user", "content": "Refactor this function step by step: ..."}
    ],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)
Enter fullscreen mode Exit fullscreen mode

يقدم Grok 4.5 حوالي 80 رمزًا في الثانية، وهي سرعة عالية للنماذج، لذلك تبدو الاستجابات المتدفقة مناسبة حتى مع المخرجات الطويلة.

الخطوة 3: اختيار النموذج الصحيح

تبيع xAI الآن نموذجين رئيسيين للدردشة، والاختيار بينهما يعتمد على نوع المهمة:

المعيار grok-4.5 grok-4.3
نافذة السياق 500 ألف رمز مليون رمز
الإدخال / الإخراج لكل مليون 2.00 دولار / 6.00 دولارات 1.25 دولار / 2.50 دولار
خصم الدفعة غير مدرج خصم 20%
السرعة ~80 رمز في الثانية أبطأ حسب تحديد xAI
نقاط القوة البرمجة الوكيلية، كفاءة الرمز العمل بسياق طويل، السعر

النموذج الجديد أغلى ويحمل نصف نافذة السياق، لكنه يقدم قدرة وكفاءة أعلى في بعض مهام البرمجة. في SWE Bench Pro، يحل Grok 4.5 المهام بمتوسط 15,954 رمز إخراج، أي أقل بنحو 4.2 مرة من Claude Opus 4.8، حسب نفس المعيار. بالنسبة لحلقات الوكيل، تعني رموز الإخراج الأقل تكلفة أقل وزمن انتظار أقصر.

قاعدة عملية:

  • استخدم grok-4.3 مع RAG، وتحليل المستندات الطويلة، والمهام التي تحتاج سياقًا ضخمًا.
  • استخدم grok-4.5 مع البرمجة متعددة الخطوات، الوكلاء، واستدعاء الأدوات.

للحساب الكامل للتكلفة، راجع شرح تسعير Grok 4.5.

إذا كنت تفضل التوجيه عبر مجمع للموثوقية أو الفوترة الموحدة، فإن Grok 4.5 مدرج أيضًا على OpenRouter. شرحنا هذا النمط في كيفية استخدام نماذج Grok عبر OpenRouter.

الخطوة 4: اختبار نقطة النهاية في Apidog

قبل استخدام Grok 4.5 في الإنتاج، اختبر الطلبات والاستجابات والتدفق في بيئة منظمة. يمكنك تنفيذ ذلك في Apidog:

اختبار Grok 4.5 في Apidog

  1. أنشئ طلبًا جديدًا إلى:
   POST https://api.x.ai/v1/responses
Enter fullscreen mode Exit fullscreen mode

أو استخدم مسار Chat Completions إذا كنت تعتمد على السطح المتوافق مع OpenAI.

  1. أضف الترويسات:
   Authorization: Bearer {{XAI_API_KEY}}
   Content-Type: application/json
Enter fullscreen mode Exit fullscreen mode
  1. خزّن المفتاح كمتغير بيئة داخل Apidog بدلًا من وضعه داخل الطلب مباشرة. هذا يمنع تسريب Bearer token عند مشاركة المجموعة مع الفريق.

  2. أرسل الطلب وافحص الاستجابة. يدعم Apidog عرض تدفقات SSE عند وصولها، ما يساعدك على التأكد من أن التدفق يبدأ وينتهي بشكل صحيح.

  3. أضف Assertions على الحقول المهمة، مثل:

    • اسم النموذج في الاستجابة.
    • سبب الانتهاء.
    • عدد رموز الإدخال.
    • عدد رموز الإخراج.
    • إجمالي الاستخدام.
  4. نفّذ مقارنة A/B بين النموذجين. انسخ الطلب نفسه، وغيّر:

   "model": "grok-4.5"
Enter fullscreen mode Exit fullscreen mode

إلى:

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

ثم قارن الجودة، زمن الاستجابة، واستهلاك الرموز على مطالباتك الحقيقية بدل الاعتماد فقط على متوسطات المعايير.

  1. أنشئ Mock Server. استخدم مخطط الاستجابة لإنشاء خادم وهمي، حتى يتمكن فريق الواجهة الأمامية وضمان الجودة من العمل على شكل استجابة مستقر أثناء ضبط المطالبات، دون استهلاك أرصدة xAI في تطوير الواجهة.

كائن الاستخدام usage مهم جدًا هنا. ميزة Grok 4.5 الأساسية هي كفاءة الرمز، لذلك راقب output_tokens لكل مهمة. إذا كانت مطالباتك تنتج مخرجات طويلة جدًا، فقد تتقلص ميزة التكلفة.

يمكنك تنزيل Apidog مجانًا إذا أردت تطبيق سير العمل السابق؛ يعمل هذا المسار على الخطة المجانية.

التكاليف، الحدود، والمزالق

  • التسعير: 2 دولار لكل مليون رمز إدخال، و6 دولارات لكل مليون رمز إخراج.
  • أدوات البحث على الويب وX: تُحاسب بشكل منفصل بسعر 5 دولارات لكل 1000 مكالمة.
  • المعالجة ذات الأولوية: تعمل بضعف المعدلات القياسية.
  • الإدخال المخزن مؤقتًا: تشير مصادر ثانوية إلى معدل 0.50 دولار لكل مليون رمز إدخال مخزن مؤقتًا، لكن لا صفحة الإصدار ولا صفحة تسعير الوثائق تؤكد ذلك اعتبارًا من 9 يوليو. تحقق من وحدة التحكم قبل بناء نموذج تكلفة يعتمد على التخزين المؤقت.
  • لا يوجد خصم دفعات مدرج لـ grok-4.5، على عكس grok-4.3.
  • الاتحاد الأوروبي: محظور حتى منتصف يوليو 2026. تفشل الطلبات من الحسابات المفوترة في الاتحاد الأوروبي على مستوى وحدة التحكم، لذلك قد يظهر الأمر كمشكلة وصول وليس كرمز خطأ API واضح.
  • حدود المعدل: تعتمد على مستوى الحساب. لا تزال أنماط مستويات حدود معدل Grok السابقة مفيدة: تحقق من مستوى حسابك، وابنِ استراتيجية backoff قبل الحاجة إليها.

للحصول على نظرة أوسع حول النموذج ونقاط قوته مقارنة بـ Opus 4.8، ابدأ بـ ما هو Grok 4.5.

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

ما هو معرف نموذج API لـ Grok 4.5؟

grok-4.5. النقطة مطلوبة في استدعاءات API.

هل يعمل API الخاص بـ Grok 4.5 مع OpenAI SDK؟

نعم. اضبط base_url على https://api.x.ai/v1 ومرر مفتاح xAI الخاص بك. عادةً يمكن نقل كود Chat Completions الحالي بتغييرات قليلة.

كم تبلغ تكلفة API الخاص بـ Grok 4.5؟

2 دولار لكل مليون رمز إدخال و6 دولارات لكل مليون رمز إخراج، مع عدم وجود خصم دفعات مدرج. راجع تفاصيل التسعير الكاملة لحساب التكلفة الفعلية.

هل توجد طريقة مجانية لاستدعاء Grok 4.5؟

يتضمن Grok Build وCursor استخدامًا مجانيًا لـ Grok 4.5 لفترة محدودة، وقد غطت أرصدة التجربة في وحدة التحكم اختبار API الخفيف. التفاصيل في دليل الوصول المجاني الخاص بنا.

ما هي نافذة السياق؟

500 ألف رمز. إذا كنت بحاجة إلى مليون رمز، استخدم grok-4.3 واقبل المفاضلة في القدرة.

Top comments (0)