راهنمای یکپارچه‌سازی: API تکمیل‌های چت

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

API abliterated به عنوان جایگزینی مستقیم برای اندپوینت‌های استاندارد OpenAI عمل می‌کند. درخواست‌های خود را به https://api.aiabliterated.cc/v1 و با استفاده از یک توکن Bearer در Authorization header. این پیکربندی با هر کلاینتی که از پروتکل OpenAI پشتیبانی می‌کند کار می‌کند.

• URL پایه: https://api.aiabliterated.cc/v1
• هدر Auth: Authorization: Bearer YOUR_API_KEY
• شناسه مدل: uncensored

احراز هویت سخت‌گیرانه است. اگر کلید نامعتبری ارسال کنید، سیستم بلافاصله خطای 401 را برمی‌گرداند.

Endpoint /v1/chat/completions

داده‌های پرامپت خود را به /v1/chat/completions اندپوینت برای دریافت پاسخ‌های متنی. سیستم یک پیکربندی JSON حاوی شناسه مدل و تاریخچه پیام‌های شما را انتظار دارد. این یک رابط متنی خالص است؛ انتظار تولید تصویر یا صدا نداشته باشید.

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

Copyfrom openai import OpenAI

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

پاسخ‌های استریم و مصرف توکن

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

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

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)

فراخوانی تابع و حالت JSON

مدل abliterated خروجی‌های ساختاریافته را از طریق response_format پارامتر. این را تنظیم کنید به {"type": "json_object"} برای اجبار به انطباق سخت‌گیرانه JSON. این برای یکپارچه‌سازی قابل اعتماد با سیستم‌های بک‌اند ضروری است.

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

Copyimport OpenAI from "openai";

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

پارامترها: دما، Top-P و Seed

تصادفی بودن خروجی‌های خود را با استفاده از پارامترهای نمونه‌برداری استاندارد کنترل کنید. The temperature مقدار خلاقیت را تنظیم می‌کند، در حالی که top_p نمونه‌گیری هسته را محدود می‌کند. از seed برای خروجی‌های قطعی زمانی که نتایج تکرارپذیر برای اشکال‌زدایی نیاز دارید.

سایر پارامترهای موجود شامل stop توالی‌ها، presence_penalty، و frequency_penalty. این‌ها کنترل ظریفی بر تکرار توکن‌ها و پایبندی به موضوع فراهم می‌سازند. مدل بدون سانسور با تنظیمات دمای پایین برای تولید کد و دمای بالا برای نوشتن خلاقانه، پاسخ‌دهی خوبی دارد.

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

API محدودیت‌های سخت‌گیرانه‌ای را برای تضمین پایداری برای همه کاربران اعمال می‌کند. شما به ۳۰۰ درخواست در دقیقه در هر کلید محدود هستید. درخواست‌های همزمان به ۸ درخواست همزمان محدود شده‌اند. هر بدنه درخواست نباید از ۸ مگابایت تجاوز کند.

اگر از این محدودیت‌ها تجاوز کنید، سیستم خطای ۴۲۹ Too Many Requests را برمی‌گرداند. صورت‌حساب بر اساس مصرف واقعی توکن محاسبه می‌شود. خطاها و رد شدن‌ها اعتبار از پیش پرداخت شده شما را مصرف نمی‌کنند. اگر به دلیل این محدودیت‌ها نیاز به چرخش اعتبارنامه‌ها دارید، می‌توانید کلید خود را مستقیماً از داشبورد مدیریت کنید.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'