مستندات API: یکپارچه‌سازی مدل uncensored

شروع سریع: ارسال اولین درخواست خود

سریع‌ترین راه برای تأیید اتصال، یک درخواست تکمیل (completion) واحد است. کلید جایگزین را با اعتبارنامه‌های خود جایگزین کنید و کلاینت را به URL پایه ما هدایت کنید. مدل بلافاصله بدون فیلتر محتوایی برای ورودی‌های قانونی پاسخ می‌دهد.

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

Copycurl https://api.howtouncensorgemini.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the pros and cons of the current model."}]
  }'

احراز هویت و URL پایه

API ما از احراز هویت استاندارد Bearer token استفاده می‌کند. باید کلید API منحصر به فرد خود را در هدر Authorization هر درخواست وارد کنید. URL پایه HTTPS://api.howtouncensorgemini.com/v1 است. این اندپوینت با هر SDK OpenAI سازگار است.

هنگام استفاده از SDK پایتون، تنها نیاز است که URL پایه و api_key را به‌روزرسانی کنید. بقیه پارامترها دقیقاً مشابه ساختار رسمی OpenAI باقی می‌مانند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.howtouncensorgemini.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)

نقطه پایانی تکمیل چت

تمام تعاملات از طریق endpoint /v1/chat/completions انجام می‌شود. شما لیستی از پیام‌ها را ارسال می‌کنید و یک پاسخ متنی دریافت می‌کنید. شناسه مدل همیشه "uncensored" است. این مدل واحد تمام نیازهای تولید شما را بدون منطق مسیریابی مدیریت می‌کند.

اگر ترجیح می‌دهید از جاوااسکریپت استفاده کنید، SDK نود (Node) به تنظیمات کمی نیاز دارد. آدرس پایه را تنظیم کنید و کلید خود را ارسال کنید. کتابخانه درخواست‌های HTTP را به صورت خودکار مدیریت می‌کند.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howtouncensorgemini.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);

پارامترها و ویژگی‌های پشتیبانی‌شده

ما از پارامترهای استاندارد مانند temperature، top_p و دنباله‌های stop پشتیبانی می‌کنیم. می‌توانید با استفاده از response_format، حالت JSON را اعمال کنید. فراخوانی ابزار (Tool calling) برای یکپارچه‌سازی تابع کاملاً پشتیبانی می‌شود. این ویژگی‌ها دقیقاً همان‌طور که در مشخصات OpenAI مستند شده است کار می‌کنند.

فیلد مدل را در هر درخواست روی "uncensored" تنظیم کنید. این تضمین می‌کند که همیشه به موتور استنتاج صحیح متصل می‌شوید. سیستم پارامترهای پشتیبانی‌نشده را به صورت خودکار نادیده می‌گیرد.

استریمینگ و استفاده از توکن

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

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

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)

محدودیت‌ها، خطاها و زمینه

پنجره زمینه ۱۰۰,۰۰۰ توکن در مجموع است. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست خروجی بگیرید. محدودیت نرخ ۳۰۰ درخواست در دقیقه است. خطای 401 یعنی کلید شما نامعتبر است. خطای 402 نشان‌دهنده اعتبار ناکافی است. خطای 429 یعنی به محدودیت نرخ رسیده‌اید.