routerapi را در عرض چند دقیقه ادغام کنید

تنظیم احراز هویت و URL پایه

تغییر base_url و api_key برای تغییر فوری ارائه‌دهنده. SDK خود را به HTTPS://api.routerapi.cc/v1 اشاره دهید و از کلیدی که از داشبورد خود تولید کرده‌اید استفاده کنید. نیاز به قوانین مسیریابی پیچیده یا پیکربندی چندمدلی نیست. هدرها و تنظیمات کلاینت موجود شما دقیقاً مشابه استاندارد OpenAI باقی می‌مانند.

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

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

یک درخواست استاندارد POST request to /v1/chat/completions برای تولید متن. این اندپوینت همان ساختار JSON مورد استفاده توسط OpenAI را می‌پذیرد، بنابراین مطمئن شوید که پرامپت‌های شما بدون تغییر کار می‌کنند. از شناسه مدل uncensored برای دسترسی به مدل زبانی بزرگ ما که برای پاسخ‌های بدون محدودیت بهینه‌سازی شده است.

هر درخواست توکن‌ها را از موجودی پیش‌پرداخت شما مصرف می‌کند. خطاها و رد شدن‌ها اعتبار شما را شارژ نمی‌کنند، بنابراین می‌توانید آزادانه آزمایش کنید. مثال زیر یک فراخوانی تولید متن پایه را با استفاده از SDK رسمی نشان می‌دهد.

Copycurl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

پاسخ متن تولید شده را در choices[0].message.content فیلد. می‌توانید پارامترهایی مانند temperature یا top_p برای کنترل خ creativite. هیچ پایانی برای امبدینگ یا تولید تصویر در دسترس نیست؛ این سرویس به طور خاص بر روی تکمیل متن تمرکز دارد.

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

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

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)

قطعه نهایی شامل آمار کامل مصرف توکن برای درخواست است. پارامتر content field from each delta to reconstruct the full message. This approach keeps your UI responsive while the model processes long contexts. Token counts in the final chunk reflect both input and output usage.

استفاده از ابزارها و Function Calling

تعاریف ابزار را در tools پارامتری برای فعال‌سازی فراخوانی تابع. مدل فراخوانی‌های ابزار ساختاریافته را در پاسخ بازگردانده و به جای متن ساده، مشخص کنید tool_choice برای مجبور کردن مدل به استفاده از یک تابع خاص یا انتخاب خودکار. این ویژگی دقیقاً مانند فرمت فراخوانی تابع OpenAI عمل می‌کند.

Copyfrom openai import OpenAI

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

توابع خود را با JSON schema تعریف کنید و آن‌ها را در درخواست ارسال کنید. API مسیریابی بین تولید متن و فراخوانی ابزار را مدیریت می‌کند. Use response_format پارامتر با {"type": "json_object"} برای خروجی JSON دقیق زمانی که ابزارها مورد نیاز نیستند. این تضمین‌کننده داده‌های ساختاریافته یکسان برای سرویس‌های بک‌اند شماست.

تنظیم حالت JSON برای خروجی ساختاریافته

مدل را مجبور به خروجی JSON معتبر کنید با تنظیم response_format به {"type": "json_object"}. این برای تجزیه داده‌ها در جریان‌های کاری خودکار یا عامل‌های هوش مصنوعی ضروری است. مدل تلاش می‌کند تا تمام براکت‌ها را ببندد و از طرح درخواستی پیروی کند. خطاها ممکن است در صورتی رخ دهند که خروجی برای پنجره زمینه بیش از حد طولانی شود.

Copyimport OpenAI from "openai";

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

حالت JSON را با temperature تنظیم شده روی 0 برای بیشترین قطعیت. از این برای استخراج موجودیت‌ها، قالب‌بندی داده‌ها یا تولید فایل‌های پیکربندی استفاده کنید. مدل بدون سانسور ساختارهای تو در تو پیچیده را به خوبی مدیریت می‌کند. همیشه خروجی را در کد خود اعتبارسنجی کنید قبل از پردازش.

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

پنجره زمینه (context window) تا ۱۰۰,۰۰۰ توکن را برای ترکیب پرامپت و تکمیل (completion) پشتیبانی می‌کند. هر درخواست می‌تواند تا ۱۶,۰۰۰ توکن خروجی دهد، یا ۲,۰۴۸ اگر max_tokens تنظیم نشده است. قیمت‌گذاری 0.15 دلار به ازای هر میلیون توکن ورودی و 0.50 دلار به ازای هر میلیون توکن خروجی است. اعتبار هرگز منقضی نمی‌شود و خطاها رایگان هستند.

مصرف خود را از طریق داشبورد یا هدرهای پاسخ ردیابی کنید. درخواست‌ها به اندازه بدنه ۸ مگابایت محدود هستند. می‌توانید با USDT (TRC20) یا USDC (Base) از ۲۰ دلار شروع به شارژ کنید. اعتبار بونوس با واریزهای بزرگ‌تر افزایش می‌یابد: +5% در 50 دلار، +10% در 100 دلار و +15% در 200 دلار. هیچ هزینه اشتراکی وجود ندارد.