مستندات API & شروع سریع
کلیدهای API بدون سانسور ما را با کلاینتهای سازگار با OpenAI استاندارد یکپارچه کنید تا متن بدون رد شدن تولید کنید. این راهنما شامل احراز هویت، ساختارهای درخواست، استریم و استفاده از ابزارها برای استقرار فوری است.
URL پایه و احراز هویت
نقطه پایانی API https://api.uncensoredapikeys.com/v1. این URL با هر SDK یا کلاینت سازگار با OpenAI کار میکند. تنها نیاز دارید که URL پایه را تغییر دهید و کلید API خود را در هدر احراز هویت ارائه دهید. هر درخواست نیاز به یک کلید معتبر دارد. کلیدهای نامعتبر خطای 401 برمیگردانند. شما به ازای هر حساب کاربری یک کلید فعال دریافت میکنید.
احراز هویت ساده است. از استاندارد Authorization: Bearer <API_KEY> فرمت. کلید شما بلافاصله پس از ثبتنام از طریق گوگل یا ایمیل تولید میشود. نیاز به تأیید شماره تلفن وجود ندارد. کلید تا زمانی که اعتبار پیشپرداخت دارید منقضی نمیشود.
ایجاد تکمیل چت
پیامها را به مدل با استفاده از POST /v1/chat/completions اندپوینت. شناسه مدل uncensored. این انتهایبند، پیامهای چت استاندارد شامل فیلدهای role و content را میپذیرد. میتوانید دما، top_p و دنبالههای توقف را مشخص کنید. مدل با تکمیل متنی پاسخ میدهد.
اطمینان حاصل کنید که درخواستهای شما در محدوده ۸ مگابایتی بدنه باقی بمانند. تجاوز از این حد منجر به خطا میشود. شما میتوانید تا ۳۰۰ درخواست در دقیقه پردازش کنید. این امکان ادغام با تراکم بالا را بدون مدیریت صف پیچیده فراهم میکند.
ساختار درخواست نمونه:
curl https://api.uncensoredapikeys.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "return 404 for missing id"}]
}'یکپارچهسازی SDK پایتون نیز به سادگی انجام میشود. کلاینت را با URL پایه سفارشی و کلید خود مقداردهی اولیه کنید. پیامها را به صورت لیستی از دیکشنریها ارسال کنید. شیء پاسخ شامل متن تولید شده در choices[0].message.content. این روش سریالسازی JSON را به طور خودکار مدیریت میکند.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredapikeys.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)
پاسخهای استریم (SSE)
استریمینگ را با تنظیم stream: true در درخواست شما. API رویدادهای ارسالی سرور (SSE) را برمیگرداند. هر قطعه شامل متن جزئی است. قطعه نهایی شامل آمار مصرف توکن است. این به نمایش بلادرنگ محتوای تولید شده اجازه میدهد.
استریمینگ تأخیر ادراکشده را برای پاسخهای طولانی کاهش میدهد. میتوانید پردازش متن را بلافاصله شروع کنید. مدیریت بافر توسط SDKهای استاندارد انجام میشود. از این ویژگی برای رابطهای چت یا داشبوردهای زنده استفاده کنید. تعداد توکن در قطعه نهایی به ردیابی دقیق مصرف کمک میکند.
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)
فراخوانی تابع و ابزارها
مدل از function calling از طریق tools پارامتر. ابزارها را با نامها، توضیحات و طرحوارههای JSON تعریف کنید. مدل میتواند به جای متن مستقیم، فراخوانی تابع را بازگرداند. این اجازه ادغام با سیستمها یا APIهای خارجی را میدهد. میتوانید مشخص کنید tool_choice برای اجبار یا اجازه انتخاب خودکار.
از این گزینه برای استخراج دادههای ساختاریافته یا جریانهای کاری عامل (agent) استفاده کنید. مدل ابزار صحیح را بر اساس پرامپت کاربر شناسایی میکند. اگر نیاز است، باید تابع را اجرا کرده و نتیجه را به مدل بازگردانید. این یک حلقه برای وظایف پیچیده چندمرحلهای ایجاد میکند. حالت JSON نیز از طریق response_format برای قالببندی خروجی دقیق.
پارامترها و محدودیتها
رفتار تولید را با پارامترهایی مانند تنظیم کنید temperature, top_p، و seed. دمای بالاتر تصادفیسازی را افزایش میدهد. مقادیر پایینتر خروجیهای قطعیتری تولید میکنند. از stop sequences برای توقف تولید در نشانگرهای خاص. presence_penalty و frequency_penalty به کاهش تکرال کمک میکند.
پنجره زمینه ۱۰۰,۰۰۰ توکن برای ورودی و خروجی ترکیبی است. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. اگر max_tokens تنظیم نشده است، محدودیت پیشفرض 2,048 توکن است. محدودیت نرخ 300 درخواست در دقیقه را اعمال میکند. درخواستهای همزمان به 8 درخواست در هر کلید محدود شده است. همزمانی خود را بهطور مناسب برنامهریزی کنید.
اطلاعات مدل
شناسه مدل uncensored. یک مدل وزنباز است که روی سرورهای ما میزبانی میشود. این GPT، Claude، Gemini یا هر مدل دیگری از فروشندگان نیست. برای پاسخ دادن بدون رد شدن محتوا برای استفاده بزرگسالان قانونی تنظیم شده است. تنها محدودیت سخت، محتوای جنسی شامل کودکان است.
قیمتگذاری شفاف است. توکنهای ورودی $0.15 به ازای هر 1M هزینه دارند. توکنهای خروجی $0.50 به ازای هر 1M هزینه دارند. خطاها و رد شدنها رایگان هستند. اعتبار هرگز منقضی نمیشود. میتوانید با USDT (TRC20) یا USDC (Base) شارژ کنید. حداقل شارژ $20 است. اعتبار هدیه برای مبالغ بالاتر اعمال میشود. بدون هزینه ماهانه. بدون اشتراک. فقط بابت آنچه استفاده میکنید پرداخت کنید.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredapikeys.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);پرسشهای رایج
آدرس نقطه پایانی (endpoint URL) کلیدهای API uncensored چیست؟
URL پایه HTTPS://api.uncensoredapikeys.com/v1 است. این با هر کلاینت سازگار با OpenAI کار میکند. باید URL پایه را در پیکربندی SDK خود بهروزرسانی کنید.
چگونه خطاهای 401، 402 یا 429 را مدیریت کنم؟
خطای 401 به این معنی است که کلید API شما نامعتبر یا فاقد کلید است. خطای 402 نشاندهنده اعتبار پیشپرداخت ناکافی است. خطای 429 نشان میدهد که از محدودیت 300 درخواست در دقیقه فراتر رفتهاید. منطق تلاش مجدد باید خطاهای 429 را با بازگشت نمایی (exponential backoff) مدیریت کند.
محدودیتهای پنجره زمینه و خروجی چیست؟
پنجره زمینه کل ۱۰۰,۰۰۰ توکن است. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. اگر max_tokens را تنظیم نکنید، محدودیت خروجی پیشفرض ۲,۰۴۸ توکن است. توکنهای ورودی و خروجی به یک پنجره مشترک تعلق دارند.
کلید API خود را بلافاصله دریافت کنید
ثبتنام کنید، توکن را کپی کنید و نقطه پایانی را بهروز کنید. همینها کافی است.