راهنمای یکپارچه‌سازی API بدون سانسور

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

ابتدا SDK سازگار با OpenAI خود را به اندپوینت اختصاصی اشاره دهید. زیرساخت ما از یک URL پایه واحد برای تمام درخواست‌ها استفاده می‌کند، که تضمین می‌کند شما فقط با مدل بدون سانسور تعامل دارید و در قفل ارائه‌دهنده گیر نمی‌افتید. باید کلید API خود را در Authorization هدر برای هر تماس. این کلید هنگام ثبت‌نام از طریق گوگل یا ایمیل بلافاصله تولید می‌شود. هزینه ماهانه برای حفظ دسترسی وجود ندارد و کلید تا زمانی که اعتبار پیش‌پرداخت شما تمام شود معتبر باقی می‌ماند. خطاهای احراز هویت، مانند کلید نامعتبر، کد وضعیت 401 را برمی‌گردانند. رد شدن برای محتوای بزرگسالان قانونی رایگان است، اما شما فقط به ازای مصرف واقعی توکن پرداخت می‌کنید.

Copycurl https://api.unsecureapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this python script"}]
  }'

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

ارسال داده‌های متنی به POST /v1/chat/completions اندپوینت برای دریافت پاسخ‌های تولید شده. این رابط اصلی برای ادغام‌های شماست و از پنجره زمینه 100,000 توکن برای هر دو بخش پرامپت و تکمیل پشتیبانی می‌کند. شناسه مدلی که باید در پیکربندی خود مشخص کنید همیشه uncensored. نیازی نیست نگران مسیریابی پیچیده مدل یا نسخه‌بندی باشید، زیرا ما یک مدل وزن‌باز واحد را ارائه می‌دهیم که برای خروجی بدون فیلتر تنظیم شده است. اگر محدودیت بدنه درخواست ۸ مگابایت را تجاوز کنید، API یک خطا بازگردانده است. همچنین می‌توانید مدل‌های موجود را از طریق GET /v1/models به بررسی اتصال قبل از انجام کارهای سنگین.

پاسخ‌های استریم

تولید توکن در زمان واقعی را با تنظیم stream: true در پیکربندی درخواست خود فعال کنید. API رویدادهای ارسال‌شده توسط سرور (SSE) را برای نمایش با تأخیر کم در برنامه‌های شما برمی‌گرداند. آمار مصرف توکن در قطعه نهایی جریان ظاهر می‌شود که به شما امکان می‌دهد هزینه‌ها را به دقت ردیابی کنید. این روش برای ربات‌های چت یا رابط‌های تعاملی که کاربران انتظار بازخورد فوری دارند، ایده‌آل است. توجه داشته باشید که حداکثر خروجی در هر درخواست تا 100,000 توکن است؛ max_tokens اختیاری است. استریم با SDKهای استاندارد OpenAI به طور بی‌نقص کار می‌کند وقتی که URL پایه به درستی به‌روزرسانی شود.

Copyfrom openai import OpenAI

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

Function Calling & JSON Mode

خروجی‌های داده ساختاریافته را با استفاده از حالت JSON یا قابلیت‌های فراخوانی تابع ادغام کنید. Set response_format به {"type": "json_object"} برای اجبار به خروجی‌های JSON یکسان برای پارسرهای شما. همچنین می‌توانید ابزارها را تعریف کرده و tool_choice برای جریان‌های کاری عامل پیچیده. مدل بدون سانسور این ویژگی‌ها را بدون محافظ‌های سخت‌گیرانه معمولی که اغلب طرح‌های تابع را در ارائه‌دهندگان دیگر خراب می‌کنند، پشتیبانی می‌کند. این آن را برای لوله‌های خودکاری که نیاز به استخراج داده دقیق دارند قابل اعتماد می‌سازد. مطمئن شوید تعاریف ابزار شما معتبر هستند تا از خطاهای تجزیه در سمت کلاینت جلوگیری کنید.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unsecureapikeys.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، و seed. با تنظیم این موارد می‌توانید تعادل بین خلاقیت و قطعیت در خروجی‌های خود را تنظیم کنید. شما به ۳۰۰ درخواست در دقیقه به ازای هر کلید، با هم‌زمانی ۸ درخواست هم‌زمان محدود شده‌اید. برای هر حساب کاربری تنها یک کلید فعال مجاز است؛ ایجاد کلید جدید، کلید قبلی را جایگزین می‌کند. مدل اعتبار پیش‌پرداخت به این معنی است که شما $0.15 به ازای هر 1M توکن ورودی و $0.50 به ازای هر 1M توکن خروجی پرداخت می‌کنید. خطاها اعتبار مصرف نمی‌کنند، بنابراین شما تنها برای تکمیل‌های موفق پرداخت می‌کنید.

مدیریت خطا

پاسخ‌های رایج API را به‌خوبی مدیریت کنید تا پایداری برنامه حفظ شود. خطای 401 نشان‌دهنده کلید API نامعتبر یا منقضی‌شده است. خطای 402 به این معنی است که موجودی پیش‌پرداخت شما کافی نیست و نیاز به شارژ ارز دیجیتال از طریق USDT یا USDC دارد. محدودیت‌های نرخ، پاسخ 429 را در صورت تجاوز از 300 درخواست در دقیقه فعال می‌کنند. API داده‌های امبدینگ یا تصویر را برنمی‌گرداند، بنابراین درخواست آن فرمت‌ها ممکن است باعث خطا شود. همیشه قبل از تجزیه بدنه JSON، کد وضعیت را بررسی کنید. محدودیت‌های پنجره متن دقیق هستند، بنابراین تعداد توکن‌ها را برای جلوگیری از بریدگی در مکالمات طولانی نظارت کنید.

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)