کلیدهای OpenRouter: راهنمای شروع سریع

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

کلید API شما هر درخواستی را به endpoint ما احراز هویت می‌کند. از URL پایه https://api.openrouteraikeys.com/v1 و کلید خود را در Authorization header. این پیکربندی با هر SDK سازگار با OpenAI کار می‌کند زیرا الگوی احراز هویت استاندارد آن‌ها را بازتاب می‌دهیم. نیازی به تغییر کتابخانه کلاینت خود ندارید، فقط پیکربندی URL پایه.

• هدر: Authorization: Bearer YOUR_API_KEY
• URL پایه: https://api.openrouteraikeys.com/v1

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

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

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

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

کلاینت را با کلید خود و URL پایه سفارشی مقداردهی اولیه کنید. این به شما امکان می‌دهد از chat.completions.create روش بدون پیچاندن منطق اضافی. کتابخانه سریال‌سازی و منطق retry را به طور خودکار برای شما مدیریت می‌کند.

Copyfrom openai import OpenAI

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

پیکربندی کنید OPENAI_API_KEY و OPENAI_BASE_URL متغیرهای محیطی یا آن‌ها را مستقیماً به سازنده مشتری پاس دهید. این تضمین می‌کند که تمام تماس‌های بعدی از طریق نقطه پایانی بدون سانسور ما مسیریابی شوند. می‌توانید همان نسخه SDK که قبلاً نصب کرده‌اید را ادامه دهید.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraikeys.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 در درخواست شما. 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)

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

پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن برای ورودی (Prompt) و خروجی (Completion) پشتیبانی می‌کند. شما به ۳۰۰ درخواست در دقیقه به ازای هر کلید محدود هستید. خطای 401 به معنای نامعتبر یا ناموجود بودن کلید API شماست. خطای 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. خطای 429 نشان می‌دهد که از حد نرخ (Rate Limit) عبور کرده‌اید. رد شدن‌ها به دلیل سیاست محتوا رایگان هستند، اما خطاهای محاسباتی ممکن است توکن مصرف کنند.