مفاتيح OpenRouter ai: دليل البدء السريع

عنوان URL الأساسي & المصادقة

يصادق مفتاح API الخاص بك على كل طلب موجه إلى نقطة النهاية الخاصة بنا. استخدم عنوان URL الأساسي https://api.openrouteraikeys.com/v1 ونقل المفتاح الخاص بك في Authorization الرأس. يعمل هذا الإعداد مع أي مكتبة 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"}]
  }'

تكامل واجهة برمجة تطبيقات Python

قم بتهيئة العميل باستخدام المفتاح الخاص بك وعنوان URL الأساسي المخصص. يتيح لك هذا استخدام الواجهة المألوفة chat.completions.create الطريقة دون تغليف منطق إضافي. تتعامل المكتبة مع التسلسل المنطقي ومنطق إعادة المحاولة تلقائياً لك.

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 في طلبك. يعيد الواجهة البرمجية شرائح أحداث الإرسال من الخادم (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)

حدود، أخطاء & السياق

تدعم نافذة السياق إجمالي 100,000 رمز موزع بين النص المطلوب والإكمال. أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح. يعني الخطأ 401 أن مفتاح الـ API غير صالح أو مفقود. يشير الخطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. يشير الخطأ 429 إلى تجاوز حد معدل الطلبات. الرفض بسبب سياسة المحتوى مجاني، لكن أخطاء الحوسبة قد تستهلك الرموز.