ما هي واجهة برمجة التطبيقات (API) لـ OpenRouter؟
تعمل واجهة برمجة تطبيقات OpenRouter كبوابة موحدة إلى نماذج لغوية كبيرة متعددة. بدلاً من إدارة مفاتيح API منفصلة لمزودي مختلفين، ترسل الطلبات إلى نقطة نهاية واحدة. توجه الخدمة طلبك إلى النموذج المحدد وتعيد الإكمال. يبسط هذا التكامل للمطورين الذين يريدون تجربة هياكل مختلفة.
ومع ذلك، تأتي هذه الملاءمة مع قيود على الفئات المجانية. غالبًا ما يواجه المستخدمون حدودًا يومية تتجدد بعد 24 ساعة. إذا أرسلت تطبيقك طلبات أكثر من المسموح به، فستحصل على خطأ 429. صُمم هذا السلوك لإدارة حمل الخادم للمستخدمين المجانيين.
تقدم خدمتنا نهجاً مختلفاً. نقدم نقطة نهاية مباشرة ومتوافقة مع OpenAI لنموذج غير خاضع للرقابة. لا تحتاج إلى القلق بشأن الحصص اليومية. يستمر الكود الخاص بك في العمل دون الوصول إلى حدود مفاجئة. نركز على تكامل المطورين مع الفوترة بالعملات المشفرة المدفوعة مسبقاً. هذا يضمن بقاء البنية التحتية الخاصة بك مستقرة أثناء المهام عالية الحجم.
فهم حدود OpenRouter
حصص الطلبات اليومية هي القيد الأساسي لمستخدمي OpenRouter المجانيين. تختلف هذه الحدود حسب النموذج، حيث يُقتصر بعض النماذج على 50 طلبًا فقط يوميًا. يجبر هذا القيود المستخدمين على إنشاء حسابات متعددة لتوسيع استخدامهم. كما يعطل النصوص الطويلة التي تتجاوز الحصة اليومية.
تزيل واجهة برمجة التطبيقات (API) لدينا هذه الحدود اليومية بالكامل. بدلاً من ذلك، نفرض حدودًا لمعدل الطلبات في الدقيقة. تحصل على 300 طلب في الدقيقة لكل مفتاح. يسمح هذا بحركة المرور المتفجرة دون الحاجة للانتظار حتى اليوم التالي. يتم تقييد التزامن بـ 8 طلبات متزامنة لكل مفتاح. يتم تقييد أحجام طلبات البيانات (request bodies) بـ 8 ميجابايت. صُممت هذه الحدود لمنع الإساءة مع السماح بعمل تطوير جاد.
تدعم نافذة السياق ما يصل إلى 100,000 رمز مرمز. يشمل ذلك كل من النص الوارد والإجابة المولدة. الحد الأقصى للإخراج هو 16,000 رمز مرمز في كل طلب. إذا لم تضبط max_tokens، فإن الحد الافتراضي هو 2,048 رمز مرمز. تتناسب هذه السعة مع معظم مهام التوليد طويلة المدى.
مقارنة التكلفة: OpenRouter معنا
تتقاضى OpenRouter رسوماً عن كل رمز مميز لكل نموذج. تختلف الأسعار بشكل كبير اعتماداً على المزود. تسمح الخطط المجانية باستخدام محدود لكنها لا تتوسع بشكل جيد. تتطلب الخطط المدفوعة اشتراكات أو أرصدة شهرية. إذا تجاوزت الحد اليومي، يجب عليك الانتظار أو الدفع لخطط أعلى.
أسعارنا بسيطة وشفافة. نcharge 0.15 دولار لكل مليون رمز مدخل. تكلفة الرموز المخرجة 0.50 دولار لكل مليون رمز. تدفع مقابل استخدام الرموز الحقيقي. الأخطاء والرفض مجانية. لا رسوم شهرية. لا حاجة لاشتراك. رصيدك المقيد مسبقاً لا ينتهي.
هذا النموذج مثالي للمطورين الذين يريدون تكاليف متوقعة. تقوم بشحن حسابك بالعملات المشفرة. سعر الرمز المميز ثابت. لا تحتاج إلى القلق بشأن تغييرات الأسعار الخاصة بالنموذج. يستمر كودك في العمل دون مواجهة أخطاء 429 المفاجئة. يضمن نظام رصيد الدفع المسبق أنك تدفع فقط مقابل ما تستخدمه.
توفر النموذج: النماذج المُزالة تدريبها
تقدم OpenRouter مجموعة واسعة من النماذج من مزودين مختلفين. يمكن للمستخدمين الاختيار من بين Llama وMistral وهندساتات شائعة أخرى. بعض النماذج معدلة لتكون أقل تقييداً. تُسمى هذه غالباً بالنماذج المُزالة القيود عنها. تزيل الرفض الشائع مع الحفاظ على الذكاء العام.
نركز على نموذج غير خاضع للرقابة محدد واحد. معرف النموذج هو 'uncensored'. إنه نموذج مفتوح الوزن يعمل على خوادمنا الخاصة. تم ضبطه للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس GPT، أو Claude، أو Gemini، أو Grok، أو DeepSeek، أو Qwen، أو Llama، أو أي نموذج من مزود آخر.
يدعم هذا النموذج التدفق عبر SSE. يمكنك استخدام استدعاء الوظائف مع الأدوات. وضع JSON متاح مع response_format json_object. المعلمات مثل temperature, top_p, stop, seed, presence_penalty, و frequency_penalty مدعومة بالكامل. هذا يمنحك تحكماً دقيقاً في عملية التوليد.
حدود معدل الطلبات والتزامن
تحدد حدود معدل الطلبات عدد الطلبات التي يمكنك إرسالها في إطار زمني معين. تقيد الفئة المجانية من OpenRouter عدد الطلبات بـ 50 طلبًا في اليوم لبعض النماذج. هذا حد صارم يتم إعادة تعيينه يوميًا. إذا نفدت منك الطلبات، يجب عليك الانتظار.
تسمح واجهة البرمجة لدينا بـ 300 طلب في الدقيقة. هذه نافذة متحركة. يتم إعادة تعيينها باستمرار. يمكنك إرسال 300 طلب في دقيقة واحدة، ثم الانتظار دقيقة واحدة، وإرسال 300 أخرى. وهذا أكثر مرونة بكثير من الحد اليومي.
يُقتصر التزامن على 8 طلبات في وقت واحد لكل مفتاح. يمنع هذا أن يسيطر عميل واحد على الخادم. إذا كنت بحاجة إلى تزامن أعلى، يمكنك إنشاء المزيد من المفاتيح. يدعم كل حساب مفتاحاً نشطاً واحداً. يستبدل المفتاح الجديد المفتاح القديم. يضمن هذا التصميم استقرار تطبيقك.
مستويات التسعير والمكافآت
نقدم نظام رصيد مدفوع مسبقاً بسيطاً. تقوم بالشحن بالعملات المشفرة فقط. يتم قبول USDT على TRC20 أو USDC على Base. يُسمح بأي مبلغ صحيح يتراوح بين 20 دولاراً و500 دولار. لا توجد رسوم شهرية. لا يلزم اشتراك. لا تنتهي صلاحية رصيدك أبداً.
تُضاف رصيد المكافأة إلى حسابك. تحصل على مكافأة +5% من $50. ومكافأة +10% من $100. ومكافأة +15% من $200. تُضاف هذه المكافأة إلى رصيدك المدفوع مسبقاً. إنها تطيل عمر رصيدك. لا تحتاج إلى دفع المزيد للحصول على قيمة أكبر.
الحسابات الجديدة تحصل على رصيد تجريبي بقيمة $0.50. يسري هذا الرصيد لمدة 7 أيام. لمرة واحدة لكل شخص. سجّل باستخدام Google أو البريد الإلكتروني وكلمة المرور. يظهر المفتاح على الفور. لا يلزم رقم هاتف. الأخطاء مثل الشحن المزدوج تُصلح عبر صفحة الدعم. الرصيد غير قابل للاسترداد، لكنه لا ينتهي صلاحيته أبداً.
توافق SDK
تتوافق واجهة برمجة التطبيقات (API) الخاصة بنا بالكامل مع معايير OpenAI. يمكنك استخدام حزم SDK الرسمية لـ OpenAI. قم بتغيير عنوان URL الأساسي إلى HTTPS://api.openrouterlimits.com/v1. قم بتغيير مفتاح API إلى مفتاحك الخاص. باقي الشفرة الخاصة بك يبقى كما هو.
يتمدد هذا التوافق إلى أي عميل متوافق مع OpenAI. يمكنك استخدام مكتبات مثل LangChain أو LlamaIndex أو عملاء HTTP مخصصين. نقطة النهاية هي POST /v1/chat/completions. يمكنك أيضاً سرد النماذج باستخدام GET /v1/models. لا توجد تضمينات، لا صور، صوت أو توليد فيديو. لا ضبط دقيق. فقط نص مدخل، نص مخرج.
يتم دعم البث المباشر عبر SSE. يتم تضمين بيانات استخدام الرموز في الشريحة الأخيرة. يتيح ذلك تتبع التكاليف في الوقت الفعلي. يتم أيضًا دعم استدعاء الوظائف ووضع JSON. المعلمات مطابقة تمامًا لواجهة برمجة تطبيقات OpenAI. يجعل ذلك عملية الترحيل سهلة.
الأسئلة الشائعة
كيف أدمج مع واجهة برمجة التطبيقات غير الخاضعة للرقابة الخاصة بكم؟ ثبّت الحزمة البرمجية (SDK) المفضلة من OpenAI. اضبط base_url على HTTPS://api.openrouterlimits.com/v1. اضبط مفتاح API على مفتاحك. استدعِ chat.completions.create مع النموذج 'uncensored'. باقي المعلمات قياسية. يعمل التدفق، ووضع JSON، واستدعاء الوظائف كما هو متوقع. لا حاجة لتغييرات في الكود بخلاف عنوان URL الأساسي.
هل رصيد التجربة كافٍ لاختبار واجهة برمجة التطبيقات؟ نعم، يحصل كل حساب جديد على $0.50. وهو صالح لمدة 7 أيام. يمكنك اختبار التدفق، استدعاء الوظائف، ووضع JSON. التكلفة منخفضة بما يكفي للتحقق من التوافق. إذا احتجت إلى المزيد، يمكنك الشحن بالعملات المشفرة. التجربة واحدة لكل شخص.
هل تدعم النماذج المُستأصلة (Abliterated)؟ نقدم نموذجًا غير خاضع للرقابة واحدًا. تم ضبطه للاستخدام القانوني للبالغين. لا يرفض المواضيع المثيرة للجدل. إنه ليس نموذج مورد محدد. إنه نموذج مفتوح المصدر يعمل على خوادمنا. يدعم جميع المعلمات القياسية. يمكنك ضبط درجة الحرارة وtop_p للتحكم بشكل أفضل.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟ تحصل على خطأ 429. الحد هو 300 طلب في الدقيقة. التزامن محدود بـ 8 طلبات. أحجام الطلبات محدودة بـ 8 ميجابايت. يمكنك انتظار إعادة تعيين النافذة. أو يمكنك إنشاء مفتاح جديد. كل حساب يدعم مفتاحاً نشطاً واحداً. يستبدل المفتاح الجديد المفتاح القديم. هذا يتيح لك تجاوز الحد إذا لزم الأمر.
