رفتن به محتوا
هوش مصنوعی ابری / متن و توسعه نرم‌افزار

API Grokگفت‌وگو، پردازش متن و کمک به توسعه

Grok خانواده‌ای از مدل‌های هوش مصنوعی با مستندات API برای تولید متن و کار با کد است. برای استفاده در یک محصول، نام و نسخهٔ دقیق مدل را انتخاب کنید؛ ویژگی‌های همهٔ مدل‌ها یکسان نیست. قابلیت‌های مستندشده توسط سازنده را با مدل‌ها و امکانات قابل ارائه در درگاه آراد تطبیق دهید.

ARAD CLOUD / AI GATEWAYورودی ← مدل ← پاسخ
ورودی شمامتن و زمینه
Grokمدل منتخب شما
پاسخ مدلخروجی قابل بررسی
01دستیار محتوایی و پاسخ‌گویی
02کمک به توسعه و بررسی کد
03برآورد مصرف واقعی
انتخاب آگاهانه مدل

ویژگی‌ها و معیارهای انتخاب API Grok

یک خانواده مدل، پاسخ یکسانی برای همه مسائل ندارد. این سه محور را در آزمون اولیه وارد کنید.

۱

تناسب نسخه با متن یا کد

پاسخ‌ها را با داده و معیار پذیرش مشخص بسنجید؛ کیفیت یک نمونه را به همه درخواست‌ها تعمیم ندهید.

۲

کیفیت خروجی فارسی و ساختاریافته

اندازه‌گیری را با الگوی درخواست و طول محتوای واقعی محصول انجام دهید.

۳

زمان پاسخ و مصرف در بار واقعی

مشخصات نسخه انتخابی را در پنل بررسی کنید و پیش از استفاده اصلی اتصال را آزمایش کنید.

معماری پیشنهادی برای بررسی

Grok در کجای محصول شما قرار می‌گیرد؟

۱

لایه ورودی و زمینه

برای «دستیار محتوایی و پاسخ‌گویی»، ورودی کاربر را از دستور اصلی جدا کنید. فقط زمینه مرتبط را به Grok بدهید و دسترسی به داده را پیش از ساخت درخواست بررسی کنید.

۲

لایه اتصال و کنترل

ارتباط با Grok را در Backend نگه دارید. زمان انتظار، سقف خروجی و رفتار درخواست ناموفق را مشخص کنید؛ تکرار خودکار بدون سقف می‌تواند مصرف را افزایش دهد.

۳

لایه پاسخ و اقدام

خروجی Grok را پیش از نمایش یا اجرای اقدام بررسی کنید. برای «کمک به توسعه و بررسی کد» مسیر بازبینی انسانی و پاسخ جایگزین در نظر بگیرید.

از فناوری تا کاربرد

کاربردهای API Grok در محصول شما

انتخاب را از مسئله محصول شروع کنید و با آزمون کیفیت ادامه دهید.

01

دستیار محتوایی و پاسخ‌گویی

خلاصه‌سازی، دسته‌بندی متن و تهیهٔ پیش‌نویس پاسخ را با داده‌های نمونهٔ خودتان آزمایش کنید. کیفیت زبان فارسی، رعایت دستور و صحت پاسخ را جداگانه بسنجید.

02

کمک به توسعه و بررسی کد

توضیح کد، یافتن خطا و پیشنهاد آزمون از سناریوهای ارزیابی مدل است. خروجی تولیدشده باید در محیط آزمایشی بررسی شود و پیش از اجرا، بازبینی انسانی داشته باشد.

03

برآورد مصرف واقعی

برای یک مجموعه درخواست ثابت، حجم ورودی، طول پاسخ، زمان پاسخ و مصرف اعتبار را ثبت کنید. مقایسهٔ هزینه با تعداد درخواست به‌تنهایی کافی نیست.

راهنمای اتصال API

شروع استفاده از API Grok در ابر آراد

مدل، ورودی و معیار پذیرش را مشخص کنید؛ سپس اتصال را با یک نمونه محدود آزمایش کنید.

01
آماده‌سازی

تناسب نسخه با متن یا کد

شناسه مدل و فرمت درخواست را از پنل بردارید؛ ورودی آزمایش نباید حاوی داده حساس باشد.

02
پیکربندی

کیفیت خروجی فارسی و ساختاریافته

کیفیت خروجی و مصرف توکن را روی یک نمونه واقعی بسنجید و نتیجه قابل‌قبول را تعریف کنید.

03
اعتبارسنجی

زمان پاسخ و مصرف در بار واقعی

کلید API را در Backend نگه دارید و مدیریت خطا، سقف مصرف و بازبینی خروجی را در محصول لحاظ کنید.

نحوه کار API

مسیر اتصال به Grok

