Grok api: بدون سانسور راهنما برای توسعه‌دهندگان

API grok چیست؟

API grok یک سرویس مستقل است که یک مدل زبانی بزرگ بدون سانسور را از طریق یک رابط REST استاندارد در معرض قرار می‌دهد. این مدل Grok انحصاری xAI را ارائه نمی‌دهد. در عوض، یک مدل وزن‌باز را اجرا می‌کند که برای پاسخ دادن به موضوعات بحث‌برانگیز، بزرگسالان یا تخصصی بدون امتناع‌های معمولی که در جایگزین‌های تجاری یافت می‌شود تنظیم شده است. متن را ارسال می‌کنید. متن دریافت می‌کنید. embedding، تولید تصویر یا endpoint‌های fine-tuning برای پیچیدگی وجود ندارد.

بسیاری از توسعه‌دهندگان به دنبال راهی بدون محدودیت برای پردازش داده‌ها بدون لایه‌های نظارت شرکتی هستند که با خروجی آن‌ها تداخل ایجاد کند. این API آن تجربه را ارائه می‌دهد. این سرویس برای توسعه‌دهندگانی طراحی شده است که می‌خواهند بر پنجره زمینه و تاریخچه پرامپت خود کنترل داشته باشند. سرویس بر اساس سیستم اعتبار پیش‌پرداخت عمل می‌کند. شما با ارز دیجیتال شارژ می‌کنید و اعتبارها منقضی نمی‌شوند. خطاها در درخواست‌های شما موجودی شما را مصرف نمی‌کنند. شما فقط برای توکن‌هایی که با موفقیت پردازش می‌شوند پرداخت می‌کنید.

مدل روی زیرساخت اختصاصی میزبانی می‌شود. منابع را با لایه‌های مصرف‌کننده عمومی به اشتراک نمی‌گذارد. این یعنی تأخیر ثابتی دریافت می‌کنید. سیستم برای توسعه‌دهندگانی ساخته شده است که دسترسی مستقیم را به داشبوردهای مدیریت‌شده ترجیح می‌دهند. پاسخ JSON خام را دریافت می‌کنید. شما قالب‌بندی را مدیریت می‌کنید. این رویکرد رابط کاربری را برای گردش کارهای خودکار تمیز و قابل پیش‌بینی نگه می‌دارد.

چرا یک مدل بدون سانسور انتخاب کنیم؟

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

• لحن روایی را در نویسندگی خلاق حفظ کنید بدون تغییرات ناگهانی سبک.
• پاسخ‌های فنی دقیق بدون محرک‌های رد کردن برای موضوعات تخصصی دریافت کنید.
• داده‌های بحث‌برانگیز را بدون مراحل فیلتر دستی پس‌پردازش کنید.

برخی کاربران نگران کیفیت مدل‌های بدون محدودیت هستند. آن‌ها اغلب عملکردی قابل مقایسه با مدل‌های تجاری رده بالا دارند. تفاوت در تمایل به پاسخگویی است. شما تمام قابلیت‌های مدل پایه را دریافت می‌کنید. شما فقط لایه اضافی اجرای خط‌مشی محتوا را از دست می‌دهید. این موضوع مدل LLM بدون سانسور را برای کاربران حرفه‌ای که دقیقاً می‌دانند چه می‌خواهند، ایده‌آل می‌کند. این مدل همچنین برای کاربردهای LLM NSFW که به تولید قابل اعتماد بدون سانسور مداوم نیاز دارند، عالی است.

راه‌اندازی کلاینت شما

تنظیم کلاینت شما بسیار ساده است زیرا سرویس از ساختار نقطه پایانی سازگار با OpenAI استفاده می‌کند. شما فقط باید base URL را به‌روزرسانی کرده و کلید API خود را ارائه دهید. شناسه مدل روی "uncensored" تنظیم می‌شود. این بدان معناست که اسکریپت‌های Python یا Node.js موجود شما احتمالاً فقط به دو خط پیکربندی نیاز دارند. نیازی به بازنویسی کل پایپ‌لاین یکپارچه‌سازی شما نیست.

