مستندات API

شروع سریع: ادغام با پایتون

اولین مرحله نصب SDK رسمی OpenAI و پیکربندی URL پایه است. این تضمین میکند که مشتری شما درخواست‌ها را به انتهای نقطه LLM uncensored ما هدایت کند بدون اینکه منطق موجود شما را تغییر دهد.

• بسته را از طریق pip نصب کنید.
• کلید API و آدرس پایه را تنظیم کنید.
• درخواست تکمیل چت استاندارد را ارسال کنید.

این پیکربندی هم برای اسکریپت‌های محلی و هم برای سرورهای تولید کار می‌کند.

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

کلید API شما هر درخواست را به URL پایه HTTPS://api.chatbotsemfiltro.com/v1 احراز هویت می‌کند. کلید بلافاصله پس از ثبت‌نام ایجاد شده و تا زمانی که آن را لغو کنید معتبر باقی می‌ماند.

کلید را در یک متغیر محیطی ذخیره کنید تا از هاردکد کردن اسرار جلوگیری شود. SDK تزریق هدر را به صورت خودکار مدیریت می‌کند.

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

نقطه پایانی اصلی درخواست‌های POST را به /v1/chat/completions می‌پذیرد. این نقطه انتظار دارد بدنه JSON شامل پیام‌ها و پارامترهای مدل باشد.

• نقش (system, user, assistant) را تعریف کنید.
• مدل را به عنوان "uncensored" مشخص کنید.
• دریافت خروجی متنی.

این ساختور با فرمت استاندارد OpenAI همخوانی دارد و اطمینان حاصل می‌کند.

پخش زنده و فراخوانی تابع

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

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

پارامترها: دما و Top P

دما را برای خلاقیت یا قطعی‌سازی تنظیم کنید. مقادیر بین ۰ و ۲ تصادفی‌سازی را کنترل می‌کنند. Top P کلمات را بر اساس احتمال تجمعی فیلتر می‌کند.

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

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

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

محدودیت نرخ ۳۰۰ درخواست در دقیقه است. تجاوز از این مورد خطای ۴۲۹ را فعال می‌کند. همزمانی را مدیریت کنید تا از محدود شدن جلوگیری کنید.

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

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

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

cURL

Copycurl https://api.chatbotsemfiltro.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten libraries for Rust async programming"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)