شروع سریع API: تکمیل گفتگو

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

کلید API شما هر درخواست را احراز هویت می‌کند. از Authorization هدر با Bearer scheme. URL پایه شما https://api.nsfwopenrouter.com/v1. این URL با هر SDK سازگار با OpenAI کار می‌کند. نیازی به اشتراک ندارید. فقط بابت توکن‌های مصرفی پرداخت می‌کنید. خطاها و رد شدن درخواست‌ها هزینه‌ای ندارند. از طریق گوگل یا ایمیل ثبت‌نام کنید تا کلید خود را به سرعت دریافت کنید.

ارسال یک درخواست تکمیل چت (Chat Completion Request)

یک درخواست POST به /v1/chat/completionsشناسه مدل همیشه uncensored. پرامپت سیستم خود را برای تعریف رفتار ارائه دهید. پیام‌های کاربر را در messages آرایه. API خروجی متنی را مستقیماً برمی‌گرداند. مسیریابی پیچیده‌ای رخ نمی‌دهد. ترافیک مستقیماً به سرورهای ما می‌رود. این اطمینان حاصل می‌کند که مدیریت NSFW بدون فیلترهای بالادستی یکسان است.

مدیریت پاسخ‌های جریان‌سازی

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

پیکربندی پارامترهای مدل

تنظیم temperature برای خلاقیت. از top_p برای نمونه‌گیری هسته. Set max_tokens برای محدود کردن طول خروجی. حداکثر پیش‌فرض 2,048 توکن است. می‌توانید تا 16,000 توکن در هر درخواست درخواست دهید. پنجره زمینه 100,000 توکن را به طور کلی پشتیبانی می‌کند. این شامل هم پرامپت و هم تکمیل می‌شود. این تنظیمات را برای نیازهای خاص نقش‌آفرینی خود تنظیم کنید.

فعال‌سازی حالت JSON

استفاده response_format با {"type": "json_object"}مدل خروجی JSON معتبر را تضمین می‌کند. این ساختار برای یکپارچه‌سازی برنامه‌ای ضروری است. پاسخ را مستقیماً در اشیاء برنامه خود تجزیه کنید. برای اطمینان از قابلیت اطمینان، از تجزیه regex خودداری کنید. این ویژگی استخراج داده‌های سازگار را تضمین می‌کند. این ویژگی به‌طور یکپارچه با SDKهای استاندارد کار می‌کند.

درک فراخوانی ابزارها

ابزارها را در بدنه درخواست تعریف کنید. مدل می‌تواند فراخوانی‌های تابع ساختاریافته را برمی‌گرداند. استفاده tool_choice برای اجبار به رفتارهای خاص. این اجازه می‌دهد جریان‌های کاری عامل‌های پویا ایجاد شوند. API از فرمت‌های استاندارد ابزار OpenAI پشتیبانی می‌کند. parse tool_calls آرایه در پاسخ. توابع را اجرا کرده و نتایج را بازگردانید. این اجازه می‌دهد تعاملات چندمرحله‌ای پیچیده انجام شود.

cURL

Copycurl https://api.nsfwopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run my unit tests and show results"}]
  }'

پایتون

Copyfrom openai import OpenAI

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