مستندات API

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

اندپوینت API ما HTTPS://api.aichatuncensored.cc/v1 است. هر درخواست را با ارسال کلید API منحصر‌به‌فرد خود در Authorization: Bearer <key> header. این کلید را بلافاصله پس از ثبت‌نام با گوگل یا ایمیل در صفحه دریافت کلید API دریافت می‌کنید. نیازی به شماره تلفن نیست و کلید فقط یک بار برای امنیت نمایش داده می‌شود.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

این URL پایه با SDKهای رسمی OpenAI و هر کلاینت سازگاری کار می‌کند. به سادگی کتابخانه خود را پیکربندی کنید تا به آدرس ما اشاره کند. می‌توانید هر زمان یک کلید جدید ایجاد کنید که کلید قبلی را جایگزین می‌کند. هر حساب محدود به یک کلید فعال است.

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

ارسان اولین پرامپت با استفاده از یک استاندارد POST request to /v1/chat/completionsشناسه مدل uncensored, که یک مدل با وزن باز را که برای محتوای نامحدود بهینه‌سازی شده ارائه می‌دهد. متن ورودی در messages آرایه. پاسخ متن تولید شده را در content فیلد.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

خطاهایی مانند اعتبار ناکافی وضعیت ۴۰۲ را برمی‌گردانند. رد درخواست‌ها برای محتوای مرتبط با کودکان نادر است اما امکان‌پذیر است. پخش زنده از طریق رویدادهای ارسالی سرور (Server-Sent Events) برای تحویل توکن‌ها در زمان واقعی در دسترس است. هر درخواست تا ۸ مگابایت داده بدنه را پشتیبانی می‌کند.

یکپارچه‌سازی SDK Python

از کتابخانه رسمی پایتون برای تعامل با API ما استفاده کنید. URL پایه و کلید API را در پیکربندی کلاینت تنظیم کنید. این کار به شما امکان می‌دهد از روش‌های آشنایی مانند chat.completions.create. نحو (Syntax) با پیاده‌سازی‌های استاندارد OpenAI هم‌خوانی دارد.

Copyfrom openai import OpenAI

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

بسته را نصب کنید و کلاینت را با اعتبارنامه‌های خود مقداردهی اولیه کنید. نام مدل را وارد کنید uncensored برای اطمینان از اتصال به نقطه پایانی نامحدود ما. می‌توانید پارامترهایی مانند temperature یا top_p برfor control خ creativite. شیء پاسخ آمار مصرف را در قطعه نهایی در صورت streaming شامل می‌شود.

راه‌اندازی SDK Node.js

کلاینت Node.js را با URL پایه و کلید خود مقداردهی اولیه کنید. این کار تماس مستقیم با انتهای‌گاه تکمیل چت را امکان‌پذیر می‌کند. کتابخانه سریال‌سازی JSON و تزریق هدرها را به‌طور خودکار مدیریت می‌کند.

Copyimport OpenAI from "openai";

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

متد completion را با پیام‌های پرامپت خود فراخوانی کنید. پاسخ شامل متن تولید شده و تعداد توکن‌ها است. می‌توانید نتایج را با تنظیم پرچم stream روی true stream کنید. مدیریت خطاها در SDK وجود دارد. برای مدیریت محدودیت‌ها، کد وضعیت را برای پاسخ‌های 401 یا 429 بررسی کنید.

پاسخ‌های استریم (SSE)

استریمینگ را با تنظیم 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)

جریان SSE را تجزیه کنید تا پاسخ نهایی را جمع‌آوری کنید. آخرین قطعه شامل کل مصرف توکن است. در صورت نیاز می‌توانید پخش زنده را زودتر متوقف کنید. فراخوانی تابع و حالت JSON نیز از پخش زنده پشتیبانی می‌کنند. این ویژگی برای رابط‌های کاربری چت بلادرنگ ایده‌آل است.

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

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

پنجره زمینه از مجموعاً ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. تنظیم max_tokens برای جلوگیری از هزینه‌های غیرمنتظره. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند. برای تلاش مجدد در صورت محدودیت نرخ، از بازگشت نمایی استفاده کنید.