ابتدا یک حساب در داشبورد ایجاد کنید. می‌توانید با گوگل وارد شوید یا از ایمیل و رمز عبور استاندارد استفاده کنید. سیستم بلافاصله یک کلید API تولید می‌کند. شماره تلفن لازم نیست. آن کلید را کپی کنید. آن را در متغیرهای محیطی خود قرار دهید. سپس SDK خود را به URL پایه جدید پوینت کنید. نقطه پایانی HTTPS://api.groklimity.com/v1 است. این با هر کتابخانه‌ای که از مشخصات API OpenAI پشتیبانی می‌کند کار می‌کند.

شناسه مدل یک رشته ساده است. آن را در بدنه درخواست ارسال می‌کنید. سیستم اشیاء JSON استاندارد را برمی‌گرداند. آمار مصرف را در هدرهای پاسخ دریافت می‌کنید. این ثبات به شما امکان می‌دهد در صورت نیاز، ارائه‌دهنده را تغییر دهید. می‌توانید اتصال را با یک درخواست تکمیل ساده آزمایش کنید. بررسی کنید که مدل با توکن‌های مورد انتظار پاسخ می‌دهد. سپس آن را به منطق اصلی برنامه خود ادغام کنید.

مدیریت پاسخ‌های جریان‌سازی

پاسخ‌های استریم به شما امکان می‌دهند خروجی را توکن به توکن همان‌طور که تولید می‌شود نمایش دهید. این موضوع تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد. سرویس از رویدادهای ارسالی سرور (SSE) در endpoint تکمیل‌های چت پشتیبانی می‌کند. شما یک جریان از قطعات دریافت می‌کنید. هر قطعه شامل یک قطعه از پاسخ است. قطعه نهایی شامل کل مصرف توکن برای درخواست است.

یک پردازنده جریان در کد کلاینت خود پیاده‌سازی کنید. به رویدادهای data گوش دهید. هر توکن را به یک بافر بچسبانید. رابط کاربری را در زمان واقعی به‌روز کنید. این برای رابط‌های چت که کاربران انتظار بازخورد فوری دارند ضروری است. ویژگی جریان‌دهی با تمام پارامترهای استاندارد مانند temperature و top_p کار می‌کند. همچنین می‌توانید آن را با فراخوانی تابع استفاده کنید.

مراقب باشید که استریم کردن مدل قیمت‌گذاری را تغییر نمی‌دهد. شما همچنان برای کل توکن‌های پردازش‌شده پرداخت می‌کنید. استریم فقط یک مکانیزم تحویل است. هزینه را کاهش نمی‌دهد. با این حال، تجربه کاربری را به طور قابل توجهی بهبود می‌بخشد. اگر کاربر پشیمان شد، می‌توانید استریم را لغو کنید. توکن‌های استفاده شده تا آن نقطه همچنان شارژ می‌شوند. سیستم کارآمد است و خروجی‌های بزرگ را به خوبی مدیریت می‌کند. می‌توانید تا 16,000 توکن را در یک استریم درخواست کنید.

استفاده از Function Calling

فراخوانی تابع به مدل اجازه می‌دهد داده‌های JSON ساختاریافته‌ای تولید کند که برنامه شما می‌تواند آن‌ها را اجرا کند. شما مجموعه‌ای از ابزارها را با اسکیمای آن‌ها تعریف می‌کنید. مدل به جای متن ساده، با یک فراخوانی ابزار پاسخ می‌دهد. این برای ساخت عامل‌هایی که با APIها، پایگاه‌های داده یا خدمات خارجی تعامل دارند، حیاتی است. مدل uncensored این قابلیت را به خوبی مدیریت می‌کند. آن دقیقاً از دستورالعمل‌های اسکما پیروی می‌کند.

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

طرحواره JSON خود را معتبر کنید. مدل به طرحواره برای تولید استدلال‌های صحیح تکیه دارد. اشیاء تو درپیچیده به خوبی کار می‌کنند. جفت‌های کلید-مقدار ساده نیز پشتیبانی می‌شوند. می‌توانید از حالت JSON برای اجبار به یک قالب خروجی خاص استفاده کنید. این زمانی مفید است که داده‌های خالص بدون مکالمه اضافی نیاز دارید. قابلیت فراخوانی تابع قوی است و موارد مرزی را به خوبی مدیریت می‌کند. از چندین فراخوانی ابزار در یک پاسخ پشتیبانی می‌کند.

