مستندات API

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

احراز هویت ساده و فوری است. شما یک کلید API واحد پس از ثبت‌نام با گوگل یا ایمیل دریافت می‌کنید. این کلید را در Authorization هدر به عنوان یک توکن bearer. این کلید اعتبار پیش‌پرداخت شما را شناسایی کرده و محدودیت‌های درخواست شما را اعمال می‌کند. کلیدها را با تولید یک کلید جدید در داشبورد تغییر دهید؛ کلید قدیمی بلافاصله از کار می‌افتد.

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

اولین درخواست خود را به /v1/chat/completions اندپوینت. شناسه مدل uncensored. ساختارهای پیام استاندارد OpenAI را می‌پذیرد و پاسخ‌های متنی خام برمی‌گرداند. خطاهایی مانند اعتبار ناکافی 402 را برمی‌گرداند، در حالی که کلیدهای نامعتبر 401 را برمی‌گردانند. از این اندپوینت برای وظایف تولید متن استاندارد استفاده کنید.

Copycurl https://api.setituncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France."}]
  }'

SDK Python

مستقیماً با کتابخانه رسمی OpenAI Python ادغام کنید. URL پایه را به سمت سرورهای ما پیکربندی کنید. کلید API و شناسه مدل خود را وارد کنید. این رویکرد با کد کلاینت موجود که سازگاری OpenAI را انتظار دارد کار می‌کند. پارامترها را مانند temperature برای کنترل تصادفی‌سازی. استریم از طریق پشتیبانی می‌شود stream flag.

Copyfrom openai import OpenAI

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

از openai پکیج Node.js برای یکپارچه‌سازی سمت سرور. مقدار baseURL به نقطه پایان API ما. کلایک را با کلید API خود راه‌اندازی کنید. پیام‌ها را ارسال کنید و پاسخ را مدیریت کنید. این پیکربندی به شما امکان می‌دهد تولید بدون سانسور را به راحتی در برنامه‌های Node خود جاسازی کنید. مدیریت توکن‌ها و مدیریت خطاها را به صورت برنامه‌نویسی انجام دهید.

Copyimport OpenAI from "openai";

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

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

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

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)

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

پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. شما به ۳۰۰ درخواست در دقیقه محدود هستید. همزمانی به ۸ درخواست همزمان به ازای هر کلید محدود شده است. درخواست‌هایی که از ۸ مگابایت تجاوز کنند، رد می‌شوند. خطاهای 429 را با پیاده‌سازی Exponential Backoff مدیریت کنید. اعتبار فقط بابت استفاده واقعی از توکن‌ها شارژ می‌شود.