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

أطلقت xAI نموذج Grok 4.6 في 12 أغسطس 2026، ويستهدف العرض المطورين مباشرة: نموذج رائد للمهام المتطورة للعوامل طويلة الأمد وأعمال الترميز متعددة الخطوات، بسعر 2 دولار لكل مليون رمز إدخال و 6 دولارات لكل مليون رمز إخراج. تغطي الوثائق الرسمية المواد المرجعية، لكن لا يوجد شيء في أهم نتائج البحث يرشدك خلال استدعاء واجهة برمجة التطبيقات (API) بشكل كامل. يهدف هذا الدليل إلى حل هذه المشكلة.

بحلول النهاية، ستحصل على مفتاح API، وطلب عملي في curl و Python و JavaScript، ومخرجات متدفقة، وإعداد قابل للتكرار لاختبار نقاط نهاية Grok 4.6 قبل أن تصل إلى مرحلة الإنتاج. إذا كنت ترغب في بناء وتصحيح هذه الطلبات بصريًا بدلاً من التنقل بين نوافذ الطرفية، فإن Apidog يتعامل مع التدفق بالكامل، قم بتنزيله مجانًا للمتابعة.

TL;DR (باختصار)

• احصل على مفتاح API من console.x.ai، وقم بتعيينه كـ XAI_API_KEY، واستدعِ https://api.x.ai/v1/chat/completions باستخدام النموذج grok-4-6.
• واجهة برمجة التطبيقات متوافقة مع OpenAI، لذا تعمل حزم SDK الرسمية لـ OpenAI عن طريق تبديل عنوان URL الأساسي، لا حاجة لتعلم مكتبة عميل جديدة.
• يوفر Grok 4.6 نافذة سياق بحجم 500,000 رمز وآخر تحديث للمعلومات بتاريخ 1 فبراير 2026.
• التسعير: 2 دولار لكل مليون رمز إدخال، 6 دولارات لكل مليون رمز إخراج. النسخة الأسرع تكلف ضعف ذلك.
• بالإضافة إلى واجهة برمجة التطبيقات الأصلية، يتوفر Grok 4.6 عبر OpenRouter و Vercel و Cloudflare و Cursor و Grok Build.
• اختبر الطلبات، افحص الاستجابات المتدفقة، وقم بمحاكاة نقاط نهاية Grok لـ CI باستخدام Apidog.

ما ستعمل عليه

قبل كتابة أي كود، إليك ورقة المواصفات المهمة لقرارات التكامل:

التحسينات الرئيسية على Grok 4.5 هي ذاتية: تشير xAI إلى أن النموذج يتحقق من عمله الخاص بشكل متكرر على المسارات الطويلة وينتج تمريرات أولى أقوى في المشاريع التفاعلية والبصرية. على المعايير، قفز من 54% إلى 65.9% على DeepSWE v1.1 ومن 47.1% إلى 57.5% على APEX-Agents. إذا قمت بالبناء باستخدام واجهة برمجة تطبيقات Grok 4.5، فإن سطح التكامل لم يتغير، راجع دليل Grok 4.5 API الخاص بنا للحصول على الأساس، ثم قم بتبديل اسم النموذج.

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

1. اذهب إلى console.x.ai وقم بتسجيل الدخول أو إنشاء حساب xAI.
2. افتح مفاتيح API من الشريط الجانبي وانقر على إنشاء مفتاح API.
3. سمِّ المفتاح لبيئته (grok-dev، grok-prod)؛ ستشكر نفسك عند تدوير المفاتيح لاحقًا.
4. انسخ المفتاح فورًا. تعرضه xAI مرة واحدة فقط.

قم بتخزينه كمتغير بيئة بدلاً من لصقه في الكود:

export XAI_API_KEY="your-key-here"

عادة تستحق التبني من اليوم الأول: احتفظ بمفاتيح منفصلة للتطوير والإنتاج، ولا تقم أبدًا بتضمين مفتاح في نظام التحكم بالإصدار. إذا تسرب مفتاح، قم بإلغائه في لوحة التحكم وأصدر مفتاحًا جديدًا.

الخطوة 2: طلبك الأول باستخدام curl

تتبع واجهة برمجة تطبيقات xAI تنسيق إكمال الدردشة الخاص بـ OpenAI. إليك الحد الأدنى من الطلب:

curl https://api.x.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-6",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain idempotency in REST APIs in two sentences."}
    ]
  }'

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

نصيحة: قد تختلف معرفات النموذج أحيانًا بين واجهة برمجة التطبيقات الأصلية والموزعين (على سبيل المثال، OpenRouter يسردها كـ x-ai/grok-4.6). إذا تلقيت خطأ model not found، اسرد ما يمكن لمفتاحك الوصول إليه:

curl https://api.x.ai/v1/models -H "Authorization: Bearer $XAI_API_KEY"

الخطوة 3: بايثون وجافاسكريبت

نظرًا لأن واجهة برمجة التطبيقات متوافقة مع OpenAI، تعمل حزم SDK الرسمية لـ OpenAI بتغيير سطرين: عنوان URL الأساسي والمفتاح.

بايثون:

from openai import OpenAI
import os

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

response = client.chat.completions.create(
    model="grok-4-6",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Write a Python function that validates an email address."},
    ],
)

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

جافاسكريبت / تايب سكريبت:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4-6",
  messages: [
    { role: "system", content: "You are a concise technical assistant." },
    { role: "user", content: "Write a TypeScript type guard for a User object." },
  ],
});