لوگوی Grok
Grokدرخواست شما ← پردازش مدل ← پاسخ در محصول
مثال نمایشی
۱
درخواست۱. درخواست را از برنامه بفرستید
۲
پردازش مدل۲. مدل درخواست را پردازش می‌کند
۳
دریافت پاسخ۳. پاسخ را در محصول بررسی کنید
درخواست شمانمونه ورودی

این جمله را رسمی‌تر کن: «فایلت رسید، نگاهش می‌کنیم.»

پاسخ مدلنمونه پاسخ

فایل شما دریافت شد و بررسی خواهد شد.

کیفیتزمان پاسختوکن
پایداری، امنیت و نگه‌داری

از یک پاسخ موفق تا استفاده قابل‌کنترل

۱

بودجه مصرف و خطا

مصرف Grok را به تفکیک ورودی، خروجی و قابلیت محصول ثبت کنید. برای درخواست‌های ناموفق و تلاش مجدد نیز سقف بگذارید؛ یک بسته بزرگ جایگزین کنترل مصرف نیست.

۲

داده و دسترسی

کلید API را محرمانه نگه دارید، محتوای حساس را در لاگ ثبت نکنید و پیش از ارسال داده مشتری، شرایط پردازش و نگه‌داری داده را بررسی کنید.

۳

کیفیت در طول زمان

برای تناسب نسخه با متن یا کد مجموعه آزمون ثابت داشته باشید. تغییر مدل یا دستورها را روی همان نمونه‌ها بسنجید و پیش از انتشار نتیجه را با نسخه قبل مقایسه کنید.

راهنمای انتخاب و هزینه

هزینه API Grok را چطور برآورد کنیم؟

هزینه را برای رسیدن به خروجی قابل‌قبول بسنجید؛ قیمت واحد توکن فقط یکی از معیارهای انتخاب مدل است.

مقایسه بسته‌های توکن ←
01Quality

کیفیت خروجی

تناسب نسخه با متن یا کد

برای «دستیار محتوایی و پاسخ‌گویی» پاسخ مرجع تعریف کنید و نتیجه را با همان معیار بسنجید.

02Latency

زمان پاسخ

کیفیت خروجی فارسی و ساختاریافته

زمان اولین پاسخ و دریافت خروجی کامل را جداگانه بررسی کنید.

03Tokens

هزینه مصرف

توکن‌های ورودی و خروجی

تعداد درخواست، طول زمینه و تکرار خطا بر مصرف کل بسته اثر می‌گذارند.

04API

سازگاری با محصول

زمان پاسخ و مصرف در بار واقعی

فرمت خروجی و قابلیت‌های نسخه منتخب باید با مسیر اتصال شما هماهنگ باشند.

بسته‌های اعتبار Grok

مدل‌ها و قیمت Grok

پلن‌ها و قیمت‌های زیر از کاتالوگ عمومی درگاه آراد دریافت و فقط برای همین خانواده نمایش داده می‌شوند. اعتبار، ضرایب مصرف، مدت اعتبار و شرایط نهایی سفارش را پیش از خرید بررسی کنید.

سه گام تا اتصال محصول

مراحل اتصال به Grok

از اولین درخواست تا آماده‌سازی انتشار، مسیر را با اسکرول دنبال کنید.

۱مرحله در حال نمایش از ۳ مرحله
  1. اتصال اولیه
  2. کیفیت و مصرف
  3. آمادگی انتشار
گام اول

اتصال اولیه

مدل و دسترسی API را مشخص کنید.

یک درخواست آزمایشی از Backend بفرستید و ساختار پاسخ را بررسی کنید.

گام دوم

کیفیت و مصرف

پاسخ را با نیاز محصول بسنجید.

نمونه «دستیار محتوایی و پاسخ‌گویی» را از نظر کیفیت، زمان پاسخ و مصرف توکن ارزیابی کنید.

گام سوم

آمادگی انتشار

کلید و مسیرهای خطا را کنترل کنید.

کلید API را در کد عمومی قرار ندهید و برای خطا یا قطع ارتباط، پاسخ مناسب در نظر بگیرید.

آیا هر نسخه برای همهٔ وظایف مناسب است؟

لزومی ندارد. ارزیابی باید روی وظیفه نهایی انجام شود؛ کیفیت تکمیل کد، گفت‌وگو و استخراج اطلاعات را با آزمون‌های جدا مقایسه کنید.

کدام نسخه‌های این خانواده در دسترس هستند؟

فهرست نسخه‌ها و وضعیت دسترسی را در پنل هوش مصنوعی بررسی کنید. قبل از اتصال اصلی، یک درخواست آزمایشی با همان شناسه مدل ارسال کنید.

چطور هزینه استفاده را تخمین بزنم؟

