fa ▾

شروع سریع API Abliter

شروع استفاده از API Abliter بلافاصله با اندپوینت سازگار با OpenAI ما. این راهنمای شروع سریع شامل احراز هویت، مثال‌های کدنویسی و جزئیات قیمت‌گذاری برای یکپارچه‌سازی LLM بدون سانسور شما است.

https://api.abliter.cc/v1uncensored

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

به API متصل شوید و از URL پایه و کلید API منحصر‌به‌فرد خود استفاده کنید. نقطه پایانی در آدرس زیر قرار دارد https://api.abliter.cc/v1Authorization هدر به عنوان یک توکن Bearer. این پیکربندی با هر کتابخانه کلاینت استاندارد سازگار با OpenAI کار می‌کند. احراز هویت ساده است: کلید خود را از داشبورد تولید کنید و آن را در کد خود جایگذاری کنید. به جریان‌های پیچیده OAuth یا توکن‌های ثانویه برای دسترسی پایه نیاز نیست. کلید شما دسترسی فوری به قابلیت‌های مدل بدون سانسور را فراهم می‌کند.

ارسال اولین درخواست

اولین فراخوانی خود را با استفاده از endpoint استاندارد تکمیل چت ارسال کنید. این درخواست یک پرامپت ارسال کرده و یک پاسخ متنی دریافت می‌کند. می‌توانید از curl یا هر کلاینت HTTP دیگری برای آزمایش اتصال استفاده کنید. شناسه مدل است uncensored, اطمینان حاصل کنید که مدل را به‌درستی در بار خود مشخص می‌کنید. این ساختار ساده به شما اجازه می‌دهد قبل از ساخت برنامه‌های پیچیده، بررسی کنید که یکپارچه‌سازی شما کار می‌کند. API متن را مستقیماً بازگردانی می‌کند که با جریان‌های کاری موجود سازگار است.

curl https://api.abliter.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current server status?"}]
  }'

یکپارچه‌سازی SDK Python

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

from openai import OpenAI

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

یکپارچه‌سازی SDK Node.js

API را در پروژه‌های JavaScript یا TypeScript خود با استفاده از SDK Node ادغام کنید. کلاینت را با URL پایه و اعتبارنامه‌های خود پیکربندی کنید. این به شما اجازه می‌دهد درخواست‌ها را به راحتی در توابع ناهمگام مدیریت کنید. می‌توانید پاسخ‌های استریم یا سینک را بر اساس نیازهای خود مدیریت کنید. SDK از الگوهای مدرن async/await برای کد تمیز پشتیبانی می‌کند. این ادغام API در سرورهای وب یا ابزارهای CLI را آسان می‌کند. اطمینان حاصل کنید که محیط شما از نسخه Node مورد نیاز پشتیبانی می‌کند.

import OpenAI from "openai";

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

مدیریت پاسخ‌های جریان‌سازی

جریان‌سازی را برای تولید بلادرنگ توکن با استفاده از رویدادهای ارسال‌شده از سرور (SSE) فعال کنید. این ویژگی به شما امکان می‌دهد متن را همان‌طور که تولید می‌شود نمایش دهید و تجربه کاربری را بهبود بخشید. API داده‌ها را تا تکمیل پاسخ ارسال می‌کند. می‌توانید جزئیات مصرف توکن را در قطعه نهایی دریافت کنید. جریان‌سازی برای رابط‌های چت و برنامه‌های زنده ضروری است. این کار تأخیر ادراک‌شده را کاهش داده و کاربران را درگیر نگه می‌دارد. کلاینت خود را برای دریافت صحیح جریان‌های داده تدریجی پیکربندی کنید.

stream = 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)

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

API ما محدودیت‌های خاصی برای اطمینان از پایداری اعمال می‌کند. شما ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید دریافت می‌کنید. پنجره زمینه از ۱۰۰,۰۰۰ توکن در مجموع پشتیبانی می‌کند، با حداکثر خروجی ۱۶,۰۰۰ توکن. خطاهایی مانند 401 نشان‌دهنده کلید نامعتبر هستند، در حالی که 402 به معنای اعتبار ناکافی است. وضعیت 429 نشان می‌دهد که به محدودیت نرخ رسیده‌اید. درخواست‌هایی که از اندازه بدنه ۸ مگابایت تجاوز می‌کنند نیز شکست می‌خورند. اعتبار منقضی نمی‌شود، بنابراین می‌توانید در سرعت خود شارژ کنید. این محدودیت‌ها به حفظ در دسترس بودن بالا برای همه کاربران کمک می‌کنند.

پرسش‌های رایج

چگونه با API abliter احراز هویت کنم؟

کلید API خود را به عنوان توکن Bearer در هدر Authorization قرار دهید. می‌توانید کلید خود را در داشبورد پس از ثبت‌نام با گوگل یا ایمیل ایجاد کنید. URL پایه عبارت است از HTTPS://api.abliter.cc/v1.

اندازه پنجره زمینه چقدر است؟

پنجره زمینه (context window) تا ۱۰۰,۰۰۰ توکن را برای ترکیب پرامپت و تکمیل (completion) پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست خروجی دهید. این امکان مکالمات طولانی و پردازش اسناد بزرگ را فراهم می‌کند.

اگر خطای 429 دریافت کنم چه اتفاقی می‌افتد؟

خطای ۴۲۹ به این معنی است که به محدودیت نرخ ۳۰۰ درخواست در دقیقه دسترسی پیدا کرده‌اید. همچنین ممکن است به محدودیت درخواست همزمان ۸ مورد برسید. کمی صبر کنید و دوباره تلاش کنید، یا فرکانس درخواست‌های خود را کاهش دهید.

کلید API خود را دریافت کنید

ثبت‌نام کنید، توکن را کپی کنید و آدرس پایه خود را به‌روز کنید. تمام.

با اعتبار آزمایشی امتحان کنید