console.log(response.choices[0].message.content);

هذا التوافق يعني أيضًا أن الترحيل في أي من الاتجاهين غير مكلف. إذا كنت تستخدم بالفعل واجهة برمجة تطبيقات GPT-5.6، فيمكنك إجراء اختبار A/B لـ Grok 4.6 مقابلها خلف علامة تكوين واحدة.

الخطوة 4: الاستجابات المتدفقة

لأي شيء يواجه المستخدم، استخدم البث المتدفق. تم ضبط Grok 4.6 للمخرجات الطويلة متعددة الخطوات، وجعل المستخدمين يحدقون في مؤشر التحميل لاستجابة 2000 رمز هو تبادل سيء.

stream = client.chat.completions.create(
    model="grok-4-6",
    messages=[{"role": "user", "content": "Refactor this function and explain each change: ..."}],
    stream=True,
)

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

تصل الاستجابات المتدفقة كأحداث مرسلة من الخادم (SSE). يكون فحصها في الطرفية محرجًا بمجرد البدء في تصحيح الأخطاء، حيث أن كل جزء هو سطر data: منفصل، وتظهر المعالجة الخاطئة على شكل رموز مفقودة أو واجهات مستخدم متوقفة. يعرض Apidog تدفقات SSE في الوقت الفعلي في لوحة الاستجابات الخاصة به، مما يجعل من الواضح ما إذا كان التوقف بسبب تفكير النموذج أو بسبب تخزين العميل المؤقت.

الخطوة 5: استخدام سياق الـ 500 ألف رمز بحذر

نافذة سياق بحجم 500,000 رمز تتسع لقاعدة بيانات كاملة متوسطة الحجم أو عدة مئات من صفحات المستندات. تحذيران قبل أن ترمي كل شيء عليها:

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

النسخة السريعة (ضعف السعر) تستحق العناء للمسارات الحساسة للكمون مثل مساعدي الترميز التفاعلي. بالنسبة للعمليات الدفعية، والتحليل الليلي، والتصنيف بالجملة، فإن المستوى القياسي هو الخيار الواضح. تفاصيل التسعير الكاملة والمقارنات مع GPT-5.6 و Claude موجودة في تحليل تسعير Grok 4.5 الخاص بنا، والذي لا يزال ينطبق هيكليًا على 4.6.

اختبار التكامل بشكل صحيح باستخدام Apidog

أمر curl يعمل ليس تكاملاً. قبل أن يصل Grok 4.6 إلى الإنتاج، أنت بحاجة إلى مكان يتم فيه إصدار الطلبات، وتكون البيئات منفصلة، ويمكن تكرار حالات الفشل. هنا تكتسب Apidog مكانتها في سير العمل:

1. أنشئ مشروعًا وأضف بيئة مع base_url = https://api.x.ai/v1 ومفتاح XAI_API_KEY الخاص بك كمتغير بيئة. تظل مفاتيح التطوير والإنتاج منفصلة بوضوح.
2. ابنِ طلب إكمال الدردشة مرة واحدة، مع توارث المصادقة من البيئة. الآن كل عضو في الفريق يصل إلى نفس نقطة النهاية بنفس الطريقة.
3. افحص التدفق بصريًا. يعرض Apidog أجزاء SSE فور وصولها، حتى تتمكن من مشاهدة المخرجات رمزًا برمز واكتشاف التوقفات أو الاقتطاع على الفور.
4. أضف تأكيدات. تحقق من أن choices[0].message.content غير فارغ، وأن usage.total_tokens يبقى ضمن الميزانية، وأن وقت الاستجابة يفي باتفاقية مستوى الخدمة الخاصة بك، ثم قم بتشغيل هذه كسيناريوهات اختبار تلقائية في CI.
5. قم بمحاكاة نقطة النهاية. تُرجع المحاكاة الذكية لـ Apidog استجابات واقعية على شكل Grok، بحيث يمكن لكود الواجهة الأمامية والعميل التطوير مقابل نسخة وهمية مستقرة بينما تقوم بالتكرار على الطلبات، دون استهلاك رموز.

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

الأخطاء الشائعة والإصلاحات السريعة

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

هل واجهة برمجة تطبيقات Grok 4.6 متوافقة مع OpenAI؟ نعم. تقبل نقطة نهاية إكمال الدردشة نفس شكل الطلب، وتعمل حزم SDK الرسمية لـ OpenAI عن طريق توجيه base_url إلى https://api.x.ai/v1.

كم تكلفة واجهة برمجة تطبيقات Grok 4.6؟ 2 دولار لكل مليون رمز إدخال و 6 دولارات لكل مليون رمز إخراج. النسخة الأسرع هي الضعف. لا توجد رسوم منفصلة لسياق الـ 500 ألف رمز، تدفع مقابل الرموز التي ترسلها فعليًا.

هل أحتاج إلى تكامل جديد إذا كنت أستخدم Grok 4.5؟ لا. قم بتبديل اسم النموذج. لم يتغير تنسيق الطلب والمصادقة ونقاط النهاية عن Grok 4.5.

هل يمكنني استخدام Grok 4.6 بدون حساب xAI؟ نعم، من خلال OpenRouter أو Vercel AI Gateway أو Cloudflare، كل منها بفواتيره الخاصة. واجهة برمجة التطبيقات الأصلية هي عادة المسار الأرخص عند الحجم الكبير.