مستندات API

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

از کلید API خود با https://api.routerllm.cc/v1 URL پایه است. با گوگل یا ایمیل و رمز عبور ثبت‌نام کنید تا کلید خود را به‌طور فوری دریافت کنید. نیازی به شماره تلفن نیست. این کلید برای احراز هویت تمام درخواست‌ها به نقطه پایانی chat-completions استفاده می‌شود.

Copycurl https://api.routerllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five python libraries for web scraping."}]
  }'

کلید خود را امن نگه دارید. یک کلید فعال واحد، کلید قدیمی را جایگزین می‌کند اگر کلید جدیدی تولید کنید. خطاها و ردی‌ها رایگان هستند، بنابراین می‌توانید به ایمنی تست کنید.

نقطه پایانی تکمیل چت

پرامپت‌ها را به POST /v1/chat/completions اندپوینت. شناسه مدل uncensored. یک مدل وزن‌باز است که برای استفاده بزرگسالان قانونی تنظیم شده است، نه یک مدل فروشنده مانند GPT یا Claude.

Copyfrom openai import OpenAI

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

پنجره زمینه ۱۰۰,۰۰۰ توکن برای ورودی و خروجی به‌طور مشترک است. به‌طور پیش‌فرض ۱۶,۰۰۰ توکن خروجی دریافت می‌کنید، یا ۲,۰۴۸ اگر max_tokens را حذف کنید max_tokens.

استریم با 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)

این رویکرد تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. از آن هنگامی که رابط‌های چت را می‌سازید که از رندر تدریجی متن بهره می‌برند، استفاده کنید.

فراخوانی تابع و ابزارها

ابزارها را در tools آرایه. مدل فراخوانی تابع را با tool_choice گزینه‌ها. از این برای استخراج داده‌های ساختاریافته یا کارهای خودکار استفاده کنید.

Copyimport OpenAI from "openai";

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

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

حالت JSON و پارامترها

تنظیم response_format به {"type": "json_object"} برای خروجی JSON دقیق. تولید را با temperature, top_p, stop، و seed. جریمه‌ها را برای حضور و تکرار تنظیم کنید تا سبک خروجی را اصلاح کنید.

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

مدیریت خطا و محدودیت‌ها

انتظار خطای 401 برای کلیدهای نامعتبر، 402 برای اعتبار ناکافی و 429 برای محدودیت‌های نرخ را داشته باشید. محدودیت ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید است. حداکثر اندازه بدنه درخواست ۸ مگابایت است.

کد وضعیت را بررسی کنید تا علت را تعیین کنید. با USDT یا USDC شارژ کنید تا ادامه دهید. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید استفاده را متوقف کنید بدون اینکه پول از دست بدهید.

اطلاعات مدل و مصرف توکن

پرس‌وجو GET /v1/models به بررسی مدل‌های موجود. تنها مدل uncensored. این مدل متن ورودی و متن خروجی ارائه می‌دهد. امبدینگ، تصویر یا صوت پشتیبانی نمی‌شود.

مصرف توکن را در هدرهای پاسخ یا انتهای استریم ردیابی کنید. قیمت‌گذاری شفاف است: ۰.۱۵ دلار برای هر ۱ میلیون توکن ورودی و ۰.۵۰ دلار برای هر ۱ میلیون توکن خروجی. اعتبار پیش‌پرداخت تمام مصرف را پوشش می‌دهد.