Grok API: المفاتيح ونقاط النهاية والنماذج وأول طلب

ما هي Grok API

Grok API هي واجهة المطورين المدفوعة من SpaceXSI (سابقًا xAI). تمنح شيفرتك الخاصة الوصول إلى عائلة نماذج Grok نفسها التي تشغّل تطبيقات Grok، إضافةً إلى نماذج الصور والفيديو والصوت. وتدفع لكل رمز، أو لكل صورة، أو لكل ثانية فيديو، أو لكل دقيقة صوت.

واجهة API منفصلة عن خطط المستهلكين. تدرج صفحة أسعار The X Subscription «Grok API access» ضمن Plus، لكنها تقول أيضًا إن استخدام API يُحتسب بشكل منفصل. ولا تشرح SpaceXSI كيف يتفاعل الاثنان، لذا خطّط لدفع تكلفة استدعاءات API عبر رصيد console.

وحالات الاستخدام الرئيسية هي المعتادة: الدردشة والاستدلال في تطبيقاتك، والوكلاء الذين يستدعون الأدوات، وفهم المستندات والصور، وتوليد الوسائط. ولتعريف مبسّط، راجع مدخل API في مسردنا.

كيف تحصل على مفتاح Grok API

يصف دليل البدء السريع من SpaceXSI أربع خطوات:

1. أنشئ حسابًا على console.x.ai.
2. اشحن رصيدًا مدفوعًا مسبقًا. تقول الوثائق إن الرصيد مطلوب قبل أن تعمل الاستدعاءات.
3. افتح صفحة API Keys وأنشئ مفتاحًا.
4. خزّن المفتاح كمتغير بيئة باسم XAI_API_KEY، لا في شيفرتك المصدرية.

الفوترة مدفوعة مسبقًا افتراضيًا. وعندما ينفد الرصيد، تُرفض الطلبات. ويمكنك تفعيل إعادة الشحن التلقائية، بحد أدنى $5. والفوترة بالفواتير متوقفة افتراضيًا ويجب طلبها من فريق مبيعات SpaceXSI.

عنوان URL الأساسي وSDKs ونقاط النهاية

تذهب جميع الطلبات إلى عنوان URL الأساسي https://api.x.ai/v1. وتدرج الوثائق ثلاث طرق لاستدعائه:

• xai_sdk، الـ SDK الرسمي لـ Python.
• OpenAI SDK (Python وJavaScript)، موجّهًا إلى عنوان URL الأساسي لـ xAI.
• Vercel AI SDK، عبر الحزمة @ai-sdk/xai.

Responses API أم Chat Completions

Responses API على /v1/responses هي الواجهة الرئيسية لدى SpaceXSI. ولا تزال Chat Completions على /v1/chat/completions مدعومة. ومع Grok 4.7، تُرجع استدعاءات Responses API دائمًا استدلالًا مشفّرًا. وحلّت /v1/chat/completions محل نقطة النهاية القديمة /v1/completions.

نقاط النهاية بأسلوب Anthropic مهجورة

نقطتا النهاية المتوافقتان مع Anthropic ‏/v1/messages و/v1/complete مُعلَّمتان كمهجورتين. وتوجّه SpaceXSI المستخدمين إلى Responses API أو gRPC بدلًا منهما. ولا يوجد موعد إيقاف، لكن لا ينبغي بناء المشاريع الجديدة عليهما.

نقطة النهاية الإقليمية الأمريكية

نقطة نهاية أمريكية على https://us.api.x.ai/v1 تُبقي المعالجة داخل الولايات المتحدة. وتكلّف 1.1 ضعف الأسعار العالمية ولا تقدّم إلا grok-4.7 وgrok-4.6. والتفاصيل في صفحة أسعار Grok API لدينا.

أول طلب مبسّط

يستدعي هذا المثال Responses API باستخدام curl. ويفترض أن مفتاحك مخزّن في XAI_API_KEY:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

إعدادان يستحقان المعرفة من اليوم الأول:

• reasoning_effort: يقبل Grok 4.7 القيم low وmedium وhigh (الافتراضية) وxhigh.
• prompt_cache_key (أو الترويسة x-grok-conv-id): توصي SpaceXSI بشدة بضبط أحدهما. فبدونه، قد يصل الطلب إلى خادم ذاكرته المؤقتة فارغة فيدفع سعر الإدخال كاملًا.

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

النماذج على Grok API

هذه هي النماذج النصية الحالية، بالأسعار بالدولار الأمريكي لكل مليون رمز. وتكلّف الموجّهات التي تتجاوز 200k رمز الضعف.

Grok 4.7 Fast غير متاح على API العامة. ولا يُقدَّم إلا في Cursor وGrok Build. وسُحبت عدة نماذج أقدم، منها grok-3 وgrok-4-0709 وGrok 4 Fast وgrok-code-fast-1، في 15 مايو 2026. وتُوجَّه الاستدعاءات إلى grok-code-fast-1 الآن إلى grok-build-0.1.

وتقدّم API أيضًا نماذج الصور والفيديو من Grok Imagine ونماذج Grok Voice. راجع Grok Imagine ودليل Grok Voice API.

الأدوات المدمجة

تستطيع نماذج Grok استدعاء أدوات من جهة الخادم تشغّلها SpaceXSI نيابةً عنك. وتدرج صفحة الأسعار:

• Web Search وImage Search.
• X Search، التي تُرجع منشورات وملفات تعريف من X.
• Code Execution.
• File attachment search وCollections Search للاسترجاع من مستنداتك الخاصة.
• أدوات view_image وview_x_video وRemote MCP، التي تُحتسب بالرموز فقط.

تُحتسب معظم الأدوات لكل 1,000 استدعاء إضافةً إلى تكاليف الرموز. ولكل نموذج أيضًا حدود للطلبات والرموز حسب الفئة، نتناولها في صفحة حدود معدل Grok API لدينا.

أسئلة يطرحها الناس