نصب SDK خود
ابتدا کتابخانه رسمی را برای زبان خود نصب کنید. ما بستههای SDK استاندارد OpenAI را که توسط اکثر توسعهدهندگان استفاده میشود، پشتیبانی میکنیم. بسته را از طریق ترمینال خود نصب کنید تا برای مراحل بعدی آماده شوید.
URL پایه و کلید را پیکربندی کنید
مشتری خود را به نقطه پایانی ما هدایت کنید و اعتبارنامههای خود را تنظیم کنید. از https://api.openrouterlimits.com/v1 بهعنوان آدرس پایه (base URL). YOUR_API_KEY با کلیدی که در صفحه دریافت کلید API تولید کردهاید. این پیکربندی با هر کلاینت سازگار با OpenAI با تغییر base_url و کلید API کار میکند.
اولین تکمیل
یک درخواست برای تولید متن ارسال کنید. از شناسه مدل uncensored برای دسترسی به مدل وزنباز بهینهسازی شده ما. این مدل موضوعات بزرگسالان قانونی یا بحثبرانگیز را رد نمیکند. یک درخواست POST به /v1/chat/completions با پیامهای خود.
curl https://api.openrouterlimits.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Process 5000 records in under 2 seconds"}]
}'
پاسخهای استریم
پخش زنده را فعال کنید تا توکنها به صورت بلادرنگ دریافت شوند. مقدار stream به true در بدنه درخواست. شما رویدادهای ارسالشده توسط سرور (SSE) حاوی متن جزئی دریافت خواهید کرد. قطعه نهایی شامل مصرف توکن برای صورتحساب است.
stream = 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 استفاده کنید
فراخوانی تابع یا خروجیهای JSON دقیق را ادغام کنید. از tools پارامتر را برای فراخوانی تابع تنظیم کنید. مقدار response_format به {"type": "json_object"} برای حالت JSON. پارامترهای پشتیبانی شده شامل temperature, top_p, stop, seed, presence_penalty، و frequency_penalty.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouterlimits.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);
مصرف توکن را پایش کنید
مصرف خود را ردیابی کنید و خطاها را بهطور شایسته مدیریت کنید. شما ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید دریافت میکنید. پنجره زمینه 100,000 توکن است. خطاهایی مانند 401 (کلید نامعتبر)، 402 (عدم موجودی) و 429 (محدودیت نرخ) را مدیریت کنید. خطاها و رد شدنها رایگان هستند. اعتبار هرگز منقضی نمیشود.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouterlimits.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)