مستندات API

احراز هویت

کلید API شما تمام درخواست‌ها را به سرور احراز هویت می‌کند. آن را در Authorization هدر به عنوان یک توکن Bearer. از طریق گوگل یا ایمیل ثبت‌نام کنید تا کلید خود را فوراً دریافت کنید. $0.50 اعتبار آزمایشی دارید که برای 7 روز معتبر است. کلید خود را امن نگه دارید. یک کلید فعال در هر حساب. جایگزین کردن آن، کلید قبلی را فوراً نامعتبر می‌سازد.

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

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید. از شناسه مدل "uncensored" برای مدل خاص ما استفاده کنید. URL پایه https://api.llamansfw.com/v1. با هر SDK استاندارد OpenAI کار می‌کند. جایگزین YOUR_API_KEY با کلید واقعی خود. بدنه درخواست شامل پیام‌هایی با نقش‌ها و محتوا است.

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

کلاینت OpenAI را با URL پایه ما مقداردهی اولیه کنید. کلید API را در محیط یا سازنده تنظیم کنید. تماس chat.completions.create() با مدل و پیام‌ها. این یک شیء تکمیل‌شده برمی‌گرداند. برای استخراج متن تولید شده، پاسخ را مدیریت کنید. این رویکرد کد شما را با الگوهای استاندارد OpenAI سازگار نگه می‌دارد. دما را برای تنوع‌های خلاقانه تنظیم کنید.

یکپارچه‌سازی Node.js

پکیج OpenAI را ایمپورت کنید. URL پایه را به نقطه پایانی ما تنظیم کنید. کلید API خود را پاس دهید. یک تکمیل با پارامترهای مورد نظر ایجاد کنید. کلاینت درخواست HTTP را به صورت خودکار مدیریت می‌کند. پاسخ را تجزیه کنید تا پیام دستیار را دریافت کنید. این روش به‌طور یکپارچه با برنامه‌های موجود Node.js کار می‌کند. می‌توانید استریم را روی false تنظیم کنید تا پاسخ‌های استاندارد دریافت کنید.

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

استریمینگ را با تنظیم stream به true. API قطعات متن را همان‌طور که تولید می‌شوند بازگردانده و ارسال می‌کند. این کار تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. می‌توانید متن را به صورت بلادرنگ به کاربران نمایش دهید. آخرین قطعه شامل آمار مصرف توکن است. این ویژگی با هر دو SDK پایتون و Node کار می‌کند. این گزینه برای رابط‌های چت که نیاز به بازخورد فوری دارند، ایده‌آل است.

Limits and Errors

پنجره زمینه (context window) از مجموعاً ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست ارسال کنید. خطاها کدهای HTTP استاندارد را برمی‌گردانند. 401 نشان‌دهنده کلید نامعتبر یا فاقد است. 402 یعنی اعتبار پیش‌پرداخت شما تمام شده است. 424 نشان می‌دهد که به محدودیت نرخ ۳۰۰ درخواست در دقیقه رسیده‌اید. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود. خطاها توکن مصرف نمی‌کنند. رد شدن‌ها (refusals) نیز رایگان هستند.

cURL

Copycurl https://api.llamansfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max context window size?"}]
  }'

پایتون

Copyfrom openai import OpenAI

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