OpenRouter: واجهة API موحدة لعدة نماذج ذكاء اصطناعي

يوفر OpenRouter للمطورين كتالوجاً مشتركاً وواجهة API لاختيار نماذج ومزودي ذكاء اصطناعي مختلفين. يعرض الموقع الرسمي نماذج للنصوص والصور والفيديو والصوت، مع طرق تكامل عبر API وSDK للعميل وAgent SDK. تختلف القدرات والأسعار وحدود السياق والمناطق وسياسات المزودين. قبل الدمج، راجع كتالوج النماذج والوثائق الرسمية وصفحة الأسعار.

الإمكانات الرئيسية

• واجهة وكتالوج موحدان: ابحث عن النماذج المتاحة واستدعها عبر API واحدة. يعرض الكتالوج أوصافاً وأسعاراً حالية، ويمكن جلب قائمة النماذج عبر API.
• التوافق مع OpenAI SDK: تشرح الوثائق الرسمية طريقة التكامل. يتطلب الانتقال إعداد عنوان API الأساسي لـ OpenRouter والمفتاح ومعرّف النموذج، والتحقق من دعم النموذج للمعلمات المطلوبة.
• SDK للعميل وAgent SDK: تتوفر إرشادات SDK للعميل باستخدام JavaScript/TypeScript وPython. يساعد Agent SDK في إنشاء تدفقات تتضمن استدعاء الأدوات وحلقات المحادثة وإدارة الحالة. راجع وثائق الإصدار المستخدم.
• توجيه النماذج والمزودين: قد تساعد خيارات التوجيه والبدائل عند تعذر توفر نموذج أو مزود. يعتمد السلوك على الطلب ونقطة النهاية والخطة، ولا يضمن اختيار أقل سعر دائماً أو استمرار الخدمة بلا انقطاع.
• الفوترة حسب النموذج: تُحسب كلفة الاستدلال وفق السعر المنشور للنموذج المختار. قد تختلف الخطط في الرسوم والوصول إلى النماذج وأدوات الميزانية. الأسعار والشروط قابلة للتغيير.
• إعدادات البيانات: لكل مزود سياسة معالجة خاصة به. توثق OpenRouter خيارات لتصفية المزودين على مستوى الحساب أو الطلب. قبل إرسال بيانات حساسة، راجع سياسة المزود وإعدادات الخصوصية.

خطوات البدء

1. أنشئ حساباً وراجع الخطط والكتالوج والفوترة وسياسات البيانات الحالية.
2. أنشئ مفتاح API من لوحة التحكم واحفظه في متغير بيئة أو مدير أسرار. لا تضعه في المستودع أو تطبيق العميل أو السجلات.
3. اختر نموذجاً وراجع متطلبات الإدخال والإخراج والأدوات والوسائط المتعددة. عند استخدام OpenAI SDK، اتبع التعليمات لإعداد baseURL والمفتاح واسم النموذج.
4. اختبر بنماذج بيانات غير حساسة تنسيق الطلب والفوترة ومعالجة الأخطاء والبدائل الاختيارية قبل ربط بيانات حقيقية.
5. حدد ميزانية أو حدوداً للمفاتيح وراجع الاستخدام والفوترة وسياسات المزودين دورياً.

الاستخدام والحدود

تناسب المنصة المطورين الذين يريدون إدارة خيارات نماذج متعددة عبر API واحدة. ويمكن استخدامها لمقارنة النماذج أو بناء تدفقات دردشة ووكلاء أو استدعاء نماذج صور وصوت مدعومة. تعتمد الأدوات والمخرجات المنظمة والوسائط المتعددة على النموذج ونقطة النهاية. تقلل الواجهة الموحدة بعض فروق التكامل لكنها لا تلغي اختلاف المعلمات والأسعار والحدود والسلوك. ولا تضمن زمناً ثابتاً للاستجابة أو الدقة أو التوافر.

تُرسل الطلبات إلى النموذج والمزود المحددين. إعدادات البيانات لدى OpenRouter وسياسات كل مزود مرحلتان منفصلتان. قبل إرسال الشيفرة أو بيانات العملاء أو المعلومات الشخصية، تحقق من الاحتفاظ والاستخدام للتدريب ومنطقة المعالجة والسجلات. افحص مخرجات الذكاء الاصطناعي من حيث السلامة والحقائق داخل التطبيق. تختلف الكلفة حسب النموذج وشروط الخدمة؛ أدرج الأخطاء والبدائل في تقديرات التكلفة والاختبارات.

أسئلة شائعة

ما هو OpenRouter؟

منصة API متعددة النماذج تضم كتالوجاً وواجهة موحدة وأدوات تطوير مثل SDK. يعرض الكتالوج النماذج ونقاط النهاية المتاحة حالياً.

هل يمكن استخدام OpenAI SDK؟

تشرح الوثائق الرسمية طريقة متوافقة. عادةً يلزم إعداد baseURL ومفتاح API واسم النموذج، ثم التأكد من دعم المعلمات المطلوبة.

كيف تُحسب التكلفة؟

تعتمد كلفة الاستدلال على السعر المنشور للنموذج، وقد تضيف الخطط رسوماً أو ميزات مختلفة. راجع الأسعار وسجل الحساب الحاليين.

كيف تعالج بيانات الطلبات؟

لدى OpenRouter ولكل مزود سياسات منفصلة. راجع إعدادات السجلات واستخدام البيانات وتصفية المزودين، وكذلك قواعد الاحتفاظ لدى المزود المختار.