مدل پایه
Grok (xAI models and API) (گراک (مدل‌ها و API شرکت xAI))
معرفی مدل‌ها و API شرکت xAI: Responses API، function calling، ابزارها، قیمت‌گذاری منتشرشده و ملاحظات اتصال Grok به سامانه‌های سازمانی.
وضعیت مستندات: مستند رسمی خدمات کهن سیستم: مشروط به ارزیابی فنی
Grok (xAI models and API) محصول xAI است؛ این صفحه معرفی مستقل کهن سیستم فردا بر اساس منابع رسمی است.
شناسنامه محصول
| نام محصول | Grok (xAI models and API) |
|---|---|
| سازنده | xAI |
| دسته | مدل پایه |
| وب‌سایت رسمی | x.ai (پیوند خارجی) |
| مستندات | docs.x.ai (پیوند خارجی) |
| مخزن کد | ندارد (محصول اختصاصی) |
| مجوز | proprietary (تأییدنشده) |
| متن‌باز | خیر |
| نسخه بررسی‌شده | نامشخص |
| مدل‌های استقرار | ابری |
| مدل‌های پشتیبانی‌شده | grok-4.7، grok-4.6، grok-4.5، grok-4.3، grok-4.20 (reasoning / non-reasoning / multi-agent)، grok-build-0.1، grok-imagine (image/video)، grok-voice-3.0 |
| یکپارچگی‌ها | Responses API (https://api.x.ai/v1)، OpenAI SDK با base_url سفارشی، Function calling، Web Search، X Search، Batch API |
| دسترسی API | مستند رسمی |
| آخرین بررسی |
معرفی Grok (xAI models and API)
چیست؟
Grok خانوادهٔ مدل‌های زبانی و چندوجهی شرکت xAI است و از طریق API رسمی در اختیار توسعه‌دهندگان قرار می‌گیرد. در این رکورد فقط مدل‌ها و API ویژهٔ توسعه‌دهندگان بررسی شده‌اند؛ اپلیکیشن گفت‌وگوی Grok و محصولی که در برخی منابع «Grok Bot» نامیده می‌شود، محصول‌های جداگانه‌اند و در ادامه توضیح داده شده است.
چه می‌کند؟
API مدل‌های متنی با پنجرهٔ زمینه تا یک میلیون توکن، استدلال، تولید و درک تصویر، تبدیل متن به گفتار و برعکس، گفت‌وگوی صوتی بلادرنگ، تولید ویدیو، function calling، خروجی ساخت‌یافته و Batch API ارائه می‌کند. جست‌وجوی وب و X به‌صورت ابزار سمت سرور در دسترس است.
چگونه کار می‌کند؟
برنامهٔ شما درخواست را به نقطهٔ پایانی https://api.x.ai/v1/responses می‌فرستد؛ مدل در صورت نیاز تابعی را که شما تعریف کرده‌اید فراخوانی می‌کند، کد شما آن را اجرا می‌کند و نتیجه را برمی‌گرداند. در مستندات رسمی نمونه‌کدی با OpenAI SDK و base_url اختصاصی xAI ارائه شده است.
چه مسئله‌ای را حل می‌کند؟
این رویکرد برای سازمانی مناسب ارزیابی است که می‌خواهد بدون خرید محصول آماده، مدل‌های Grok را از طریق API در یک سامانهٔ داخلی (دستیار، خلاصه‌سازی، استخراج اطلاعات، Agent سفارشی) به‌عنوان یکی از ارائه‌دهندگان مدل به کار ببرد.
برای چه کسانی است؟
تیم‌های توسعه و معماری که یکپارچه‌سازی API را خودشان یا با شریک فنی انجام می‌دهند. استفادهٔ سازمانی نیازمند بررسی شرایط استفاده، حریم داده و مسائل حقوقی و تحریمی مرتبط با کشور مقصد است که در این رکورد تأیید نشده است.
سناریوهای کاربرد
اتصال Grok به یک لایهٔ مدل‌گیت‌وی داخلی در کنار مدل‌های دیگر؛ ابزار جست‌وجوی دانش با function calling؛ خلاصه‌سازی و دسته‌بندی متن. همگی سناریوی پیشنهادی‌اند و KSF آن‌ها را آزمون نکرده است.
تفاوت با گزینه‌های دیگر
تفاوت با Grok Bot: Grok API مدل را در اختیار توسعه‌دهنده می‌گذارد، اما Grok Bot به‌عنوان یک عامل همیشه‌روشن شخصی در منابع ثانویه توصیف شده و صفحهٔ رسمی آن در وب‌سایت xAI به‌دلیل خطای ۴۰۳ برای ما در دسترس نبود؛ بنابراین آن را تأییدشده فرض نمی‌کنیم. تفاوت با مدل‌های متن‌باز: Grok سرویس ابری xAI است و نسخهٔ نصب داخلی در منابع بررسی‌شده ذکر نشده.
قابلیت‌های تأییدشده
وضعیت هر قابلیت بر اساس منبع یا آزمون مشخص شده است؛ «نامشخص» یعنی هنوز منبعی ثبت نشده است.
| قابلیت | وضعیت |
|---|---|
| فراخوانی ابزار (Tool Calling) | مستند رسمی |
| هماهنگی چندعاملی | تأییدنشده |
| حافظه | تأییدنشده |
| بازیابی دانش (RAG) | تأییدنشده |
| اتصال به API | مستند رسمی |
| خودکارسازی گردش کار | تأییدنشده |
| خودکارسازی مرورگر | تأییدنشده |
| کار با رایانه (Computer Use) | تأییدنشده |
| تعامل صوتی | مستند رسمی |
| انعطاف در انتخاب مدل | تأییدنشده |
| استقرار ابری / درون‌سازمانی | تأییدنشده |
| کنترل دسترسی | تأییدنشده |
| ثبت رویداد (Logging) | تأییدنشده |
| حاکمیت و انطباق | تأییدنشده |
| مشاهده‌پذیری (Observability) | تأییدنشده |
معماری و الزامات استقرار
- پیش‌نیازها
- حساب xAI و کلید API (XAI_API_KEY)؛ برنامهٔ کلاینت با HTTPS خروجی به api.x.ai.
- وابستگی‌ها
- سرویس ابری xAI؛ در صورت استفاده از جست‌وجوی وب یا X، ابزارهای سمت سرور xAI.
- محیط‌های اجرا
- فقط سرویس ابری؛ منبع رسمی بررسی‌شده هیچ نسخهٔ نصب داخلی یا اقامت داده‌ای را ذکر نکرده است (تأییدنشده).
- منابع پردازشی
- سمت xAI؛ سازمان فقط برنامهٔ کلاینت و در صورت لزوم لایهٔ ابزار را اجرا می‌کند.
- ذخیره‌سازی و حالت
- مستندات Responses API وضعیت سمت سرویس را پشتیبانی می‌کند، اما سیاست نگهداری داده در صفحات بررسی‌شده تأیید نشد؛ پیش از ارسال داده‌های حساس باید شرایط رسمی بررسی شود.
- احراز هویت
- کلید API؛ جزئیات سازمانی (SSO، RBAC) در صفحات بررسی‌شده نیامده است.
- شبکه
- HTTPS به https://api.x.ai/v1؛ برای شبکه‌های بسته نیازمند خروجی کنترل‌شده یا پراکسی است؛ در دسترس‌بودن از ایران تأیید نشده است.
- الگوهای یکپارچگی
- Responses API، function calling با parallel_tool_calls و tool_choice، Web Search، Batch API؛ MCP راه دور در نمای کلی مستندات ذکر نشد اما در جدول قیمت ابزار «Remote MCP Tools» آمده است.
- محدودیت‌ها
- logprobs در grok-4.20 به بعد نادیده گرفته می‌شود؛ بدون ابزار جست‌وجو دانش جاری ندارد (تاریخ دانش Grok 4.7: مه ۲۰۲۶)؛ هیچ اطلاعاتی دربارهٔ حریم داده، نرخ‌محدودسازی یا استقرار داخلی از منبع رسمی تأیید نشد.
تحلیل امنیتی
| تهدید | کنترل پیشنهادی یا مستند |
|---|---|
| نشت داده به سرویس ابری | طبقه‌بندی داده، حذف/ناشناس‌سازی پیش از ارسال و بررسی شرایط داده‌ای رسمی xAI (در این بررسی تأیید نشد). |
| امنیت کلید API | نگهداری در مخزن رازها، چرخش دوره‌ای، دسترسی از سمت سرور و نه کلاینت. |
| تزریق دستور از محتوای وب یا ابزارها | جداسازی ورودی غیرقابل‌اعتماد، تأیید خروجی پیش از اجرا و فهرست ابزارهای مجاز. |
| مجوز ابزار (function calling) | هر تابع با کمینه دسترسی؛ اعتبارسنجی پارامترها در کد خودتان و تأیید انسانی برای اقدام‌های پرریسک. |
| خروجی غیرقابل‌اعتماد | اعتبارسنجی با طرح JSON و بازبینی قبل از نوشتن در سیستم‌های سازمانی. |
| ممیزی | ثبت درخواست/پاسخ‌های لازم در لاگ داخلی؛ ثبت ممیزی سمت xAI در منابع بررسی‌شده تأیید نشد. |
کاربردهای سازمانی
لایهٔ مدل جایگزین در یک Agent سازمانی
Grok به‌عنوان یکی از ارائه‌دهندگان در یک دروازهٔ مدل داخلی، با سیاست مسیریابی و ثبت لاگ.
خلاصه‌سازی و دسته‌بندی متن
پردازش دسته‌ای (Batch) برای متن‌های غیرحساس با خروجی ساخت‌یافته.
ابزار جست‌وجوی دانش با function calling
مدل تابع جست‌وجو را صدا می‌زند؛ بازیابی در سامانهٔ داخلی خود سازمان انجام می‌شود.
قیمت و مجوز
- مدل مجوز
- سرویس API پولی با تعرفهٔ مبتنی بر توکن؛ مدل‌ها اختصاصی‌اند.
- قیمت منتشرشده
- طبق صفحهٔ رسمی (دلار آمریکا به ازای هر یک میلیون توکن): grok-4.7 با پرامپت کمتر از ۲۰۰ هزار توکن ورودی ۲ و خروجی ۶؛ برای ۲۰۰ هزار توکن و بیشتر ورودی ۴ و خروجی ۱۲. ابزار Web Search ۵ دلار به ازای هر هزار فراخوانی.
- وابستگی به API و مدل
- وابسته به API xAI.
- هزینه زیرساخت
- کلاینت و لایهٔ ابزار داخلی؛ مدل در سرویس xAI اجرا می‌شود.
- نگهداری
- تغییر مدل‌ها و نرخ‌ها باید ماهانه بازبینی شود.
- محدودیت‌ها
- نرخ‌محدودسازی در صفحات بررسی‌شده ذکر نشد.
- صفحه قیمت رسمی
- docs.x.ai (پیوند خارجی)
- وضعیت تأیید قیمت
- نامشخص — تاریخ بررسی:
قیمت‌ها را سازنده تعیین می‌کند و ممکن است تغییر کند؛ پیش از تصمیم، صفحه رسمی را ببینید.
دیدگاه کهن سیستم فردا و پادیار
- بازیابی دانش (RAG)
- لایهٔ بازیابی در زیرساخت سازمان و Grok فقط برای تولید پاسخ؛ پیشنهاد KSF، آزمون‌نشده.
- یکپارچگی API
- Responses API پشت یک دروازهٔ داخلی با لاگ و محدودیت نرخ؛ پیشنهاد.
- هماهنگ‌سازی
- Grok به‌عنوان یک مدل در فریم‌ورک عامل؛ ارزیابی لازم است.
- حاکمیت
- طبقه‌بندی داده و سیاست ارسال به ابر پیش‌نیاز است.
- تجربه کاربری فارسی
- کیفیت فارسی باید با مجموعهٔ آزمون سازمان سنجیده شود؛ ادعایی نداریم.
- صوت
- امکان صدا در مستندات xAI هست؛ برای فارسی ارزیابی نشده است.
- دسترسی
- کلید API فقط در سرور؛ نقش‌بندی در لایهٔ سازمانی (پیشنهاد).
- زیرساخت خصوصی
- Grok نسخهٔ نصب داخلی مستند ندارد؛ برای الزام آفلاین باید از مدل‌های خودمیزبان استفاده کرد.
موارد این بخش پیشنهادهای طراحی کهن سیستم فردا هستند، مگر آنکه وضعیت «آزموده در کهن سیستم» داشته باشند. پادیار (پیوند خارجی) چت‌بات سازمانی‌ای است که کهن سیستم فردا طراحی و توسعه داده است.
پرسش‌های متداول
آیا Grok را می‌توان روی زیرساخت داخلی نصب کرد؟
در منابع رسمی بررسی‌شده چنین گزینه‌ای ذکر نشده است. Grok سرویس ابری xAI است؛ پس برای استقرار آفلاین باید از مدل‌های خودمیزبان استفاده شود.
Grok API با OpenAI SDK کار می‌کند؟
مستندات xAI نمونه‌ای را نشان می‌دهد که از OpenAI SDK با base_url=https://api.x.ai/v1 استفاده می‌کند؛ ادعای سازگاری کامل در آن صفحه نیامده است.
تفاوت Grok API و Grok Bot چیست؟
Grok API مدل‌ها را برای توسعه‌دهندگان ارائه می‌دهد. Grok Bot در منابع ثانویه به‌عنوان یک عامل شخصی همیشه‌روشن توصیف شده، اما صفحهٔ رسمی xAI برای ما در دسترس نبود؛ بنابراین آن را تأییدشده و جزو این رکورد نمی‌دانیم.
آیا Grok از ایران در دسترس است؟
این موضوع از منبع رسمی تأیید نشد و نیازمند بررسی حقوقی و تحریمی جداگانه است.
درخواست طراحی معماری
برای بررسی به‌کارگیری Grok (xAI models and API) در سازمان خود، درخواست مشاوره ثبت کنید.
شواهد، منابع و اصلاح اطلاعات
- xAI API — نمای کلی مستندات (پیوند خارجی) بررسی: — مدل‌ها، Responses API، صدا، تصویر، ویدیو، Batch، لینک قیمت‌گذاری
- xAI API — مدل‌ها (پیوند خارجی) بررسی: — فهرست مدل‌های Grok، پنجرهٔ زمینه، تاریخ دانش، توضیح جست‌وجوی وب
- xAI API — Function calling (پیوند خارجی) بررسی: — ابزار سمت کلاینت، parallel_tool_calls، tool_choice، نمونهٔ OpenAI SDK با base_url
- xAI API — قیمت‌گذاری (پیوند خارجی) بررسی: — نرخ توکن و ابزارها به دلار (طبق صفحهٔ رسمی در تاریخ بررسی)
- xAI — Grok (اپلیکیشن دستیار) (پیوند خارجی) بررسی: — تمایز اپ Grok و API؛ نتیجهٔ جست‌وجو، صفحه مستقیم‌اً خوانده نشد
- تاریخ بررسی منابع
- مسئول محتوا
- KSF Agent Hub editorial (lane D)
- آزموده‌شده توسط کهن سیستم فردا
- خیر
- وضعیت خدمات کهن سیستم
- مشروط به ارزیابی فنی
- محدودیت‌های این معرفی
- این صفحه بر اساس منابع عمومی سازنده در تاریخ بررسی تهیه شده است و جایگزین مستندات رسمی نیست؛ قابلیت‌ها ممکن است پس از این تاریخ تغییر کرده باشند.
- گزارش اشتباه
- اگر اطلاعات نادرست یا قدیمی می‌بینید، از طریق فرم درخواست اطلاع دهید؛ پس از بررسی منبع، رکورد اصلاح و تاریخ بررسی به‌روز می‌شود.