مستندات API سازگار با OpenAI
کلید AI openrouter خود را در هر کلاینت استاندارد جایگذاری و متن خام و بدون فیلتر دریافت کنید. این راهنما دقیقاً اندپوینتها، پارامترها و محدودیتهایی را پوشش میدهد که برای شروع ساخت بلافاصله نیاز دارید.
احراز هویت و URL پایه
کلید خود را به عنوان توکن Bearer در هدر Authorization استفاده کنید. URL پایه HTTPS://api.openrouteraikey.com/v1 است. این endpoint با SDKهای رسمی OpenAI و هر کلاینت سازگار با OpenAI کار میکند با تغییر base_url و کلید API. نیازی به بازنویسی منطق یکپارچهسازی ندارید. فقط کلید و URL پایه را جایگزین کنید. درخواستهای شما مستقیماً به مدل uncensored ما میروند. مسیریابی پیچیدهای وجود ندارد. قفلشدگی با ارائهدهنده وجود ندارد. ساختار کد موجود خود را حفظ کنید.
اولین درخواست
درخواست POST را به /v1/chat/completions ارسال کنید و شناسه مدل را روی uncensored تنظیم کنید. سیستم بر اساس پرامپت شما متن برمیگرداند. میتوانید بلافاصله با یک دستور curl ساده شروع به آزمایش کنید. این کار تأیید میکند که کلید شما کار میکند و تأخیر را نشان میدهد. شما یک پاسخ مستقیم دریافت خواهید کرد. نیاز به تجزیه هدرهای اضافی نیست. فقط خروجی متن خام.
curl https://api.openrouteraikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "check if port 8080 is open on 10.0.0.5"}]
}'
SDK Python
بسته openai را نصب کنید و آن را به URL پایه ما متصل کنید. این به شما اجازه میدهد از کد Python آشنا استفاده کنید. کلید و نام مدل خود را وارد کنید. پاسخ شامل متن تولید شده است. میتوانید سریع تکرار کنید. این روش برای پردازش دستهای قابل اعتماد است. جزئیات اتصال را برای شما مدیریت میکند. شما فقط روی منطق پرامپت تمرکز کنید.
from openai import OpenAI
client = OpenAI(base_url="https://api.openrouteraikey.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)
Node SDK
از SDK نود OpenAI برای ارسال درخواستها استفاده کنید. baseURL را به اندپوینت ما تنظیم کنید. از شناسه مدل uncensored استفاده کنید. این روش برای سرورهای وب و اسکریپتها عالی است. کتابخانه جزئیات HTTP را مدیریت میکند. یک آبجکت تمیز دریافت میکنید. مدیریت خطاها استاندارد است. میتوانید آن را در هر پروژه Node.js یکپارچه کنید. کدبیس شما را یکپارچه نگه میدارد. به وابستگی اضافی نیاز نیست.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openrouteraikey.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);
استریمینگ و استفاده از توکن
با تنظیم stream به true، پخش زنده را فعال کنید. شما قطعاتی را دریافت میکنید که همانطور که تولید میشوند، ارسال میگردند. این کار تأخیر ادراکشده را برای کاربران کاهش میدهد. قطعه نهایی شامل کل مصرف توکن است. میتوانید هزینهها را بهصورت بلادرنگ ردیابی کنید. این روش برای مکالمات طولانی مفید است. منتظر پاسخ کامل نمیمانید. دادهها همانطور که ایجاد میشوند جریان مییابند. این حس فوری بودن را ایجاد میکند. دادههای usage برای صورتحسابدهی قابل اعتماد هستند.
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)
محدودیتها، خطاها و زمینه
شما ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید دریافت میکنید. پنجره زمینه ۱۰۰,۰۰۰ توکن است. خطاها کدهای HTTP استاندارد را برمیگردانند. ۴۰۱ به معنای کلید نامعتبر است. ۴۰۲ به معنای عدم موجودی است. ۴۲۹ به معنای محدودیت نرخ است. درخواستهای بیش از ۸ مگابایت رد میشوند. حداکثر خروجی ۱۶,۰۰۰ توکن است. خطاها و رد شدنها رایگان هستند. اعتبار پیشپرداخت شما فقط برای مصرف واقعی شارژ میشود. این هزینهها را قابل پیشبینی نگه میدارد. شما فقط برای توکنها پرداخت میکنید. هزینه پنهانی وجود ندارد. تلههای اشتراک وجود ندارد. حریم خصوصی سختگیرانه است. پرامپتها برای آموزش استفاده نمیشوند. با گوگل یا ایمیل ثبتنام کنید. نیاز به شماره تلفن نیست. آزمایش ۷ روزه به شما $0.50 اعتبار میدهد. با USDT یا USDC شارژ کنید. پاداشها در $50، $100 و $200 اعمال میشوند. اعتبار منقضی نمیشود. بازپرداخت استاندارد نیست اما اشتباهات اصلاح میشوند. این یک API مستقیم است. واسطهای وجود ندارد. بوروکراسی شرکتی وجود ندارد. فقط خروجی خام. حالا شروع به ساخت کنید. مدل uncensored آماده است. برای محتوای بزرگسالان از آن استفاده کنید. برای آزادی خلاقیت از آن استفاده کنید. برای تحقیقات از آن استفاده کنید. محدودیت فقط تخیل شماست. ساده نگه دارید. سریع نگه دارید. uncensored نگه دارید.
پرسشهای رایج
چگونه کلید AI OpenRouter دریافت کنم؟
به صفحه دریافت کلید API بروید. با حساب Google یا ایمیل و رمز عبور وارد شوید. کلید بلافاصله نمایش داده میشود. نیازی به شماره تلفن نیست. میتوانید بلافاصله استفاده از آن را آغاز کنید.
اگر اعتبارهایم تمام شود چه میشود؟
خطای ۴۰۲ دریافت خواهید کرد. موجودی خود را با USDT یا USDC افزایش دهید. اعتبار شما منقضی نمیشود. میتوانید هر مبلغ صحیحی بین $۲۰ تا $۵۰۰ اضافه کنید. پاداشها در سطوح بالاتر اعمال میشوند.
آیا مدل بدون سانسور همانند سایر ارائهدهندگان است؟
خیر. این یک مدل وزنباز است که برای عدم رددها بهینهسازی شده است. نه GPT، نه Claude و نه مدل هیچ فروشنده دیگری است. روی سرورهای ما اجرا میشود. از شناسه مدل uncensored استفاده کنید.
کلید خود را اکنون دریافت کنید
ثبتنام کنید، کلید خود را کپی کنید و به آدرس URL پایه جدید متصل شوید. این کل گردش کار است.