راهنمای API Grok: کلید، قیمت و سرنوشت سطح رایگان

پاسخ سریع: چگونه در 2026 یک کلید API Grok بگیریم

چهار گام، بدون لیست انتظار. در console.x.ai با ایمیل یا حساب X ثبت‌نام کنید. یک روش پرداخت اضافه کنید و اعتبار پیش‌پرداخت بارگذاری کنید، چون xAI در برابر یک موجودی اعتباری به ازای هر تیم صورت‌حساب می‌دهد نه فاکتور پس از واقعه. یک کلید API از داشبورد کنسول بسازید. سپس درخواست‌ها را به https://api.x.ai/v1 با همان schema درخواست OpenAI Chat Completions API ارسال کنید، که یعنی SDKهای OpenAI با تغییر دو خط کار می‌کنند: base URL و کلید. اگر دنبال «grok api free» گشتید: چت‌بات مصرفی Grok در X و grok.com یک سطح رایگان دارد، اما API توسعه‌دهنده ندارد. اعتبار $25 ماهانه بتای عمومی 2024 از بین رفته و برنامه‌های اعتباری باقی‌مانده شرایط خاص خود را دارند. جزئیات در بخش بعدی. یک نکته درباره نام‌گذاری پیش از کپی هر کدی. شناسه‌های مدل در سمت xAI از الگوی خانواده grok-4 پیروی می‌کنند (مثلاً grok-4 و نسخه‌های fast)، و xAI نسخه‌های نقطه‌ای قدیمی را طبق یک برنامه بازنشسته می‌کند. لیست زنده را از endpoint /v1/models یا کنسول بکشید نه اینکه یک شناسه که در یک آموزش چند‌ماهه قدیمی پیدا کرده‌اید را hardcode کنید.

چه اتفاقی برای سطح رایگان API Grok افتاد

xAI هرگز یک سطح رایگان دائمی API ارائه نکرده، اما چندین برنامه اجرا کرده که مردم آن‌ها را به‌عنوان یک برنامه واحد به یاد می‌آورند. به همین دلیل نتایج جستجو با هم مغایرت دارند. در طول بتای عمومی API در اواخر 2024، هر حساب هر ماه $25 اعتبار رایگان دریافت می‌کرد. آن برنامه با بسته شدن بتا پایان یافت. از اواسط 2025، xAI به‌طور دوره‌ای یک اعتبار ماهانه بزرگ‌تر، که جامعه آن را حدود $150 در ماه گزارش کرده، به تیم‌هایی ارائه داده که در اشتراک‌گذاری داده درخواست API خود برای آموزش شرکت می‌کنند و یک آستانه هزینه قبلی کوچک را برآورده می‌کنند. این محدود به کشورهای واجد شرایط است و شرایط آن بیش از یک بار تغییر کرده، پس آن را به‌عنوان برنامه‌ای برای تأیید در کنسول در نظر بگیرید نه واقعیتی برای برنامه‌ریزی. جداگانه، حساب‌های جدید کنسول گاهی اعتبارهای آزمایشی تبلیغاتی کوچک دریافت می‌کنند، اما این‌ها گاه‌به‌گاه هستند و تضمین‌شده نیستند. جدول زیر نسخه صادقانه «grok api free» در 2026 است.

قیمت API Grok: نرخ‌های منتشرشده

xAI به ازای هر یک میلیون token قیمت می‌دهد، با نرخ‌های جداگانه ورودی و خروجی، و خط تولید را به یک سطح پرچمدار و یک سطح fast تقسیم می‌کند. سطح fast برای بیشتر اپلیکیشن‌ها جالب‌تر است: یک پنجره context بسیار طولانی دارد و با نرخ‌هایی که هر آزمایشگاه پرچمدار دیگر آمریکایی را زیر می‌زند. نرخ‌های زیر ارقام منتشرشده docs.x.ai برای نسل Grok 4 هستند. نسخه‌های نقطه‌ای جدیدتر همان ساختار سطح را حفظ کرده‌اند، اما xAI نرخ‌ها را تنظیم می‌کند و مدل‌ها را بدون تشریفات زیاد بازنشسته می‌کند، پس پیش از تعهد ترافیک با صفحه قیمت‌گذاری زنده تأیید کنید. دو جزئیات صورت‌حساب افراد را گیر می‌اندازد. اول، token های ورودی کش‌شده با نرخ کاهش‌یافته صورت‌حساب می‌شوند، که برای اپلیکیشن‌های چتی که یک system prompt طولانی را هر نوبت دوباره ارسال می‌کنند اهمیت دارد. دوم، Live Search (ابزار جستجوی وب داخلی) جداگانه به ازای هر منبع بازیابی‌شده، علاوه بر هزینه‌های token، صورت‌حساب می‌شود. اگر درخواست‌های شما ابزارهای جستجو را فعال می‌کنند، فاکتور بزرگ‌تر از یک برآورد خالص token خواهد بود.

سیاست محتوای xAI برای داستان تخیلی، به‌صورت بی‌طرفانه خلاصه‌شده

