مستندات API

شروع سریع: اولین درخواست شما

درخواست چت-تکمیل استاندارد را برای تولید متن فوری ارسال کنید. مدل بدون سانسور پرامپت شما را می‌پذیرد و تکمیلی بدون مسدود کردن محتوای بزرگسالان قانونی برمی‌گرداند. این نقطه پایانی رابط OpenAI را بازتاب می‌دهد، بنابراین کد موجود شما با حداقل تغییرات کار می‌کند. URL پایه و کلید API را تنظیم کنید تا ترافیک را به سرورهای ما مسیریابی کنید.

• از POST /v1/chat/completions استفاده کنید.
• مدل را روی uncensored.
• پیام‌های سیستم و کاربر خود را قرار دهید.

پاسخ شامل متن تولید شده و جزئیات مصرف توکن است. می‌توانید اتصال را با ارسال یک پرسش ساده و بررسی خروجی تأیید کنید.

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

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

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

• هدر: Authorization: Bearer YOUR_API_KEY.
• برای ثبت‌نام نیازی به شماره تلفن نیست.
• یک کلید فعال برای هر حساب؛ در صورت گم شدن جایگزین کنید.

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

Copyfrom openai import OpenAI

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

پارامترها & کنترل‌ها

رفتار مدل را با استفاده از پارامترهای استاندارد مانند دما (temperature)، top_p و دنباله‌های توقف (stop sequences) کنترل کنید. این تنظیمات به شما امکان می‌دهند خلاقیت و طول خروجی را به دقت تنظیم کنید. مدل بدون سانسور این محدودیت‌ها را رعایت می‌کند و در عین حال ماهیت بدون پاسخ‌دهی محدود (refusal-free) خود را حفظ می‌کند. از response_format برای اجبار به خروجی JSON برای وظایف داده ساختاریافته.

• تنظیم temperature برای تصادفی بودن.
• استفاده stop برای توقف تولید در محرک‌های خاص.
• فعال‌سازی json_object برای قالب‌بندی دقیق.

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

Copyimport OpenAI from "openai";

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

جریان‌سازی و SSE

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

• تنظیم stream: true در درخواست.
• رویدادهای SSE را در سمت کلاینت تجزیه کنید.
• استخراج متن از هر قطعه دلتا.

استریم برای رابط‌های چت که کاربران بازخورد فوری انتظار دارند ایده‌آل است. API جریان را به‌طور کارآمد مدیریت می‌کند و تحویل روان توکن‌ها را بدون مسدود کردن اتصال تضمین می‌می‌کند.

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)

مدیریت خطا

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

• 401: اعتبار کلید API خود را بررسی کنید.
• 402: شارژ اعتبار از طریق ارز دیجیتال.
• 429: قبل از تلاش مجدد درخواست‌ها صبر کنید.

این خطاها قابل پیش‌بینی و مستند هستند. منطق تلاش مجدد با افزایش بازه زمانی (exponential backoff) را پیاده‌سازی کنید تا شکست‌های موقت را به راحتی مدیریت کنید.

Limits & Context Window

API از یک پنجره زمینه ۱۰۰,۰۰۰ توکنی برای مجموع متن ورودی و پاسخ پشتیبانی می‌کند. این امکان پردازش اسناد بزرگ یا تاریخچه مکالمات طولانی را به صورت کارآمد فراهم می‌کند. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن، یا ۲,۰۴۸ در صورت عدم مشخص بودن است. بدنه‌های درخواست به ۸ مگابایت محدود شده‌اند و همزمانی به هشت درخواست همزمان در هر کلید محدود می‌شود.

• زمینه: مجموعاً ۱۰۰,۰۰۰ توکن.
• حداکثر خروجی: ۱۶,۰۰۰ توکن.
• درخواست‌های موازی: 8 برای هر کلید.

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