مستندات API: تکمیل‌های چت

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

آدرس پایه https://api.routeria.cc/v1. کلید API خود را در Authorization هدر. خطاها و رد شدن‌ها رایگان هستند، بنابراین فقط برای توکن‌های تولید شده پرداخت می‌کنید.

• GET /v1/models مدل‌های موجود را فهرست می‌کند.
• POST /v1/chat/completions تولید متن را مدیریت می‌کند.

احراز هویت سخت‌گیرانه است. خطای 401 به معنای نامعتبر یا ناموجود بودن کلید شماست. خطای 402 نشان‌دهنده اعتبار از پیش پرداخت‌شده ناکافی است. می‌توانید با USDT (TRC20) یا USDC (Base) شارژ کنید.

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

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید. شناسه مدل uncensored. این یک مدل با وزن باز است که برای پاسخ‌دهی بدون رد محتوای بزرگسالان قانونی بهینه‌سازی شده است.

شما باید Content-Type هدر به application/json. بدنه درخواست شامل شناسه مدل و آرایه پیام‌های شما است.

خطاها از اعتبار شما مصرف نمی‌نکنند. می‌توانید کلید خود را با فراخوانی ابتدا نقطه پایانی مدل‌ها بررسی کنید.

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

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

از SDK رسمی Python OpenAI استفاده کنید. URL پایه را به https://api.routeria.cc/v1 و کلید API خود را ارائه دهید. شناسه مدل باقی می‌ماند uncensored.

این رویکرد کد موجود شما را دست‌نخورده نگه می‌دارد. شما فقط شی پیکربندی را تغییر می‌دهید. SDK سریال‌سازی JSON و منطق تلاش مجدد را به‌طور خودکار مدیریت می‌کند.

پشتیبانی از استریم از طریق stream پارامتر. قطعاتی از متن را همان‌طور که تولید می‌شوند دریافت می‌کنید.

Copyfrom openai import OpenAI

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

استفاده Node SDK

کلاینت را با URL پایه و کلید صحیح مقداردهی دهید. شناسه مدل را uncensored در فراخوانی‌های تکمیل خود.

SDK Node پیاده‌سازی Python را بازآفرینی می‌کند. می‌توانید پاسخ‌ها را جریان دهید یا منتظر تکمیل کامل بمانید. استفاده از توکن در قطعه نهایی گزارش می‌شود.

اطمینان حاصل کنید که متغیرهای محیطی کلید را به صورت امن ذخیره می‌کنند. کلید API بلافاصله پس از ثبت‌نام از طریق Google یا ایمیل نمایش داده می‌شود.

Copyimport OpenAI from "openai";

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

استریمینگ و استفاده از توکن

استریمینگ را با تنظیم stream: true در درخواست خود. شما برای هر توکن، رویدادهای سرگرم‌شده سرور (SSE) دریافت می‌کنید.

آخرین قطعه شامل آمار کامل استفاده از توکن است. توکن‌های ورودی با نرخ $0.15 به ازای هر 1M توکن محاسبه می‌شوند. توکن‌های خروجی با نرخ $0.50 به ازای هر 1M توکن هزینه دارند.

استریمینگ تأخیر ادراک‌شده را کاهش می‌دهد. می‌توانید متن را هنگام دریافت نمایش دهید. پنجره زمینه از مجموع 100,000 توکن پشتیبانی می‌کند.

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

فعال‌سازی فراخوانی تابع با tools پارامتر. مدل از tool_choice برای کنترل دقیق. از response_format: {"type": "json_object"} برای خروجی ساختاریافته.

این امر تجزیه‌سازی یکسانی در برنامه شما تضمین می‌کند. مدل برای پاسخ‌های واضح و ساختاریافته بهینه‌سازی شده است.

می‌توانید ابزارها را با استریم ترکیب کنید. مدل توابع را در صورت نیاز فراخوانی می‌کند. تمام پارامترهای مانند temperature و top_p پشتیبانی می‌شوند.

پارامترها: دما، Top-P، Stop

تنظیم temperature برای خلاقیت. مقادیر پایین‌تر خروجی‌ها را قطعیت‌بخش‌تر می‌کنند. top_p نمونه‌گیری هسته (Nucleus sampling) را کنترل می‌کند. مقدار stop sequences برای توقف تولید.

Other supported parameters include seed, presence_penalty، و frequency_penalty. این‌ها به سبک‌دهی سبک خروجی کمک می‌کنند.

حداکثر خروجی پیش‌فرض ۲,۰۴۸ توکن است. می‌توانید آن را تا ۱۶,۰۰۰ توکن در هر درخواست افزایش دهید. پنجره زمینه کل ۱۰۰,۰۰۰ توکن است.

Limits and Quotas

هر کلید API محدود به ۳۰۰ درخواست در دقیقه است. می‌توانید ۸ درخواست همزمان به ازای هر کلید داشته باشید. اندازه بدنه درخواست به ۸ مگابایت محدود است.

خطای ۴۲۹ نشان می‌دهد که به محدودیت نرخ دسترسی پیدا کرده‌اید. قبل از تلاش مجدد صبر کنید. هر حساب یک کلید فعال دارد؛ کلید جدید کلید قبلی را جایگزین می‌کند.

شناسه مدل همیشه uncensored. این مدل GPT، Claude یا هیچ مدل فروشنده دیگری نیست. این یک مدل با وزن باز است که روی سرورهای ما اجرا می‌شود.