شروع سریع API Ollama Abliterated

تنظیم احراز هویت و URL پایه

کلاینت خود را با URL پایه و کلید API ارائه‌شده پیکربندی کنید تا درخواست‌ها را آغاز کنید. نقطه پایانی HTTPS://api.ollamaabliterated.com/v1 است و باید کلید خود را به عنوان توکن bearer در هدر Authorization ارسال کنید. این راه‌اندازی با هر SDK سازگار با OpenAI کار می‌کند با تغییر URL پایه پیش‌فرض.

Copycurl https://api.ollamaabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the system prompt to relaxed mode"}]
  }'

ثبت‌نام از طریق گوگل یا ایمیل در داشبورد برای دریافت فوری کلید خود.

درخواست تکمیل چت پایه

درخواست POST را /v1/chat/completions با شناسه مدل "uncensored" ارسال کنید تا پاسخ‌های متنی دریافت کنید. این مدل بدون رد محتوا برای استفاده بزرگسالان قانونی عمل می‌کند و موضوعات بحث‌برانگیز یا NSFW را مستقیماً پردازش می‌کند. می‌توانید رفتار را با پارامترهایی مانند دما و top_p کنترل کنید.

Copyfrom openai import OpenAI

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

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

پاسخ‌های استریم از طریق SSE

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

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)

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

Function Calling & Tool Support

ابزارها را در درخواست خود تعریف کنید تا قابلیت‌های فراخوانی تابع را در مدل uncensored فعال کنید. API از tool_choice پشتیبانی می‌کند و تعاریف ابزار را در قالب استاندارد OpenAI ارسال می‌کند. این امکان استخراج داده‌های ساختاریافته یا فعال‌سازی اقدامات را بدون نیاز به منطق تجزیه خارجی فراهم می‌کند.

Copyimport OpenAI from "openai";

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

اطمینان حاصل کنید که طرحواره‌های ابزار شما اشیاء JSON معتبری هستند. مدل tool_calls را برمی‌گرداند که باید آن‌ها را اجرا کرده و در صورت نیاز به درخواست‌های بعدی بازخورد دهید.

پیکربندی حالت JSON

خروجی JSON سخت‌گیرانه را با تنظیم response_format روی {"type": "json_object"} در پیکربندی درخواست خود مجبور کنید. این حالت برای تجزیه داده‌های ساختاریافته از LLM بدون پردازش پس از تولید با regex ایده‌آل است. این تضمین می‌کند که پاسخ هر بار به سینتکس JSON معت adherence دارد.

از این گزینه برای تولید فایل‌های پیکربندی، بارهای API یا لاگ‌های ساختاریافته استفاده کنید. اگر به تنوع‌های خلاقانه JSON نیاز دارید، آن را با مقادیر دمای بالا (high temperature) ترکیب کنید.

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

کدهای وضعیت HTTP استاندارد را پایش کنید تا مدیریت خطاهای سمت کلاینت به‌طور موثر انجام شود. 401 نشان‌دهنده کلید نامعتبر یا منقضی شده است، در حالی که 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. خطای 429 یعنی از محدودیت نرخ 300 درخواست در دقیقه تجاوز کرده‌اید.

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