شروع سریع: اتصال کلاینت شما
همین حالا شروع به ارسال درخواست کنید با استفاده از URL پایه ما. جایگزین YOUR_API_KEY با کلید از داشبورد خود. API ما از هدرهای استاندارد برای احراز هویت استفاده میکند.
- URL پایه:
https://api.nsfwollama.com/v1 - شناسه مدل:
uncensored
curl https://api.nsfwollama.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize this log file"}]
}'
نقطه پایانی: /v1/chat/completions
پیامها را برای تولید متن ارسال کنید. POST به /v1/chat/completions با شناسه مدل و آرایه پیامها. پنجره زمینه از مجموع ۱۰۰,۰۰۰ توکن پشتیبانی میکند. این شامل توکنهای پرامپت و تکمیل ترکیب شده است.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwollama.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)
نقطه پایانی: /v1/models
مدلهای موجود را کشف کنید. GET /v1/models برای لیست کردن نقاط پایانی (endpoints). API ما یک مدل زبانی بزرگ بهینهسازی شده برای پاسخهای بدون سانسور ارائه میدهد. از توابع embedding یا تولید تصویر پشتیبانی نمیکند. برای اطمینان از موجود بودن، لیست مدلها را بررسی کنید.
پارامترها: دما، Top P و موارد دیگر
سبک تولید را با پارامترهای استاندارد تنظیم کنید. تنظیم temperature برای خلاقیت. مقدار top_p برای نمونهگیری هسته. Use response_format با json_object برای خروجی ساختاریافته. همچنین میتوانید seed برای قابلیت تکرارپذیری. این پارامترها دقیقاً مانند SDK OpenAI کار میکنند.
پاسخهای استریم و مصرف توکن
خروجی بلادرنگ از طریق رویدادههای ارسالشده توسط سرور دریافت کنید. استریم، تأخیر ادراکشده را برای پاسخهای طولانی کاهش میدهد. جزئیات مصرف توکن در آخرین قطعه نمایش داده میشود. این به شما امکان میدهد هزینهها را به دقت ردیابی کنید. 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)
مدیریت خطا و محدودیتها
خطاهای HTTP استاندارد را بهخوبی مدیریت کنید. 401 به معنای نامعتبر بودن کلید API شماست. 402 نشاندهنده اعتبار پیشپرداخت ناکافی است. 429 نشان میدهد که از محدودیت 300 درخواست در دقیقه فراتر رفتهاید. حداکثر اندازه بدنه درخواست 8 مگابایت است. شما 8 درخواست همزمان به ازای هر کلید دریافت میکنید. برای اعتبارها بازپرداخت انجام نمیشود، اما پشتیبانی میتواند خطاهای صورتحساب را اصلاح کند.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwollama.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);