مزود OpenAI

💡TL;DR

OpenAI يستخدم وسيلة النقل المشتركة المتوافقة مع OpenAI. الإعدادات الافتراضية الحالية تكون gpt-4o، https://api.openai.com/v1، temperature: 0.5، بالإضافة إلى اختبار الاتصال models-then-chat. استخدم هذه الصفحة عندما تحتاج إلى دلالات ميدانية دقيقة؛ واستخدم نظرة عامة LLM Providers للاختيار على مستوى الفئة.

هذا جزء من Obsidian دليل إدارة المعرفة الذكية.

الإعداد

أنشئ مفتاح OpenAI API، أضف ملف تعريف مزود OpenAI في إعدادات Notemd، واحتفظ بالقيمة الافتراضية Base URL ما لم تكن تشير عمدًا إلى بوابة متوافقة مع OpenAI. يمكن أن يبقى حقل النموذج على gpt-4o للاستخدامات العامة أو يتم استبداله بمعرف نموذج OpenAI آخر يمكن لحسابك استدعاؤه.

استخدم نماذج مخصصة لكل مهمة للتحكم في التكاليف: احتفظ بالنماذج الأقوى للبحث واستخراج المفاهيم وإعادة تنظيم النصوص الطويلة؛ واستخدم نماذج أرخص أو أسرع للترجمة واقتراح الروابط والملخصات القصيرة.

النهاية والمصادقة

الحقل	الإعداد المسبق الحالي
وسيلة النقل	`openai-compatible`
مفتاح API	مطلوب
URL الأساسية	`https://api.openai.com/v1`
النموذج الافتراضي	`gpt-4o`
درجة الحرارة	`0.5`
اختبار الاتصال	`/models`، ثم `/chat/completions`

Notemd يقوم بتنظيم القواعد الأساسية URL المتوافقة مع OpenAI قبل إضافة chat/completions أو models. لا تضف /chat/completions في نهاية Base URL؛ فذلك يخلق مسارًا مكررًا.

اكتشاف النماذج

OpenAI يستخدم المسار العام لاكتشاف النماذج المتوافق مع OpenAI. تطلب إعدادات UI أولاً /v1/models، ثم تتحقق من النموذج المختار عبر طلب دردشة خفيف. إذا فشل الاكتشاف لكن الدردشة لا تزال تعمل، تحقق مما إذا كان مفتاحك يمتلك صلاحية قائمة النماذج أو إذا كانت بوابة ما تحظر عرض قائمة النماذج.

تُعامل نماذج التفكير كحالة حافة في البروتوكول: Notemd يدمج محتوى النصوص الخاصة بالنظام والمستخدم لإنشاء أرقام تفكير OpenAI التي ترفض دور system منفصل، ويعرض reasoningEffort فقط حيث تدعم تعريفات المزود ذلك.

حل المشكلات

401 أو 403: تحقق من المفتاح وإمكانية الوصول إلى المشروع وحالة الفوترة، بالإضافة إلى ما إذا كان النموذج المختار مفعّلاً للمفتاح.
404 في الدردشة: عادةً ما يكون Base URL خاطئًا أو يحتوي بالفعل على /chat/completions.
يظهر النموذج في الوثائق لكنه غير موجود في المحدد: إمكانية الوصول إلى قائمة النماذج وإمكانية الوصول إلى الدردشة نقطتا فشل منفصلتان؛ اختبر معرف النموذج الدقيق يدويًا في ملف تعريف المزود.
يرفض نموذج التفكير الرسائل: استخدم معرف نموذج مغطى بمسار معالجة التفكير OpenAI أو انتقل إلى نموذج دردشة غير تفكيري.

متى يجب استخدامه

استخدم OpenAI عندما تريد المسار الافتراضي المستقر للأكثر توقعًا، أو عندما يكون اكتشاف /v1/models مهمًا، أو عندما يعتمد سير العمل على دلالات نموذج التفكير OpenAI. فضّل استخدام بوابة أو مزود محلي عندما تكون مسائل التوجيه أو الخصوصية أو التحكم في التكاليف أكثر أهمية من السلوك المباشر لـ OpenAI API.

الخطوات التالية

LLM Providers -- إعدادات كاملة، نماذج لكل مهمة، ومنطق إعادة المحاولة
حل المشكلات -- إصلاح أخطاء 401/403 وأخطاء الحد من المعدلات

الإعداد​

النهاية والمصادقة​

اكتشاف النماذج​

حل المشكلات​

متى يجب استخدامه​

الخطوات التالية​