API مستندات

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

احراز هویت هر درخواست با ارسال کلید API خود در Authorization header. سرویس ما از یک URL پایه واحد برای تمام عملیات استفاده می‌کند که به شما امکان می‌دهد بدون تغییر منطق اصلی خود، از ارائه‌دهندگان دیگر به ما مهاجرت کنید. به سادگی URL پایه پیش‌فرض را در پیکربندی کلاینت خود با https://api.abliteratedgemma.com/v1 و کلید خود را تزریق کنید. این با هر SDK استاندارد سازگار با OpenAI کار می‌کند و به شما اجازه می‌دهد از همان کد کلاینت برای مدل بدون سانسور ما استفاده کنید، همان‌طور که برای غول‌های تجاری استفاده می‌کنید.

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

یک درخواست POST به /v1/chat/completions با شناسه مدل uncensored. API پیام‌های استاندارد چت را می‌پذیرد و مستقیماً متن را برمی‌گرداند. از دستور cURL زیر برای بررسی اتصال و دریافت فوری پاسخ استفاده کنید.

Copycurl https://api.abliteratedgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python loop"}]
  }'

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

استفاده از SDK Python

پکیج رسمی OpenAI Python را نصب کنید و آن را طوری پیکربندی کنید که به URL پایه ما اشاره کند. این به شما اجازه می‌دهد از روش‌های آشنا مانند chat.completions.create برای درخواست‌های همزمان. مثال زیر نحوه راه‌اندازی کلاینت و ارسال یک پرامپت ساده به مدل uncensored را نشان می‌دهد.

Copyfrom openai import OpenAI

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

به یاد داشته باشید که خطاهایی مانند 401 نشان‌دهنده کلید نامعتبر است، در حالی که 402 به این معنی است که اعتبار پیش‌پرداخت شما تمام شده است. از آنجا که ما اشتراک ارائه نمی‌دهیم، باید از طریق کریپتو شارژ کنید تا به استفاده از سرویس ادامه دهید.

استفاده از SDK Node.js

کلاینت Node.js OpenAI را با همان ساختار URL پایه و کلید API مقداردهی اولیه کنید. این به شما امکان می‌دهد تا تولید بدون سانسور را مستقیماً در برنامه‌های Node خود ادغام کنید. قطعه کد زیر حداقل پیکربندی مورد نیاز برای شروع ارسال درخواست‌ها را نشان می‌دهد.

Copyimport OpenAI from "openai";

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

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

پاسخ‌های استریم

استریمینگ را با تنظیم stream: true در درخواست شما. 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)

استریم با هر دو کلاینت Python و Node کار می‌کند. هر قطعه شامل متن ناقص است و قطعه نهایی شامل کل مصرف توکن می‌شود. این برای رابط‌های چت که بازخورد فوری تجربه کاربری را بهبود می‌بخشد ایده‌آل است.

Limits and Error Handling

محدودیت‌های درخواست خود را پایش کنید تا از وقفه‌ها جلوگیری شود. شما مجاز به ارسال ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید هستید. اگر از محدودیت نرخ فراتر روید، API خطای ۴۲۹ را برمی‌گرداند. همیشه خطاهای ۴۰۱ را با بررسی کلید خود و خطاهای ۴۰۲ را با شارژ اعتبار کریپتو خود مدیریت کنید. اعتبار پیش‌پرداخت ما منقضی نمی‌شود، بنابراین می‌توانید استفاده را متوقف کنید بدون اینکه از دست بروید.

پنجره زمینه و جزئیات مدل

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