مستندات API بدون سانسور

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

از URL پایه و کلید API ارائه‌شده برای شروع ارسال درخواست‌ها استفاده کنید. سرویس ما بر پایه پروتکل OpenAI-compatible اجرا می‌شود، به این معنی که می‌توانید از SDKهای استاندارد با تغییرات پیکربندی اندک استفاده کنید. URL پایه برای تمام درخواست‌ها https://api.openroutereualternative.com/v1. باید کلید API منحصر به فرد خود را در Authorization هدر برای هر درخواست.

احراز هویت ساده و امن است. کلید خود را روی دریافت کلید API صفحه را با استفاده از حساب گوگل یا ایمیل باز کنید. کلید بلافاصله پس از ایجاد نمایش داده می‌شود. آن را به‌طور ایمن ذخیره کنید، زیرا دسترسی کامل به اعتبارات پیش‌پرداخت شما را فراهم می‌کند. ما به شماره تلفن یا مراحل پیچیده‌ی راه‌اندازی نیاز نداریم. داده‌های شما در محیطی مطابقت‌دار بدون هزینه‌های پنهان مسیریابی قرار دارد.

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

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

در زیر یک مثال پایه با cURL آورده شده است. جایگزین YOUR_API_KEY با کلید واقعی خود. بدنه درخواست شامل شناسه مدل، یک پرامپت سیستمی و یک پیام کاربر است. این مثال ماهیت مستقیم و بدون سانسور API ما را بدون اضافه‌بار نشان می‌دهد.

Copycurl https://api.openroutereualternative.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the GDPR compliance docs"}]
  }'

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

از SDK رسمی Python OpenAI با URL پایه سفارشی برای تعامل با API ما استفاده کنید. این روش سازگاری با کدهای موجود که قبلاً از کلاینت‌های OpenAI استفاده می‌کنند را تضمین می‌کند. شما فقط نیاز دارید base_url و api_key پارامترها. شناسه مدل uncensored.

پشتیبانی از استریم از طریق رویدادهای ارسالی سرور (SSE) امکان‌پذیر است. از stream=True پارامتر برای دریافت توکن‌ها همان‌طور که تولید می‌شوند. آخرین قطک شامل کل استفاده از توکن برای درخواست است. این روش برای برنامه‌های بلادرنگ کارآمد است. API ما از پارامترهایی مانند دما، top_p و توالی‌های توقف پشتیبانی می‌کند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openroutereualternative.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 Node.js OpenAI با API ما ادغام کنید. کلاینت را با URL پایه خاص و کلید API خود پیکربندی کنید. شناسه مدل uncensored. این پیکربندی به شما امکان می‌دهد از روش‌های آشنا برای تکمیل گفتگو استفاده کنید. می‌توانید پیام‌های زمینه را ارسال کنید، دما را تنظیم کنید و توالی‌های توقف را تعریف کنید.

فراخوانی تابع از طریق tools پارامتر. همچنین می‌توانید حالت JSON را با استفاده از response_format: {type: "json_object"}. این ویژگی برای استخراج داده‌های ساختاریافته مفید است. API پارامترهایی مانند presence_penalty و frequency_penalty دقیقاً همانطور که انتظار می‌رود. این انعطاف‌پذیری آن را به جایگزینی قوی برای OpenRouter برای توسعه‌دهندگان تبدیل می‌کند.

Copyimport OpenAI from "openai";

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

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

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

استریمینگ تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد. این روش برای رابط‌های چت که نیاز به بازخورد فوری دارند، ایده‌آل است. پنجره زمینه تا 100,000 توکن برای پرامپت و تکمیل ترکیبی پشتیبانی می‌کند. حداکثر خروجی 16,000 توکن در هر درخواست است. اگر max_tokens تنظیم نشده باشد، پیش‌فرض 2,048 توکن است. این تعادل اجازه می‌دهد تا زمینه عمیق بدون غرق کردن محدودیت پاسخ مدیریت شود.

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)

محدودیت‌ها، خطاها و زمینه

محدودیت‌های درخواست خود را پایش کنید تا از وقفه‌های سرویس جلوگیری شود. هر کلید API از ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان پشتیبانی می‌کند. حداکثر اندازه بدنه درخواست ۸ مگابایت است. خطاها به صورت کدهای وضعیت HTTP استاندارد برمی‌گردند. خطای ۴۰۱ نشان‌دهنده کلید API نامعتبر یا موجود نیست است. خطای ۴۰۲ به معنای تمام شدن اعتبار پیش‌پرداخت شماست. خطای ۴۲۹ نشان می‌دهد که از محدودیت نرخ فراتر رفته‌اید.

مصرف توکن شفاف است. توکن‌های ورودی هر میلیون ۰.۱۵ دلار و توکن‌های خروجی هر میلیون ۰.۵۰ دلار هزینه دارند. خطاها و رد شدن درخواست‌ها رایگان هستند. اعتبار فقط از طریق ارز دیجیتال شارژ می‌شود. مدل درخواست‌های مرتبط با اطفال را رد می‌کند اما محتوای بزرگسالان قانونی دیگر را اجازه می‌دهد. این ساختار شفاف هزینه‌های قابل پیش‌بینی را برای برنامه شما تضمین می‌کند.