سهم بزرگی از علاقه به API Grok از توسعه‌دهندگان داستان تخیلی و roleplay می‌آید، پس ارزش دارد آنچه سیاست مکتوب واقعاً می‌گوید بیان شود نه آنچه فروم‌ها ادعا می‌کنند می‌گوید. سیاست استفاده قابل‌قبول منتشرشده xAI خطی متفاوت از سایر آزمایشگاه‌های آمریکایی دارد: بین تصویرسازی در اثر آشکارا تخیلی و آسیب دنیای واقعی تمایز قائل می‌شود، و مضامین بزرگسالانه را برای کاربران بزرگسال وقتی زمینه بدون ابهام تخیلی باشد، اجازه می‌دهد. این xAI را تنها provider بزرگ آمریکایی با یک اجازه مکتوب از این نوع می‌کند. سیاست استفاده Anthropic محتوای صریح جنسی را به‌طور کامل ممنوع می‌کند، حتی در داستان تخیلی، و Google محتوای صریح را در سراسر Gemini بدون توجه به تنظیمات ایمنی قابل‌تنظیم API محدود می‌کند. همان سند خطوط سختی می‌کشد که در داستان تخیلی و همه‌جای دیگر اعمال می‌شوند: هیچ محتوای جنسی مربوط به افراد زیر سن قانونی تحت هر چارچوبی، هیچ تصویرسازی از افراد واقعی قابل‌شناسایی بدون رضایت، و هیچ‌چیزی که فعالیت غیرقانونی واقعی را تسهیل کند. این یک پایه مکتوب برای ساخت ویژگی‌های داستان تخیلی بزرگسالانه است، نه یک سوئیچ همه‌چیز-مجاز. اگر روی آن بسازید، همچنان به کاربران خود age gating بدهکارید، و همچنان به هر پلتفرمی که در آن منتشر می‌کنید انطباق با شرایط خدمات خودش را بدهکارید، که اغلب سخت‌گیرانه‌تر از سیاست ارائه‌دهنده مدل است. برای مقایسه کنار هم اینکه هر provider بزرگ چگونه با داستان تخیلی رفتار می‌کند، به مقایسه سیاست محتوا که در پایین این صفحه لینک شده مراجعه کنید.

شروع سریع: فراخوانی API Grok در دو دقیقه

endpoint سازگار با OpenAI است، پس هر دو قطعه کد زیر شکل استاندارد Chat Completions هستند. اول کلید خود را به‌عنوان یک متغیر محیطی export کنید؛ کلیدها را در فایل‌های منبع نچسبانید. نسخه curl، برای یک تست دودی بلافاصله پس از ساخت کلید مفید است:

curl https://api.x.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4",
    "messages": [
      {"role": "user", "content": "Reply with exactly: key works"}
    ]
  }'

یک گزینه gateway با تخفیف برای مصرف سبک Grok

دسترسی مستقیم xAI انتخاب درست برای بارهای کاری تولیدی است. اما اگر گاه‌به‌گاه، در کنار مدل‌های دیگر و بدون باز کردن یک حساب صورت‌حساب دیگر به Grok نیاز دارید، یک gateway سازگار با OpenAI مسیر کوتاه‌تر است. APIsRouter grok-4.5، مدل عمومی پرچمدار xAI، را با $1.60 ورودی و $4.80 خروجی به ازای هر 1M token ارائه می‌دهد، 20% پایین‌تر از نرخ‌های رسمی لیست $2 / $6، در کنار مدل‌های DeepSeek، GLM، Kimi، Claude، Gemini و GPT روی یک موجودی. صورت‌حساب پرداخت بر اساس مصرف بدون اشتراک است، پرداخت در /topup بدون ساخت حساب کار می‌کند (اول پرداخت کنید، کلید از طریق ایمیل می‌رسد)، اولین شارژ +100% به موجودی اضافه می‌کند، و مدل‌های جهانی 20% پایین‌تر از قیمت رسمی اجرا می‌شوند با مدل‌های چینی زیر نرخ رسمی. برای فرانت‌اندهای چت و roleplay مشخصه‌ای که اهمیت دارد پنجره context ۵۰۰K است: ارسال دوباره یک character card بزرگ و تاریخچه چت طولانی هر نوبت حتی در نشست‌های ماراتنی درون یک پنجره باقی می‌ماند، هرچند token های ورودی همچنان فاکتور را هدایت می‌کنند. همان کلید در هر کلاینت سازگار با OpenAI کار می‌کند:

# SillyTavern (Chat Completion source: Custom OpenAI-compatible)
Base URL: https://api.apisrouter.com/v1
# model list auto-populates from /v1/models with your key
Model:    grok-4.5

# JanitorAI proxy config (needs the FULL endpoint)
Endpoint: https://api.apisrouter.com/v1/chat/completions
Model:    grok-4.5
API key:  sk-... (from the checkout email)

جایگاه Grok در میان مدل‌ها برای نویسندگی خلاق

هیچ مدل واحدی در همه رتبه‌بندی‌ها و همه بودجه‌ها برنده نمی‌شود. راه‌اندازی عملی یک فرانت‌اند است که به یک endpoint چندمدلی اشاره دارد، پس تغییر فیلد مدل یک تغییر dropdown است نه یک حساب جدید.

• Grok: دارایی متمایز اجازه مکتوب داستان تخیلی xAI برای کاربران بزرگسال است، که هیچ provider پرچمدار آمریکایی دیگری منتشر نمی‌کند. کیفیت نثر رقابتی است، و سطح fast نشست‌های طولانی را ارزان نگه می‌دارد.
• خانواده DeepSeek V4 (deepseek-v4-flash، deepseek-v4-pro): محبوب جامعه برای roleplay طولانی و قوی‌ترین ارزش به ازای هر token؛ flash برای حجم، pro برای پیروی دستور بهتر در صحنه‌های پیچیده.
• GLM-5، Kimi K2.6، MiMo: انتخاب‌های ارزشمند با رفتار context طولانی قوی؛ ارزش A/B تست کردن در برابر DeepSeek برای فرمت کارت خاص شما را دارند.
• Claude Sonnet 4.6 و Opus 4.7: بالاترین کیفیت نثر در دسترس برای نویسندگی خلاق SFW؛ سیاست Anthropic محتوای صریح را ممنوع می‌کند، پس آن‌ها را به کار مناسب همه سنین محدود کنید.

پرسش‌های پرتکرار