مستندات API تکمیل چت بدون سانسور

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

کلید API درخواست‌های شما را احراز هویت می‌کند. شما یک کلید به ازای هر حساب دریافت می‌کنید که بلافاصله پس از ثبت‌نام از طریق Google یا ایمیل تولید می‌کنید. از URL پایه HTTPS://api.ollamaopenaiapi.com/v1 برای مسیریابی ترافیک خود استفاده کنید.

• کلید خود را از داشبورد کپی کنید.
• متغیر محیطی را تنظیم کنید یا آن را مستقیماً در پیکربندی کلاینت خود ارسال کنید.
• مشتری به URL پایه خاص ما اشاره می‌کند تا از نقاط پایانی استاندارد OpenAI جلوگیری شود.

نقطه پایانی تکمیل چت

پیام‌ها را به نقطه پایانی تکمیل چت ارسال کنید تا پاسخ‌های متنی دریافت نمایید. شناسه مدل uncensored, که روی سرورهای ما اجرا می‌شود و موضوعات بزرگسالان قانونی یا بحث‌برانگیز را رد نمی‌کند. می‌توانید پاسخ‌ها را به صورت جریان (stream) دریافت کنید یا آن‌ها را در یک بلوک واحد دریافت کنید.

Copycurl https://api.ollamaopenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list open ports on this server"}]
  }'

این اندپوینت، payloadهای JSON استاندارد را مدیریت می‌کند. خطاها به صورت کدهای HTTP استاندارد بازگردانده می‌شوند. پنجره زمینه (context window) 100,000 توکن در مجموع است. حداکثر خروجی 16,000 توکن است مگر اینکه لغو شود.

نقطه پایانی لیست مدل‌ها

فهرست مدل‌ها را برای بررسی موجود بودن بررسی کنید. پاسخ، شناسه و نوع مدل را تأیید می‌کند. این برای اشکال‌زدایی پیکربندی‌های کلاینت مفید است. این به فرمت استاندارد OpenAI برمی‌گردد. از GET /v1/models برای بازرسی استفاده کنید. فهرست کوچک است زیرا ما یک مدل اصلی را ارائه می‌دهیم. این نقطه پایانی را بررسی کنید تا مطمئن شوید کلاینت شما ساختار نقطه پایانی را می‌شناسد.

جریان‌سازی و استفاده توکن

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

پارامترها: دما، Top P، Tools

خلاقیت را با temperature و top_p. از tools برای فراخوانی تابع تنظیم کنید response_format به {"type": "json_object"} برای خروجی ساختاریافته. این پارامترها از طرحواره OpenAI پیروی می‌کنند. همچنین می‌توانید stop sequences و seed برای تکرارپذیری. جریمه‌ها را برای کنترل تکرار تنظیم کنید. مدل بدون سانسور این محدودیت‌ها را رعایت می‌کند. سبک خاصی را تحمیل نمی‌کند. شما کنترل کامل بر تولید دارید.

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

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

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)