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

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

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

زر

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

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

1. انتقل إلى وحدة تحكم xAI وسجل الدخول.
2. افتح قسم مفاتيح API وأنشئ مفتاحًا جديدًا.
3. قم بتخزينه كمتغير بيئة. لا تقم أبدًا بترميزه بشكل ثابت:

export XAI_API_KEY="xai-..."

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

الخطوة 2: إجراء طلبك الأول

تستخدم البداية السريعة الرسمية لـ xAI نقطة نهاية الاستجابات (Responses). هذا هو الشكل الدقيق من صفحة الإصدار:

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]}"
  }'

هناك تفصيلان يربكان المستخدمين:

• معرف النموذج يحتوي على نقطة. grok-4.5 يعمل؛ grok-4-5 يعيد خطأ "النموذج غير موجود". تستخدم الروابط وعناوين URL الشرطات، بينما تستخدم استدعاءات API النقطة.
• البداية السريعة مصممة للاستجابات (Responses)، حيث تأخذ حقلاً input بدلاً من مصفوفة messages. تحتفظ xAI أيضًا بإكمال الدردشة المتوافق مع OpenAI، وهو أمر مهم إذا كنت تقوم بترحيل التعليمات البرمجية الموجودة.

استخدام حزمة تطوير برامج OpenAI

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

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)

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

التدفق

للاستخدام التفاعلي، قم بتمكين التدفق واستهلك الأحداث المرسلة من الخادم:

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)

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

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

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

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

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

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

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

قبل أن يقترب Grok 4.5 من الإنتاج، ضع نقطة النهاية تحت نظام اختبار مناسب. إليك سير العمل في Apidog:

1. أنشئ طلبًا لـ POST https://api.x.ai/v1/responses (أو مسار إكمال الدردشة إذا كنت تستخدم السطح المتوافق).
2. خزّن المفتاح كمتغير بيئة في بيئة Apidog، حتى لا يصل رمز الحامل (Bearer token) إلى مجموعة مشتركة أبدًا.
3. أرسل وافحص. يعرض Apidog تدفقات SSE فور وصولها، لذا يمكنك مراقبة التغيرات والتأكد من انتهاء التدفق بسلاسة.
4. تحقق من الاستجابة. أضف تأكيدات مرئية على الحقول التي يعتمد عليها تطبيقك، مثل اسم النموذج المعروض مرة أخرى، وسبب الانتهاء، وعدد الاستخدامات.
5. قارن بين النموذجين (A/B). كرر الطلب، غيّر grok-4.5 إلى grok-4.3، وقارن جودة الإخراج، ووقت الاستجابة، واستخدام الرموز جنبًا إلى جنب على مطالباتك الحقيقية بدلاً من الثقة بمتوسطات المعايير.
6. أنشئ نموذجًا وهميًا (Mock). أنشئ خادمًا وهميًا من مخطط الاستجابة حتى يتمكن فريق الواجهة الأمامية وضمان الجودة من البناء على شكل مستقر بينما تقوم بضبط المطالبات. لا توجد أرصدة xAI مستهلكة على تطوير واجهة المستخدم.

يُعد كائن الاستخدام (usage object) أكثر أهمية مع هذا النموذج مقارنة بمعظم النماذج الأخرى. تتمثل ميزة Grok 4.5 في كفاءة الرمز، لذا تتبع output_tokens لكل مهمة في تأكيداتك. إذا كانت مطالباتك تنتج مخرجات بطول Opus على أي حال، فإن ميزة التكلفة تتقلص.

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

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

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

للحصول على صورة أكبر حول ماهية هذا النموذج وأين يتفوق أو يتخلف عن Opus 4.8، ابدأ بـ ما هو Grok 4.5.

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

ما هو معرف نموذج API لـ Grok 4.5؟ grok-4.5. النقطة مطلوبة في استدعاءات API.

هل يعمل API الخاص بـ Grok 4.5 مع حزمة تطوير برامج OpenAI؟ نعم. اضبط base_url على https://api.x.ai/v1 ومرر مفتاح xAI الخاص بك. تنتقل تعليمات إكمال الدردشة البرمجية الحالية بأقل قدر من التغييرات.

كم تبلغ تكلفة API الخاص بـ Grok 4.5؟ 2 دولار لكل مليون رمز إدخال و 6 دولارات لكل مليون رمز إخراج، مع عدم وجود خصم على الدفعات مدرج. راجع تفاصيل التسعير الكاملة لحساب التكلفة الفعالة.

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

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