راهنمای یکپارچه‌سازی API Grok

چرا از یک جایگزین API Grok بدون فیلتر استفاده کنیم؟

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

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

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

خدمات ما به صورت مستقل عمل می‌کند. ما Grok یا هیچ مدل دیگری از فروشندگان را ارائه نمی‌دهیم. ما یک مدل زبانی بزرگ (LLM) بدون سانسور متمایز ارائه می‌دهیم. این مدل روی سرورهای خودمان اجرا می‌شود. رابط کاربری برای کاربران OpenAI آشنا باقی می‌ماند.

مزایای کلیدی

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

درک ساختار نقطه پایانی API

دو نقطه پایالی تمام تعاملات را مدیریت می‌کنند: POST /v1/chat/completions و GET /v1/models. این‌ها از مشخصات استاندارد API OpenAI پیروی می‌کنند. شما یک پیکربندی JSON با پیام‌های سیستم و کاربر خود ارسال می‌کنید. سرور یک پاسخ JSON با متن تولید شده برمی‌گرداند.

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

URL پایه ما HTTPS://api.isgrokunfiltered.com/v1 است. این URL پیش‌فرض OpenAI را در پیکربندی مشتری شما جایگزین می‌کند. شناسه مدلی که باید ارسال شود "uncensored" است. این تضمین می‌کند که به سرور درست متصل می‌شوید.

احراز هویت از یک توکن Bearer در هدر Authorization استفاده می‌کند. کلید API خود را مستقیماً شامل کنید. به جریان‌های پیچیده OAuth نیازی نیست. این سادگی زمان یکپارچه‌سازی را به طور قابل توجهی کاهش می‌دهد.

خلاصه نقاط پایانی

روش	مسیر	Function
POST	/v1/chat/completions	پاسخ‌های متنی تولید می‌کند
GET	/v1/models	Lists available models

پیکربندی مشتری شما برای استریم

با تنظیم پارامتر stream روی true در بدنه درخواست، قابلیت streaming را فعال کنید. این کار به جای یک شیء JSON واحد، رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. هر رویداد شامل یک قطعه ناقص از پاسخ است. می‌توانید متن را به صورت بلادرسان به کاربران نمایش دهید.

استریمینگ تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. کاربران خروجی را همان‌طور که تولید می‌شود می‌بینند. این تجربه را برای رابط‌های شبیه چت بهبود می‌بخشد. همچنین به شما امکان می‌دهد درخواست‌ها را در صورت نیاز زودتر لغو کنید.

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

فرمت SSE را به درستی مدیریت کنید. هر خطی که با "data: " شروع می‌شود را تجزیه کنید. رویداد نهایی "[DONE]" را نادیده بگیرید. این تضمین می‌کند که برنامه شما هر توکن را به درستی پردازش می‌کند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.isgrokunfiltered.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

مدیریت فراخوانی‌های تابع در حالت uncensored

فراخوانی تابع به برنامه شما امکان اجرای کد بر اساس خروجی مدل را می‌دهد. لیستی از ابزارها را در درخواست ارسال کنید. مدل یک آرایه tool_calls به جای متن ساده برمی‌گرداند. کد شما تابع را اجرا می‌کند و نتیجه را ارسال می‌کند.

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

استفاده از حالت JSON برای اعمال قالب‌های خروجی دقیق. response_format را روی json_object تنظیم کنید. مدل فقط JSON معتد برمی‌گرداند. این خطاهای تجزیه را در بک‌اند شما کاهش می‌دهد. ساختارهای داده ثابت را تضمین می‌کند.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.isgrokunfiltered.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

بهینه‌سازی هزینه‌های توکن برای زمینه‌های طولانی

پنجره زمینه تا ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. این شامل هم ورودی و هم خروجی است. زمینه‌های طولانی‌تر اعتبار پیش‌پرداخت بیشتری مصرف می‌کنند. استفاده توکن خود را برای جلوگیری از هزینه‌های غیرمنتظره نظارت کنید.

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

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

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

جزئیات قیمت‌گذاری

• ورودی: ۰.۱۵ دلار / ۱M توکن
• خروجی: $۰.۵۰ / ۱M توکن
• حداکثر خروجی: 16,000 توکن
• پنجره زمینه: ۱۰۰,۰۰۰ توکن

تنظیمات همزمانی محدودیت نرخ

هر کلید API اجازه ۳۰۰ درخواست در دقیقه را می‌دهد. این محدودیت به طور جهانی برای کلید شما اعمال می‌شود. برنامه‌های با فرکانس بالا باید نرخ درخواست خود را به دقت مدیریت کنند. تجاوز از محدودیت خطای ۴۲۹ Too Many Requests را برمی‌گرداند.

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

حداکثر اندازه بدنه درخواست ۸ مگابایت است. بارهای کاری بزرگ با تاریخچه گسترده ممکن است از این محدودیت فراتر روند. ورودی خود را فشرده کنید یا پیام‌های قدیمی را حذف کنید. این تضمین می‌کند که درخواست‌های شما با موفقیت پردازش شوند.

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

Copycurl https://api.isgrokunfiltered.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
  }'

مهاجرت کلیدهای API Grok موجود شما

مهاجرت به API ما نیاز به تغییر آدرس پایه و شناسه مدل دارد. ساختار کد کلاینت موجود شما تا حد زیادی بدون تغییر باقی می‌ماند. آدرس پایه را به HTTPS://api.isgrokunfiltered.com/v1 به‌روز کنید. شناسه مدل را به "uncensored" تغییر دهید.

عیب‌یابی خطاهای رایج یکپارچه‌سازی

خطاهای 401 Unauthorized نشان‌دهنده کلید API نامعتبر یا منقضی شده است. کلید خود را در داشبورد بررسی کنید. اطمینان حاصل کنید که آن را در هدر Authorization ارسال می‌کنید. به دنبال فاصله‌های ابتدایی یا غلط‌های املایی بگردید.

خطای 429 Too Many Requests به معنای رسیدن به محدودیت نرخ است. فرکانس درخواست‌های خود را کاهش دهید یا فاصله بین تماس‌ها را افزایش دهید. برای تلاش مجدد از بازگشت نمایی استفاده کنید. این از بارگذاری بیش از حد سرور جلوگیری می‌کند.

خطای 400 Bad Request اغلب ناشی از JSON نامعتبر است. اطمینان حاصل کنید که payload شما با طرح مورد انتظار مطابقت دارد. به دنبال فیلدهای ضروری گمشده مانند messages یا model بگردید. از endpoint GET برای بررسی موجود بودن مدل استفاده کنید.

خطاهای ۵۰۰ Internal Server Error نادر اما ممکن هستند. درخواست را پس از یک تأخیر کوتاه دوباره امتحان کنید. اگر مشکل ادامه داشت، با پشتیبانی تماس بگیرید. لاگ‌های ما می‌توانند به سرعت علت ریشه‌ای را شناسایی کنند.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

مراحل بعدی: تست مدل بدون سانسور شما

با یک درخواست تولید متن ساده شروع کنید. یک پرامپت کوتاه ارسال کنید و فرمت پاسخ را تأیید کنید. بررسی کنید که جریان‌دهی به درستی کار می‌کند. اطمینان حاصل کنید که فراخوانی تابع با کد شما به روانی یکپارچه می‌شود.

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

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

با گوگل یا ایمیل ثبت‌نام کنید. کلید API خود را فوراً دریافت کنید. نیاز به شماره تلفن نیست. بلافاصله تست را با $0.50 اعتبار آزمایشی شروع کنید. این راهی بدون ریسک برای ارزیابی سرویس است.