The OpenRouter واجهة برمجة التطبيقات موضح
تسمح لك واجهة برمجة التطبيقات المتوافقة مع OpenAI بتبديل قاعدة التعليمات البرمجية الخاصة بك إلى مزود جديد دون إعادة كتابة المنطق، وهو أمر حرج عندما تحتاج إلى نماذج غير خاضعة للرقابة لحالات استخدام محددة. يشرح هذا الدليل كيف تعمل عناوين URL الأساسية، وتسعير الرموز المميزة، والتدفق بحيث يمكنك دمج نقطة نهاية بديلة بشكل موثوق.
آخر تحديث
ملخص
- استخدم نقطة النهاية القياسية /v1/chat/completions مع أي SDK لـ OpenAI عن طريق تغيير عنوان URL الأساسي فقط.
- تسعير الرموز مسبق الدفع وشفاف، حيث يفرض رسومًا فقط على الاستخدام الفعلي بدون اشتراكات شهرية.
- تسمح الاستجابات التدفقية عبر SSE بتسليم الرموز في الوقت الفعلي، وهو أمر أساسي لواجهات الدردشة.
- تدعم استدعاء الوظائف ووضع JSON لاستخراج البيانات المهيكلة وتكامل الأدوات.
ما هي واجهة برمجة التطبيقات المتوافقة مع OpenAI؟
هي واجهة برمجة تطبيقات REST تتبع واجهة chat-completions الخاصة بـ OpenAI. ترسل المطالبات وتتلقى مخرجات نصية باستخدام حمولات JSON القياسية. يعني هذا التوافق أن كود العميل الحالي الخاص بك يعمل بدون تغييرات كبيرة.
النقطة النهائية الأساسية هي POST /v1/chat/completions. تقبل الرسائل كمصفوفة من كائنات الدور والمحتوى. يمكنك أيضًا سرد النماذج المتاحة عبر GET /v1/models. يقلل هذا التوحيد من وقت التكامل بشكل كبير.
توفر خدمتنا هذه الواجهة بالضبط. نخدم نموذجاً واحداً غير خاضع للرقابة تحت المعرف "uncensored". يعمل على خوادمنا الخاصة. لا يقوم بتوجيه الطلبات إلى مزودين آخرين. تحصل على وصول مباشر إلى النموذج الذي تحتاجه.
تدعم نوافذ السياق ما يصل إلى 100,000 رمز إجماليًا. حدود المخرجات هي 16,000 رمز لكل طلب. التدفق متاح عبر أحداث الإرسال الخادم. دعم استدعاء الوظائف ووضع JSON مدعوم بالكامل.
فهم عناوين URL الأساسية ومفاتيح API
يشير عنوان URL الأساسي إلى الخادم الذي يتعامل مع طلباتك. تستبدل عنوان URL الافتراضي لـ OpenAI بنقطة النهاية الخاصة بنا. عنوان URL الأساسي لدينا هو HTTPS://api.openrouterabliterated.com/v1. يوجه هذا التغيير حركة المرور إلى البنية التحتية الخاصة بنا غير الخاضعة للرقابة.
مفاتيح API مصادقة طلباتك. تنشئ مفتاحاً واحداً لكل حساب. يظهر المفتاح فوراً بعد التسجيل. يمكنك استبداله إذا لزم الأمر. يحتفظ كل حساب بمفتاح نشط واحد في كل مرة.
تُفرض حدود المعدلات لكل مفتاح. يمكنك إرسال 300 طلب في الدقيقة. يمكن تشغيل 8 طلبات في وقت واحد. يتم تقييد حجم جسم الطلب بـ 8 ميجابايت. تتعامل هذه الحدود بشكل جيد مع الاستخدام عالي الحجم.
يتطلب التسجيل بريداً إلكترونياً أو حساب Google فقط. لا يلزم رقم هاتف. يظهر المفتاح على الفور. يمكنك بدء إرسال الطلبات على الفور. الخصوصية محفوظة؛ لا تُستخدم المطالبات للتدريب.
لwhy تختار نموذجًا غير مقيد لحالة الاستخدام الخاصة بك؟
لا ترفض النماذج غير الخاضعة للرقابة المحتوى البالغ القانوني أو الخيالي أو المواضيع المثيرة للجدل. إنها مثالية للكتابة الإبداعية، أو لعب الأدوار، أو البحث. غالبًا ما تطبق النماذج السارية حواجز صارمة. يمكن أن تعطل هذه الحواجز تدفق التوليد.
نموذجنا مضبط للإجابة مباشرة. يتعامل مع المحتوى البالغ دون مقاومة. يعمل بشكل جيد لفلسفة السياسة أو الأنواع المتخصصة. تحصل على سلوك متسق دون حاجة إلى نصوص إضافية.
يدعم استخدام الأدوات. يمكنك تعريف الأدوات لتطبيقك. يحترم النموذج خيارات الأدوات. هذا يجعله مناسباً لسير العمل المعقد. الأخطاء والرفضات مجانية. تدفع فقط مقابل الاستخدام الفعلي.
لا تزال حدود المحتوى سارية. يتم رفض المحتوى الجنسي الذي يتضمن قاصرين دائمًا. هذا حد صارم. يضمن معايير السلامة الأساسية. كل شيء آخر مسموح به لحالة الاستخدام الخاصة بك.
تسعير الرموز: كيفية حساب التكاليف
يعتمد السعر على استخدام الرموز. تكلف رموز الإدخال $0.15 لكل مليون رمز. تكلف رموز الإخراج $0.50 لكل مليون رمز. تدفع فقط مقابل ما تستخدمه. لا توجد رسوم خفية.
الرصيد مسبق الدفع. تضيف رصيداً بالعملات المشفرة فقط. مقبول USDT على TRC20 أو USDC على Base. أي مبلغ صحيح من $20 إلى $500 مسموح. لا تنتهي صلاحية الرصيد. هذا يتجنب قفل الاشتراك.
رصيد المكافأة متاح على الإيداعات. تحصل على +5% من $50. و+10% من $100. و+15% من $200. هذا يقلل من تكلفتك الفعالة. الأخطاء مجانية. الرفض مجاني. تدفع فقط مقابل الرموز الناجحة.
يحصل الحساب التجريبي على $0.50. وهو صالح لمدة 7 أيام. يتيح لك اختبار واجهة البرمجة (API) بشكل شامل. يمكنك التحقق من التكامل قبل الالتزام بإضافة أموال.
استجابات البث مقابل عدم البث
يرسل البث التتابعي الرموز أثناء إنشائها. يقلل هذا من زمن الاستجابة المُدرَك. يرى المستخدمون النص يظهر في الوقت الفعلي. إنه ضروري لواجهات الدردشة. الانتظار غير المتتابع ينتظر الرد الكامل. يمكن أن يبدو بطيئاً للمخرجات الطويلة.
ندعم البث عبر SSE. يتضمن الشريحة الأخيرة استخدام الرموز. يتيح ذلك تتبع الفواتير بدقة. يمكنك التعامل مع الاستجابات الجزئية بسلاسة. يتم معالجة الأخطاء بشكل متسق.
التدفق غير المتدفق متاح أيضًا. يعيد الاستجابة الكاملة مرة واحدة. هذا أبسط للمعالجة الدفعية. تختار بناءً على احتياجاتك. كلا الوضعين يستخدمان نفس نقطة النهاية.
يمكن تدفق استدعاء الوظائف. يتم تنفيذ الأدوات بمجرد تحديدها. هذا يحسن التفاعلية. يمكنك بدء معالجة المدخلات مبكرًا. تتولى API التعقيد نيابة عنك.
استدعاء الوظائف والإخراج المهيكل
يسمح استدعاء الوظائف للنموذج باستدعاء الأدوات. تحدد مخططات الأدوات في الطلب. يعيد النموذج استدعاءات الوظائف. ينفذ رمزك. هذا يتيح سير عمل معقد. يمكنك بناء وكلاء أو مساعدين.
يفرض وضع JSON إخراجاً مهيكلاً. يُرجع النموذج JSON صالحاً. هذا مفيد لاستخراج البيانات. تحصل على تنسيقات متسقة. يصبح التحليل أسهل. الأخطاء نادرة.
تتحكم معاملات مثل درجة الحرارة و top_p في السلوك. تقيد تسلسلات التوقف الإخراج. تضمن البذور إمكانية إعادة الإنتاج. تقلل العقوبات من التكرار. لديك تحكم دقيق.
يمكن أن يكون اختيار الأداة تلقائياً أو مفروضاً. تحدد تفضيل النموذج. هذا يوجه عملية التوليد. يحسن الموثوقية. تظل تطبيقك قوياً.
مكتبات العملاء وواجهات برمجة التطبيقات (SDKs) الشائعة
تعمل معظم أطر عمل SDK مع تغييرات طفيفة. تقوم فقط بتحديث عنوان URL الأساسي. يبقى باقي الكود كما هو. ينطبق هذا على Python وNode.js وغيرها. عملية التكامل مباشرة وبسيطة.
تعد حزمة OpenAI SDK هي المعيار. فهي تتعامل مع المصادقة وإعادة المحاولة. تمرر مفتاح API الخاص بك. يشير عنوان URL الأساسي إلى خدمتنا. يتم إرسال الطلبات بشكل طبيعي.
البث مدعوم في جميع مكتبات البرمجة (SDKs). تقوم بالتكرار عبر الشقوق. يتوفر استخدام الرموز المميزة في الشق الأخير. هذا يتوافق مع نموذج الفوترة الخاص بنا. يتم التقاط الأخطاء بشكل متسق.
يدعم استدعاء الوظائف في مكتلات SDK الحديثة. تمرر تعريفات الأدوات. تقوم مكتبة SDK بتحليل الردود. ينفذ الكود الخاص بك الأدوات. تستمر الحلقة حتى الانتهاء. إنه فعال وموثوق.
استكشاف الأخطاء الشائعة في واجهة برمجة التطبيقات
تعيد حدود المعدل أخطاء 429. يمكنك إرسال 300 طلب في الدقيقة. يؤدي تجاوز هذا الحد إلى انتظار. نفذ التراجع الأسي. يمنع ذلك إجهاد الخادم.
ترجع المفاتيح غير الصالحة أخطاء 401. تحقق من مفتاح API الخاص بك. تأكد من أنه نشط. استبدله إذا لزم الأمر. يحتوي كل حساب على مفتاح واحد. قم بتوليد مفتاح جديد إذا ضاع.
تحدث أخطاء JSON في وضع JSON. تأكد من صحة المخطط. يجب أن يعيد النموذج JSON صالحًا. إذا فشل، أعد المحاولة. اضبط درجة الحرارة لتحسين الاستقرار.
تحدث مهلات الوقت مع التوليدات الطويلة. قم بزيادة قيمة مهلة الوقت. يقلل التدفق من خطر مهلة الوقت. يتم التعامل مع الاستجابات الجزئية. يمكنك إعادة بناء المخرج الكامل.
الخطوات التالية: الحصول على أول مفتاح API
قم بزيارة صفحة التسجيل. استخدم Google أو البريد الإلكتروني. لا يلزم رقم هاتف. العملية سريعة. تحصل على وصول فوري.
يظهر مفتاح API الخاص بك. انسخه بأمان. استخدمه في SDK الخاص بك. اضبط عنوان URL الأساسي على نقطة النهاية الخاصة بنا. ابدأ بإرسال الطلبات.
أضف رصيدًا بالعملات المشفرة. يتم قبول USDT أو USDC. احصل على رصيد مكافأة للمبالغ الأكبر. الرصيد لا ينتهي. استخدمه بالسرعة التي تناسبك.
اختبر باستخدام رصيد التجربة. يستمر لمدة 7 أيام. تحقق من التدفق واستدعاء الوظائف. استكشف قدرات النموذج. دمجه في تطبيقك. واجهة برمجة التطبيقات جاهزة للإنتاج.
الأسئلة الشائعة
هل النموذج غير المقيد هو نفسه نماذج OpenRouter؟
لا، نموذجنا مستقل. يعمل على خوادمنا الخاصة. إنه ليس GPT أو Claude أو أي نموذج من مزود آخر. إنه مُعدّل لاستجابات غير مقيدة. تحصل على وصول مباشر دون توجيه.
كيف أدفع مقابل واجهة برمجة التطبيقات؟
نقبل العملات المشفرة فقط. نيدعم USDT على TRC20 أو USDC على Base. تتراوح مبالغ الإيداع من $20 إلى $500. يُضاف رصيد مكافأة للمبالغ الأكبر. الرصيد لا ينتهي صلاحيته.
هل يمكنني استخدام هذا مع واجهة برمجة التطبيقات الخاصة بـ OpenAI؟
نعم، متوافق تمامًا. غيّر عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا. استخدم نفس طريقة المصادقة. باقي كودك يبقى كما هو. يعمل البث المباشر واستدعاء الوظائف كما هو متوقع.
ما هي حدود معدل الطلبات؟
يمكنك إرسال 300 طلب في الدقيقة. يمكن تشغيل ما يصل إلى 8 طلبات في وقت واحد. يتم تحديد حجم الطلبات بـ 8 ميجابايت. تتعامل هذه الحدود مع الاستخدام عالي الحجم بشكل جيد. الأخطاء والرفض مجانيان.
احصل على مفتاح API الخاص بك
سجّل، انسخ المفتاح، حدّث عنوان URL الأساسي الخاص بك. هذا كل شيء.
