راهنمای یکپارچه‌سازی

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

این API یک API سازگار با openai است که ساختار Chat Completions را بازتاب می‌دهد. متن ارسال می‌کنید، متن دریافت می‌کنید. نقاط پایایی اضافی برای امبدینگ یا صدا کار شما را شلوغ نمی‌کنند. با اشاره کلاینت خود به URL پایه ما شروع کنید.

• URL پایه: HTTPS://api.filtrosemia.com/v1
• شناسه مدل: "uncensored"

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

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

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

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

• هدر: Authorization: Bearer YOUR_API_KEY
• بدون نیاز به مدیریت جریان‌های OAuth یا توکن‌های تازه‌سازی.

کلید خود را امن نگه دارید. این کار دسترسی مستقیم به اعتبارهای پیش‌پرداخت شما را فراهم می‌کند. خطاهایی مانند 401 Unauthorized به معنای ناموجود یا نامعتبر بودن کلید است.

Copyfrom openai import OpenAI

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

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

پیام‌ها را به POST /v1/chat/completions. مدل از پارامترهای استاندارد مانند temperature, top_p، و stop توالی‌ها. این یک مدل بدون سانسور است که برای محتوای بزرگسالان و خلاقانه تنظیم شده است.

• پشتیبانی می‌کند json_object فرمت پاسخ خود را بررسی کنید.
• تعاریف ابزار را برای function calling می‌پذیرد.

درخواست‌ها به صورت متوالی در محدودیت‌های نرخ شما پردازش می‌شوند. اطمینان حاصل کنید که حجم داده ارسالی شما کمتر از ۸ مگابایت باشد.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.filtrosemia.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 را در کلاینت خود تجزیه کنید.

استریم دقیقاً مانند رفتار SDK استاندارد OpenAI عمل می‌کند. شما قطعات را همان‌طور که دریافت می‌شوند مدیریت می‌کنید.

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)

پنجره زمینه و محدودیت‌ها

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

• خروجی حداکثر پیش‌فرض: 2,048 توکن.
• محدودیت نرخ: ۳۰۰ درخواست در دقیقه.

عبور از محدودیت‌ها منجر به 429 Too Many Requests خطا. همزمانی خود را تنظیم کنید تا در محدوده مجاز بمانید. برای هر کلید، ۸ درخواست همزمان مجاز است.

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

خطاهای HTTP استاندارد را مدیریت کنید. 402 Payment Required به معنای تمام شدن اعتبار پیش‌پرداخت شما است. 429 محدودیت نرخ را نشان می‌دهد. 401 مشکلات احراز هویت را نشان می‌دهند.

• خطاها رایگان هستند. شما فقط بابت استفاده موفق از توکن‌ها هزینه می‌پردازید.
• رد شدن‌ها به دلیل سیاست‌های محتوا نیز رایگان هستند.

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