شروع سریع: اتصال SDK شما
نقطه پایانی فعلی خود را با URL پایه ما جایگزین کنید و کلید API خود را به هدر تزریق کنید. این جابجایی ساده درخواست‌های شما را بلافاصله به مدل بدون سانسور هدایت می‌کند.
آدرس پایه https://api.geminisenzacensura.com/v1. احراز هویت به یک توکن Bearer که در Authorization header. این کلید را بلافاصله پس از ثبت‌نام با گوگل یا ایمیل ایجاد می‌کنید.
- بدون نیاز به کتابخانه‌های اضافی.
- با هر مشتری سازگار با OpenAI کار می‌کند.
- دسترسی فوری پس از ایجاد کلید.
این رویکرد واسط‌های پراکسی و تنظیمات محلی پیچیده را حذف می‌کند.
curl https://api.geminisenzacensura.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the capital of Peru?"}]
}'نقطه پایانی: POST /v1/chat/completions
پرامپت خود را به نقطه پایانی تکمیل چت ارسال کنید تا خروجی متنی دریافت کنید. این نقطه پایانی واحد تمام استنتاج برای مدل بدون سانسور را مدیریت می‌کند.
شناسه مدل را به عنوان "uncensored" در بدنه درخواست خود مشخص کنید. API پاسخ‌های JSON استاندارد حاوی متن تولید شده را برمی‌گرداند. می‌توانید رفتار را با پارامترهایی مانند کنترل کنید temperature یا top_p.
ورودی وارد می‌شود، متن خارج می‌شود. اینجا امبدینگ یا تولید تصویر وجود ندارد.
from openai import OpenAI
client = OpenAI(base_url="https://api.geminisenzacensura.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)نقطه پایانی: GET /v1/models
این نقطه پایانی را برای بررسی اتصال و فهرست مدل‌های موجود فراخوانی کنید. این یک شیء JSON شامل جزئیات مدل برمی‌گرداند.
از این روش برای تأیید اینکه کلید API شما مجوزهای معتبر دارد، پیش از ارسال payloadهای سنگین استفاده کنید. پاسخ تأیید می‌کند که مدل با شناسه "uncensored" فعال است.
این یک بررسی سبک است که حداقل توکن مصرف می‌کند.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.geminisenzacensura.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);پارامترها: دما، Top-p و Tools
تصادفی بودن و ساختار را با پارامترهای استاندارد OpenAI کنترل کنید. تنظیم temperature برای تنوع خلاقانه یا top_p برای نمونه‌گیری هسته.
فعال‌سازی فراخوانی تابع با ارسال یک tools آرایه. مدل حالت JSON را از طریق response_format: {"type": "json_object"}. همچنین می‌توانید stop sequences و یک seed برای تکرارپذیری.
این پارامترها کنترل دقیقی بر خروجی هوش مصنوعی بدون سانسور به شما می‌دهند بدون اینکه نیاز به منطق سفارشی باشد.
پاسخ‌های استریم و مصرف توکن
استریمینگ را با تنظیم 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)کدهای خطا و محدودیت‌ها
خطاها را با بررسی کد وضعیت HTTP به شیوه‌ای مناسب مدیریت کنید. یک 401 کلید API نامعتبر یا منقضی شده را نشان می‌دهد. یک 402 به این معنی است که اعتبار پیش‌پرداخت کافی ندارید. یک 429 نشان می‌دهد که به محدودیت نرخ رسیده‌اید.
محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید است. اندازه بدنه درخواست به ۸ مگابایت محدود است. خطاها و رد شدن‌ها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند، اطمینان حاصل می‌کند که فقط بابت مصرف واقعی توکن‌ها پرداخت می‌کنید.
بدنه پاسخ را برای یک پیام خطای دقیق جهت عیب‌یابی سریع بررسی کنید.
