شروع سریع: اتصال کلاینت شما
درخواست‌ها را به https://api.isgeminiuncensored.com/v1 با استفاده از SDKهای استاندارد OpenAI. سرویس ما به عنوان یک جایگزین بدون تغییر برای سایر ارائه‌دهندگان عمل می‌کند، بنابراین شما فقط نیاز به به‌روزرسانی URL پایه و ارائه کلید API خود دارید. می‌توانید کلید خود را به طور فوری از طریق داشبورد با استفاده از Google یا ایمیل ایجاد کنید. این پیکربندی نیاز به پروکسی‌سازی پیچیده یا پرامپت‌های jailbreak سفارشی را از بین می‌برد.
احراز هویت به یک کلید API فعال واحد برای هر حساب متکی است. اگر کلید جدیدی تولید کنید، کلید قبلی بلافاصله نامعتبر می‌شود. این امر کنترل دقیق بر استفاده شما را در حالی که حریم خصوصی داده‌های شما را حفظ می‌کند، تضمین می‌کند. پرامپت‌های شما برای آموزش استفاده نمی‌شوند، بنابراین آثار خلاقانه شما متعلق به خود شما باقی می‌ماند.
اولین درخواست: مثال curl
اتصال خود را با ارسال یک درخواست تکمیل متن ساده بررسی کنید. از endpoint استاندارد تکمیل چت با شناسه مدل uncensored. پاسخ بر اساس ورودی شما متن تولید شده را بدون ردی‌های محتوایی استاندارد بازگردانی می‌کند.
این آزمایش پایه تأیید می‌کند که کلید شما معتبر است و اندپوینت قابل دسترسی است. سپس می‌توانید این الگو را در منطق برنامه خود ادغام کنید. ساختار پاسخ با فرمت OpenAI مطابقت دارد که سازگاری با اکثر ابزارهای موجود را تضمین می‌کند.
curl https://api.isgeminiuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five Linux commands for network troubleshooting."}]
}'با پرامپت‌های ساده شروع کنید تا کیفیت خروجی را بررسی کنید. سپس می‌توانید به تعاملات پیچیده‌تر در صورت نیاز مقیاس دهید. سیستم مدیریت زمینه را برای شما انجام می‌دهد.
یکپارچه‌سازی SDK Python
از کتابخانه رسمی پایتون برای یکپارچه‌سازی API ما در اسکریپت‌های خود استفاده کنید. URL پایه را به اندپوینت ما تنظیم کنید و کلید API خود را ارائه دهید. این رویکرد به شما امکان می‌دهد از کدهای موجود با حداقل تغییرات استفاده کنید. می‌توانید بسته به نیازهای خود از استریم یا فراخوانی‌های سینک استفاده کنید.
SDK Python سریال‌سازی درخواست‌های شما را به صورت خودکار مدیریت می‌کند. می‌توانید پارامترهایی مانند temperature و top_p را برای کنترل خروجی ارسال کنید. این انعطاف‌پذیری به شما اجازه می‌دهد رفتار مدل را برای مورد استفاده خاص خود تنظیم کنید. چه یک چت‌بات بسازید و چه یک ابزار تحلیل، SDK این فرآیند را ساده می‌کند.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgeminiuncensored.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)اطمینان حاصل کنید که شیء‌های پاسخ را به درستی مدیریت می‌کنید. SDK داده‌های ساختاریافته‌ای برمی‌گرداند که به راحتی قابل تجزیه است. این کار اشکال‌زدایی و تست را ساده می‌کند. همچنین می‌توانید از کلاینت‌های async برای برنامه‌های با ظرفیت بالا استفاده کنید.
یکپارچه‌سازی Node SDK
با برنامه‌های Node.js با استفاده از پکیج رسمی npm OpenAI ادغام کنید. کلاینت را به URL پایه ما پوینت کنید و کلید API را تنظیم کنید. این به شما اجازه می‌دهد از الگوهای آشنا در پروژه‌های JavaScript خود استفاده کنید. می‌توانید درخواست‌های سینک یا آسنکرون را به راحتی انجام دهید.
SDK Node از ویژگی‌های مدرن جاوااسکریپت مانند promise و async/await پشتیبانی می‌کند. این باعث می‌شود مدیریت خطا و پردازش پاسخ تمیز باشد. می‌توانید همان پارامترهایی را که در SDK Python ارسال می‌کنید، برای تنظیم رفتار مدل ارسال کنید. این ثبات در زبان‌ها منحنی یادگیری تیم‌هایی را که از فناوری‌های چندگانه استفاده می‌کنند، کاهش می‌دهد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgeminiuncensored.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);یکپارچه‌سازی خود را با یک پرس‌و‌جوی ساده آزمایش کنید. پاسخ تأیید خواهد کرد که تنظیمات شما صحیح است. سپس می‌توانید به ساخت تعاملات پیچیده‌تر بپردازید. SDK درخواست‌های HTTP را به‌کارایی مدیریت می‌کند و تأخیر کم را تضمین می‌کند.
پاسخ‌های استریم
با تنظیم stream پارامتر را true تنظیم کنید. این به شما امکان می‌دهد توکن‌ها را همان‌طور که تولید می‌شوند دریافت کنید. این ویژگی برای رابط‌های چت که در آن‌ها بازخورد فوری حیاتی است، ایده‌آل است. این موضوع تأخیر ادراک‌شده را برای کاربر نهایی به‌طور قابل‌توجهی کاهش می‌دهد.
پاسخ به صورت دنباله‌ای از رویدادهای ارسالی سرور (SSE) تحویل داده می‌شود. هر قطعه حاوی بخشی از متن تولید شده است. می‌توانید این قطعات را به هم متصل کنید تا پاسخ کامل را تشکیل دهید. قطعه نهایی همچنین شامل آمار مصرف توکن برای صورتحساب است.
stream = 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)قطعیات شبکه را به‌صورت ایمن مدیریت کنید. پخش می‌تواند بسته به قابلیت‌های کلاینت شما متوقف یا ادامه یابد. این انعطاف‌پذیری تجربه کاربری روانی را حتی در اتصالات ناپایدار تضمین می‌کند. می‌توانید پخش را زودتر متوقف کنید اگر کاربر ورودی خود را تغییر دهد.
محدودیت‌ها، خطاها و زمینه
حساب شما دارای محدودیت نرخ 300 درخواست در دقیقه و 8 درخواست همزمان به ازای هر کلید است. اگر این محدودیت را تجاوز کنید، خطای 429 دریافت خواهید کرد. می‌توانید استفاده خود را در داشبورد مانیتور کنید تا از وقفه‌ها جلوگیری کنید. این محدودیت دسترسی عادلانه را برای همه کاربران تضمین می‌کند.
پشتیبانی از پنجره زمینه تا ۱۰۰,۰۰۰ توکن برای prompt و completion ترکیبی است. می‌توانید حداکثر خروجی را ۱۶,۰۰۰ توکن در هر درخواست تنظیم کنید. اگر حدی مشخص نکنید، پیش‌فرض ۲,۰۴۸ توکن است. خطاها و رد شدن‌ها اعتبار از پیش پرداخت شده شما را مصرف نمی‌کنند.
خطاهای رایج شامل 401 برای کلیدهای نامعتبر و 402 برای اعتبار ناکافی است. می‌توانید فقط با ارز دیجیتال شارژ کنید. USDT روی TRC20 یا USDC روی Base پذیرفته می‌شوند. اشتباهاتی مانند شارژهای مضاعف از طریق پشتیبانی رفع می‌شوند. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود، بنابراین می‌توانید با سرعت خود شارژ کنید. این ساختار هزینه‌ها را قابل پیش‌بینی و شفاف نگه می‌دارد.
