شروع سریع API بدون سانسور

پیش‌نیازها: کلید API شما

اعتبارنامه‌های خود را بلافاصله پس از ثبت‌نام بازیابی کنید. به دریافت کلید API صفحه و از طریق ادامه با گوگل یا با وارد کردن ایمیل و رمز عبور. سیستم کلید منحصر به فرد شما را به صورت فوری نمایش می‌دهد و برای این مرحله نیازی به شماره تلفن نیست. می‌توانید کلید را هر زمان بازیابی کنید، اما انجام این کار کلید قبلی را نامعتبر می‌کند، بنابراین آن را به امنیت ذخیره کنید. این کلید واحد تمام درخواست‌های شما به API را احراز هویت می‌کند.

URL پایه و هدرها

مشتری خود را به نقطه پایانی صحیح هدایت کنید تا اتصال مناسب تضمین شود. از URL پایه https://api.openroutergdpr.com/v1 برای تمام تعاملات. مقدار Authorization هدر به Bearer YOUR_API_KEY و Content-Type به application/json. این پیکربندی با هر SDK استاندارد OpenAI یا کلاینت HTTP بدون نیاز به سازگارهای سفارشی کار می‌کند. ما از پارامترهای استاندارد مانند temperature و top_p برای کنترل تغییرپذیری پاسخ.

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

یک تکمیل ساده را اجرا کنید تا بررسی کنید که پیکربندی شما صحیح است. یک درخواست POST به /v1/chat/completions با شناسه مدل uncensored. این تأیید می‌کند که کلید شما کار می‌کند و مدل ورودی‌های متنی را همان‌طور که انتظار می‌رود پردازش می‌کند. مدل موضوعات نامحدود را برای استفاده قانونی بزرگسالان بدون رد شدن‌های استاندارد مدیریت می‌کند. برای ساختار JSON حداقل مورد نیاز به مثال زیر مراجعه کنید.

Copycurl https://api.openroutergdpr.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the GDPR articles applicable to cross-border data transfers."}]
  }'

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

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

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)

حالت JSON و فراخوانی ابزار

خروجی‌های خود را با استفاده از ویژگی‌های قالب‌بندی داخلی به طور قابل اعتماد ساختار دهید. تنظیم response_format به {"type": "json_object"} برای اجبار به انطباق JSON. همچنین می‌توانید tools برای فراخوانی تابع، به مدل اجازه می‌دهد اقدامات خاصی را اجرا کند. از tool_choice برای کنترل زمانی که مدل تصمیم به فراخوانی یک تابع می‌گیرد. این ویژگی‌ها با کلاینت‌های استاندارد OpenAI-compatible سازگار هستند و یکپارچه‌سازی را برای برنامه‌های موجود ساده می‌سازند.

Copyfrom openai import OpenAI

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

درک محدودیت‌های توکن

پنجره زمینه خود را مدیریت کنید تا از truncation یا خطاها جلوگیری کنید. مدل از پنجره زمینه 100,000 توکنی برای پرامپت و خروجی ترکیبی پشتیبانی می‌کند. هر درخواست می‌تواند تا 16,000 توکن خروجی داشته باشد، یا 2,048 اگر مشخص نکنید max_tokens. شما محدود به 300 درخواست در دقیقه و 8 درخواست همزمان به ازای هر کلید هستید. اندازه بدنه درخواست نباید از 8 MB تجاوز کند. تجاوز از این محدودیت‌ها منجر به کدهای خطای HTTP خاص می‌شود.

Copyimport OpenAI from "openai";

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