مستندات API

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

API در https://api.ollamauncensoredmodels.com/v1Authorization هدر با توکن Bearer خود. این پیکربندی با هر کتابخانه کلاینت سازگار با OpenAI کار می‌کند زیرا ما از الگوهای احراز هویت یکسان پیروی می‌کنیم. می‌توانید کلید خود را به صورت فوری از طریق گوگل یا ایمیل بدون ارائه شماره تلفن ایجاد کنید. سیستم یک کلید فعال برای هر حساب کاربری صادر می‌کند و با ایجاد کلید جدید، کلید قبلی را بلافاصله جایگزین می‌کند. این دسترسی یکسان را بدون نیاز به مدیریت همزمان چندین اعتبار فراهم می‌کند.

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

یک درخواست POST به /v1/chat/completions با شناسه مدل تنظیم شده به "uncensored". نقطه پایانی پارامترهای استاندارد مانند messages, temperature، و max_tokens. این مدل پاسخ‌های JSON شامل متن تولید شده و آمار مصرف توکن را برمی‌گرداند. می‌توانید اتصال را با بررسی لیست مدل‌ها یا ارسال یک درخواست ساده به سرعت آزمایش کنید. این رویکرد مستقیم، پیچیدگی منطق پروکسی یا مسیریابی را که اغلب در سرویس‌های دیگر یافت می‌شود، حذف می‌کند.

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

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

از کتابخانه رسمی پایتون OpenAI برای اتصال با لغو URL پایه استفاده کنید. ویژگی‌های کلید API و URL پایه را قبل از انجام هرگونه درخواست تنظیم کنید. این به شما اجازه می‌دهد از کدبیس‌های موجود بدون بازنویسی منطق کلاینت استفاده کنید. کتابخانه سریال‌سازی و تجزیه خطاها را به‌طور خودکار مدیریت می‌کند. می‌توانید پاسخ‌ها را استریم کنید یا تکمیل‌های همزمان را بسته به نیازهای تأخیر برنامه خود درخواست دهید. این روش سازگاری با شیوه‌های توسعه استاندارد رایج در صنعت را تضمین می‌کند.

Copyfrom openai import OpenAI

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

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

کلاینت OpenAI را با URL پایه و کلید API خود در محیط‌های Node.js مقداردهی اولیه کنید. شناسه مدل "uncensored" را به روش تکمیل چت وارد کنید. SDK درخواست‌های HTTP را مدیریت کرده و پاسخ‌های JSON را به‌طور کارآمد تجزیه می‌کند. می‌توانید آن را مستقیماً در مسیرهای Express یا توابع serverless ادغام کنید. ساختار کد با پیاده‌سازی‌های استاندارد OpenAI مطابقت دارد و مهاجرت از ارائه‌دهندگان دیگر را ساده می‌سازد. این رویکرد ایمنی نوع و مدیریت خطا را مطابق با توسعه مدرن جاوااسکریپت حفظ می‌کند.

Copyimport OpenAI from "openai";

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

استریمینگ و استفاده از توکن

استریمینگ را با تنظیم 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)

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

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