ar ▾
إنشاء مفتاح

وثائق واجهة برمجة تطبيقات متوافقة مع OpenAI

أدرج مفتاح OpenRouter AI الخاص بك في أي عميل قياسي واحصل على نص خام وغير مقيد. يغطي هذا الدليل نقاط النهاية والمعاملات والحدود الدقيقة التي تحتاجها لبدء البناء فوراً.

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

استخدم مفتاحك كرمز Bearer في رأس Authorization. عنوان URL الأساسي هو HTTPS://api.openrouteraikey.com/v1. تعمل هذه النقطة مع حزم SDK الرسمية لـ OpenAI وأي عميل متوافق مع OpenAI عن طريق تغيير base_url ومفتاح API. لا تحتاج إلى إعادة كتابة منطق التكامل الخاص بك. فقط قم بتبديل المفتاح وعنوان URL الأساسي. تذهب طلباتك مباشرة إلى النموذج غير الخاضع للرقابة لدينا. لا توجيه معقد. لا قفل مورد. احتفظ بهيكل الشفرة الموجود لديك سليمًا.

الطلب الأول

أرسل طلب 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"}]
  }'

واجهة برمجة تطبيقات 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

استخدم حزمة Node SDK لإرسال الطلبات. اضبط عنوان 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. تتلقى أجزاءً بمجرد توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين. يحتوي الجزء الأخير على إجمالي استخدام الرموز. يمكنك تتبع التكاليف في الوقت الفعلي. هذا مفيد للمحادثات الطويلة. لا تنتظر الاستجابة الكاملة. تتدفق البيانات بمجرد إنشائها. يبدو الأمر فورياً. بيانات الاستخدام موثوقة للفوترة.

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)

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

تحصل على 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. نافذة السياق تبلغ 100,000 رمز. تُعيد الأخطاء رموز HTTP القياسية. يعني 401 مفتاحاً غير صالح. يعني 402 عدم وجود رصيد. يعني 429 تجاوز حد السرعة. تُرفض الطلبات التي تزيد عن 8 ميجابايت. الحد الأقصى للإخراج هو 16,000 رمز. الأخطاء والرفضات مجانية. رصيدك المدفوع مسبقاً يُخصم فقط مقابل الاستخدام الفعلي. هذا يجعل التكاليف قابلة للتنبؤ. تدفع فقط مقابل الرموز. لا رسوم خفية. لا فخاخ اشتراك. الخصوصية صارمة. لا تُستخدم المدخلات في التدريب. سجّل باستخدام Google أو البريد الإلكتروني. لا حاجة لرقم الهاتف. التجربة تمنحك $0.50 لمدة 7 أيام. املأ الرصيد بـ USDT أو USDC. تُطبق المكافآت عند $50 و$100 و$200. الرصيد لا ينتهي. الاستردادات ليست قياسية لكن الأخطاء تُصلح. هذه واجهة برمجة تطبيقات مباشرة. لا وسطاء. لا حواجز مؤسسية. مجرد إخراج خام. ابدأ البناء الآن. النموذج غير الخاضع للرقابة جاهز. استخدمه للمحتوى البالغ. استخدمه لحرية الإبداع. استخدمه للبحث. الحد هو خيالك فقط. اجعلها بسيطة. اجعلها سريعة. اجعلها غير خاضعة للرقابة.

الاستفسارات الشائعة

كيف أحصل على مفتاح OpenRouter AI؟

انتقل إلى صفحة الحصول على مفتاح API. قم بتسجيل الدخول باستخدام Google أو البريد الإلكتروني وكلمة المرور. يظهر المفتاح فوراً. لا حاجة إلى رقم هاتف. يمكنك البدء في استخدامه على الفور.

ماذا يحدث إذا نفدت الرصيد الائتماني؟

ستتلقى خطأ 402. قم بإضافة رصيد باستخدام USDT أو USDC. الرصيد لا ينتهي صلاحيته. يمكنك إضافة أي مبلغ صحيح يتراوح بين $20 و $500. تُطبق المكافآت على المستويات الأعلى.

هل النموذج غير المقيد هو نفسه النماذج من موردين آخرين؟

لا. إنه نموذج مفتوح الوزن مضبوط لعدم الرفض. إنه ليس GPT أو Claude أو أي نموذج لمورد آخر. يعمل على خوادمنا. استخدم معرّف النموذج uncensored.

احصل على مفتاحك الآن

سجّل، وانسخ مفتاحك، وجّهه إلى عنوان URL الأساسي الجديد. هذه هي سير العمل بأكمله.

إنشاء مفتاح