قیمت‌گذاری توکن و رمزارز

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

شارژ حساب‌ها از طریق ارز دیجیتال انجام می‌شود. می‌توانید از USDT در شبکه TRC20 یا USDC در شبکه Base استفاده کنید. حداقل مبلغ شارژ $20 است. حداکثر آن $500 است. می‌توانید هر مبلغ صحیحی در آن محدوده شارژ کنید. یک سیستم اعتبار هدیه وجود دارد. $50 شارژ کنید و ۵٪ هدیه بگیرید. $100 شارژ کنید و ۱۰٪ هدیه بگیرید. $200 شارژ کنید و ۱۵٪ هدیه بگیرید. این موضوع واریزی‌های بزرگ‌تر را تشویق می‌کند. هدیه به‌طور فوری به حساب شما اعمال می‌شود.

پرداخت کاملاً ارز دیجیتال است. این موضوع هزینه‌های زیرساخت را پایین نگه می‌دارد. همچنین برای توسعه‌دهندگان متمرکز بر حریم خصوصی جذاب است. شما می‌توانید با اعتبار آزمایشی رایگان ۰.۵۰ دلار شروع کنید. این اعتبار برای ۷ روز معتبر است. می‌توانید API را به‌طور کامل پیش از تعهد برای سرمایه واقعی آزمایش کنید. آزمایش برای هر شخص یک‌بار است. این راه خوبی برای تأیید تأخیر و کیفیت است.

محدودیت‌های نرخ و محدودیت‌ها

API محدودیت‌های نرخ سخت‌گیرانه‌ای را برای تضمین استفاده عادلانه اعمال می‌کند. شما مجاز به ۳۰۰ درخواست در دقیقه در هر کلید API هستید. می‌توانید ۸ درخواست همزمان به‌طور همزمان فعال داشته باشید. حداکثر اندازه بدنه درخواست ۸ مگابایت است. این برای بیشتر موارد استفاده کافی است. اگر نیاز به ارسال اسناد بزرگ دارید، می‌توانید آن‌ها را به قطعات تقسیم کنید. پنجره زمینه ۱۰۰,۰۰۰ توکن است. این شامل هم prompt و هم completion می‌شود. می‌توانید تا ۱۶,۰۰۰ توکن در خروجی درخواست دهید.

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

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

اشتباهات رایج

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

یک دام دیگر، نادیده گرفتن محدودیت‌های پنجره‌ی زمینه است. اگر پرامپتی ارسال کنید که بیش از 100,000 توکن باشد، درخواست شکست می‌خورد. باید ورودی خود را برش دهید یا از استراتژی پنجره لغزان استفاده کنید. سیستم به‌طور خودکار برش نمی‌دهد. شما باید این موضوع را در کد کلاینت خود مدیریت کنید. همچنین به یاد داشته باشید که حداکثر خروجی 16,000 توکن است. اگر پارامتر max_tokens را تنظیم نکنید، پیش‌فرض 2,048 است. این می‌تواند پاسخ‌های طولانی را قطع کند.

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

چک‌لیست تنظیم نهایی

قبل از انتشار، پیکربندی خود را بررسی کنید. URL پایه را بررسی کنید. اطمینان حاصل کنید که به HTTPS://api.groklimity.com/v1 اشاره می‌کند. بررسی کنید که شناسه مدل روی "uncensored" تنظیم شده است. تأیید کنید که کلید API شما صحیح است. یک درخواست تکمیل ساده را آزمایش کنید. فرمت پاسخ را بررسی کنید. اطمینان حاصل کنید که با انتظارات شما مطابقت دارد.

• تایید کنید که base URL صحیح است.
• شناسه مدل را روی "uncensored" تنظیم کنید.
• بررسی کنید که کلید API فعال است.
• یک پاسخ استریمی را تست کنید.
• مصرف توکن را در هدرها بررسی کنید.

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