طول ورودی و خروجی، تعداد درخواست‌ها، نسخه مدل و تعرفه همان مسیر ارائه را در نظر بگیرید. مصرف یک نمونه واقعی را اندازه بگیرید و برای تکرار درخواست‌ها نیز بودجه لحاظ کنید.

آیا می‌توان داده حساس را مستقیماً به مدل فرستاد؟

پیش از ارسال، مجوز دسترسی و سیاست پردازش و نگه‌داری داده سرویس را بررسی کنید. داده غیرضروری را حذف یا ناشناس‌سازی کنید و کلید خصوصی API را در مرورگر قرار ندهید.

انتخاب مدل و بسته توکن

برای اتصال Grok به محصولتان آماده‌اید؟

کاربرد موردنظر، حجم درخواست و بودجه مصرف را مطرح کنید تا گزینه‌های Grok و بسته مناسب را بررسی کنیم.

راهنمای جامع Grok

راهنمای کامل انتخاب، قیمت و اتصال به API Grok

در این راهنما با کاربردهای مدل، ارزیابی کیفیت پاسخ، هزینه توکن و مراحل اتصال امن به محصول آشنا می‌شوید.

مطالعه بیشتربستن راهنما

Grok برای پاسخ‌گویی و پیش‌نویس محتوا

برای یک دستیار متنی، وظیفه را به خلاصه‌سازی، دسته‌بندی یا پاسخ‌گویی تفکیک کنید. دستور، لحن و موارد ممنوع را روشن بنویسید و چند نمونهٔ مطلوب ارائه دهید. خروجی روان به معنی صحت اطلاعات نیست؛ ادعای تجاری، عدد و ارجاع را پیش از انتشار بررسی کنید. در موضوع حساس، تأیید انسانی بخشی از جریان محصول بماند.

ارزیابی کمک به توسعه و بررسی کد

توضیح کد، یافتن خطا و پیشنهاد آزمون را با یک مجموعه وظیفهٔ ثابت بسنجید. نتیجهٔ پیشنهادی باید در محیط آزمایشی اجرا شود، نه مستقیم روی سرویس اصلی. از مدل انتظار دسترسی به مخزن، ابزار یا اینترنت نداشته باشید مگر مسیر اتصال همان قابلیت را صریحاً تأیید کرده باشد. صحت آزمون را کنار زمان پاسخ و مصرف ثبت کنید.

کیفیت فارسی و رعایت دستور

نمونه‌های واقعی با اصطلاح تخصصی، عدد و متن ترکیبی فارسی و انگلیسی آماده کنید. حفظ معنا، رعایت قالب و تشخیص درخواست خارج از دامنه را جدا امتیاز بدهید. تغییر یک دستور می‌تواند پاسخ را تغییر دهد؛ مجموعهٔ آزمون را نگه دارید تا مقایسهٔ نسخه‌ها بر پایهٔ یک پاسخ اتفاقی نباشد. برای پاسخ نامطمئن، مسیر جایگزین داشته باشید.

هزینهٔ بسته و مصرف در درخواست واقعی

برای برآورد هزینه، اعتبار وزنی بسته را از تعداد خام توکن جدا کنید. ضرایب ورودی و خروجی، سقف خروجی و مدت اعتبار هر پلن از API می‌آیند. طول زمینه، پاسخ و تلاش‌های مجدد بر مصرف اثر می‌گذارند؛ یک میلیون اعتبار الزاماً به معنی یک میلیون توکن خروجی نیست. مقدار و قیمت جاری را در بخش مدل‌ها و قیمت بررسی کنید و شرایط نهایی سفارش را در پنل ببینید.

اتصال امن Grok در برنامه

کلید API را در Backend نگه دارید و مدل و فرمت درخواست را از مستندات اتصال فعال بردارید. برای خطا، محدودیت نرخ و قطع ارتباط رفتار مشخص تعریف کنید. دادهٔ حساس را فقط با مجوز و مطابق سیاست پردازش ارسال کنید؛ متن کامل مشتری را بدون ضرورت در لاگ نگه ندارید. سقف تلاش مجدد از مصرف کنترل‌نشده جلوگیری می‌کند.

از پایلوت تا استفادهٔ مستمر

پس از آزمون محدود، کیفیت، زمان پاسخ، خطا و مصرف را در بازه‌های مشخص بررسی کنید. تغییر نسخه یا تنظیمات باید دوباره از آزمون پذیرش عبور کند. برای مقایسه با خانوادهٔ دیگر، داده و معیار یکسان لازم است. هزینهٔ هر نتیجهٔ پذیرفتنی را کنار قیمت واحد ببینید و پیش از انتشار، هشدار بودجه و روش بازگشت را تعیین کنید.