مدل بدون سانسور را یکپارچه کنید

پیش‌نیازها و URL پایه

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

مشتری خود را به URL پایه ما هدایت کنید: https://api.censurasinllm.com/v1. این انتهای‌بند از SDKهای استاندارد OpenAI پشتیبانی می‌کند. پیکربندی کلاینت خود را برای استفاده از این URL پایه و کلید تولیدشده به‌روز کنید. سرویس تمام مسیریابی را به‌طور شفاف مدیریت می‌کند.

می‌توانید جزئیات مدل‌های موجود را از طریق یک درخواست GET به /v1/models. این تأیید می‌کند که اتصال شما فعال است. API ما یک مدل بدون سانسور واحد را برای تولید متن نامحدود ارائه می‌دهد.

کلیدهای احراز هویت

کلید API خود را در Authorization هدر هر درخواست. از فرمت Bearer YOUR_API_KEY. این هدر هویت شما را احراز هویت کرده و مصرف توکن شما را ردیابی می‌کند. بدون آن، سرور درخواست شما را رد می‌کند.

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

اگر یک 401 Unauthorized خطا، فرمت کلید خود را بررسی کنید. مطمئن شوید فضای خالی انتهایی وجود ندارد. کلید باید در داشبورد حساب کاربری شما معتبر و فعال باشد.

ارسال اولین درخواست

یک درخواست کامل‌شدن چت استاندارد به POST /v1/chat/completions. مدل را به‌عنوان uncensored. پیام‌های خود را در قالب لیست با role و content فیلدها. API یک پاسخ مستقیم بدون حاشیه اضافی برمی‌گرداند.

تنظیم max_tokens پارامتری برای کنترل طول خروجی. پیش‌فرض ۲,۰۴۸ توکن است. می‌توانید این مقدار را تا ۱۶,۰۰۰ توکن در هر درخواست افزایش دهید. پنجره زمینه (Context) کل تا ۱۰۰,۰۰۰ توکن برای ترکیب پیش‌درآمد و تکمیل پشتیبانی می‌کند.

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

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

استریمینگ را با تنظیم stream: true در درخواست شما. API توکن‌ها را به صورت افزایشی از طریق رویدادهای ارسالی سرور (SSE) برمی‌گرداند. این امر تأخیر ادراک‌شده را برای کاربران شما کاهش می‌دهد. می‌توانید خروجی را به محض دریافت اولین توکن شروع به نمایش کنید.

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

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

فراخوانی تابع و حالت JSON

از tools پارامتری برای تعریف توابع سفارشی برای مدل. API از انتخاب ابزار و خروجی ساختاریافته پشتیبانی می‌کند. این تعاملات پیچیده و استخراج داده را امکان‌پذیر می‌سازد. طرحواره (Schema) تابع خود را در بدنه درخواست تعریف کنید.

حالت JSON را با تنظیم response_format به {"type": "json_object"}. این موضوع مدل را مجبور می‌کند تا JSON معتبر خروجی دهد. برای تجزیه داده‌های ساختاریافته یا تغذیه نتایج به سیستم‌های دیگر ایده‌آل است. این را با جریان‌دهی (streaming) برای به‌روزرسانی‌های بلادرنگ ترکیب کنید.

تنظیم tool_choice به "auto" یا یک نام تابع خاص می‌دهد. این به شما کنترل دقیقی بر رفتار مدل می‌دهد. مدل به شدت از طرحواره ارائه‌شده پیروی می‌کند.

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

API محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید را اعمال می‌کند. می‌توانید تا ۸ درخواست همزمان اجرا کنید. حداکثر اندازه بدنه درخواست ۸ مگابایت است. تجاوز از این محدودیت‌ها خطای 429 Too Many Requests خطا. پیش از تلاش مجدد، کمی صبر کنید.

اگر اعتبار شما تمام شود، شما یک 402 Payment Required خطا. با USDT یا USDC از طریق ارز دیجیتال شارژ کنید. اعتبار شما هرگز منقضی نمی‌شود، بنابراین می‌توانید هر زمان که مایل هستید پرداخت کنید. نیاز به اشتراک ماهانه نیست.

از پنجره زمینه ۱۰۰,۰۰۰ تایی (100,000 token context window) برای اسناد طولانی استفاده کنید. تعداد توکن‌های ورودی و خروجی خود را ردیابی کنید. این کار به شما کمک می‌کند تا در چارچوب بودجه بمانید و از هزینه‌های غیرمنتظره جلوگیری کنید.

cURL

Copycurl https://api.censurasinllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the model filters adult themes in roleplay mode"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)