شغّل محرك الإجابات الخاص بـ Perplexica على base URL مخصص لـ OpenAI.
Updated 2026-07-29
يُعِدّ Perplexica، الذي أُعيدت تسميته Vane في upstream، مزوّد OpenAI الخاص به بحقلَي API Key وBase URL. اضبط Base URL على https://api.apisrouter.com/v1، أضف معرّفات النماذج التي تريدها، وكل إجابة بحث تُركَّب عبر البوابة بـ Claude أو GPT أو DeepSeek أو Gemini خلف مفتاح واحد.
إجابة سريعة: حقل Base URL واحد، جيلان من الإعداد.
على الإصدارات الحالية، يكشف مزوّد OpenAI الخاص بـ Perplexica بالضبط حقلين مطلوبين: API Key وBase URL، قابلَين للتعديل في شاشة الإعداد وواجهة الإعدادات، مع تطابقات بيئة موثَّقة OPENAI_API_KEY وOPENAI_BASE_URL. اضبط Base URL على https://api.apisrouter.com/v1، الصق مفتاح بوابة، ثم أضف نماذج المحادثة التي تريدها بمعرّفات الكتالوج الدقيقة. يُمرِّر المزوّد معرّف النموذج كسلسلة نصية عادية عبر /v1/chat/completions، لذا تعمل معرّفات Claude وDeepSeek عبر فتحة مزوّد "OpenAI". على إصدارات Perplexica الأقدم (جيل config.toml، حتى خطي v1.10 وv1.11)، نفس القدرة هي مزوّد CUSTOM_OPENAI: كتلة [MODELS.CUSTOM_OPENAI] بمفاتيح API_KEY وAPI_URL وMODEL_NAME. كلا الجيلين موضَّحان أدناه، لذا طابق الإعداد مع الإصدار الذي تشغّله فعلياً.
# the settings UI fields map to these documented env vars
export OPENAI_API_KEY=sk-APIsRouter-...
export OPENAI_BASE_URL=https://api.apisrouter.com/v1
# then add chat models by id in Settings, e.g. claude-sonnet-4-6كيف يجيب Perplexica على سؤال، وأين يجلس LLM.
Perplexica (ItzCrazyKns على GitHub، بنحو 36 ألف نجمة) هو محرك الإجابات مفتوح المصدر الأشهر بطراز Perplexity: يأخذ سؤالاً، يشغّل عمليات بحث ويب حقيقية عبر نسخة SearxNG مُضمَّنة، يقرأ النتائج، ويجعل LLM يُركِّب إجابة مُستشهَداً بها. أوضاع البحث (السرعة، المتوازن، الجودة) تُوازِن عمق الاسترجاع مقابل زمن الاستجابة، وأوضاع التركيز تُضيِّق المصادر إلى الويب أو النقاشات أو الأوراق الأكاديمية. في 2026 أُعيدت تسمية المشروع Vane في upstream، مع اتباع صورة Docker لذلك؛ انتقلت العمارة ونظام المزوّدين، لذا كل ما هنا ينطبق تحت أي من الاسمين. فتحة LLM هي حيث تعيش جودة التركيب والتكلفة. كل إجابة استدعاء واحد أو أكثر من chat-completions يحمل المصادر المسترجَعة كسياق، ما يجعل محرك الإجابات حِمل عمل ثقيلاً بـ token المدخل: يقرأ النموذج أكثر بكثير مما يكتب. يعامل نظام المزوّدين OpenAI كأحد عدة خلفيات (Ollama، Anthropic، Gemini، Groq، وغيرها)، ومزوّد OpenAI هو الذي يملك Base URL قابلاً للتعديل بحرية، وهذا ما يجعله خطاف البوابة. سلوك واحد يجب معرفته مسبقاً: عندما يكون Base URL أي شيء غير نقطة نهاية OpenAI الجاهزة، يُظهِر Perplexica عمداً قائمة نماذج افتراضية فارغة ويستخدم مُدخَلات النموذج التي تضيفها للمزوّد بنفسك. هذا بالتصميم، لأنه لا يمكنه معرفة ما تخدمه نقطة نهاية مخصصة. إضافة claude-sonnet-4-6 أو deepseek-v4-flash كمُدخَل نموذج هو النصف الثاني من الإعداد، لا حل التفافي.
الإعداد الكامل: الإصدارات الحالية وconfig.toml القديم.
تُعِدّ الإصدارات الحالية كل شيء في التطبيق. عند أول تشغيل تسأل شاشة الإعداد عن المزوّدين؛ بعد ذلك تعيش نفس الحقول في Settings. اختر مزوّد OpenAI، اضبط API Key وBase URL، ثم أضف مُدخَلات نموذج محادثة بالمعرّفات التي تنوي استخدامها. يجب أن تطابق المعرّفات كتالوج البوابة تماماً، وكل مُدخَل تضيفه يظهر في منتقي النموذج بجانب مربع البحث. الجيل القديم قائم على الملفات. إذا كان تثبيتك لا يزال يملك config.toml، فأنت على جيل CUSTOM_OPENAI: املأ الكتلة أدناه وأعِد تشغيل الحاوية. MODEL_NAME يأخذ معرّف نموذج واحد، الذي تعرضه الواجهة حينها كخيار OpenAI المخصص.
[MODELS.CUSTOM_OPENAI]
API_KEY = "sk-YOUR-APISROUTER-KEY"
API_URL = "https://api.apisrouter.com/v1"
MODEL_NAME = "claude-sonnet-4-6"اختيار نموذج تركيب لمحرك إجابات.
لأن منتقي النموذج يقرأ أياً كانت المُدخَلات التي أضفتها مقابل Base URL واحد، اختبار A/B لنماذج التركيب أمر تافه: اسأل نفس السؤال في تبويبين بمُدخَلين وقارن الاستشهادات. سجل الاستخدام لكل مفتاح يسعّر إجابات كل نموذج، وهي الطريقة الصادقة لتقرير ما إذا كان التركيب الحديث يستحق tokensه على مزيج استعلاماتك.
- tokens المدخل تهيمن. إجابة في وضع الجودة يمكن أن تدفع سياقات مسترجَعة كبيرة إلى الموجّه، لذا سعر token المدخل لمعرّفك يحدّد تكلفة عملية البحث، لا الإجابة القصيرة التي يكتبها.
- claude-sonnet-4-6 افتراضي قوي للتركيب المُستشهَد به: يتبع تعليمات التأسيس على المصدر جيداً ويبقى متماسكاً عندما تختلف مقاطع كثيرة.
- النسخ الشخصية أو الفريقية عالية الحجم تعمل جيداً على claude-haiku-4-5-20251001 أو gemini-3.5-flash أو deepseek-v4-flash: تبقى الإجابات مبنية على السياق وتنخفض تكلفة كل بحث بما يكفي لترك وضع الجودة مُفعَّلاً.
- احتفظ بمعرّف حديث كمُدخَل ثانٍ. تجلس مُدخَلات النموذج جنباً إلى جنب في المنتقي، لذا تصعيد سؤال صعب واحد إلى gpt-5.5 هو تغيير قائمة منسدلة، لا تعديل إعداد.
- وضع التركيز الأكاديمي يكافئ نماذج السياق الطويل، لأن ملخصات ومقتطفات الأوراق أضخم من مقتطفات الويب.
ادفع حسب الاستخدام · أقل من السعر الرسمي
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| النموذج | السعر الرسمي | سعرنا |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
أنماط الفشل الخاصة بـ Perplexica.
قائمة النماذج الفارغة هي الكلاسيكية. تضبط Base URL، يصبح المنتقي فارغاً، ويبدو معطَّلاً. ليس كذلك: مع Base URL غير افتراضي، يسرد Perplexica فقط مُدخَلات النموذج التي تضيفها للمزوّد. أضف معرّفاتك وتظهر. التضمينات فتحة منفصلة. يستخدم Perplexica نماذج تضمين لإعادة ترتيب النتائج، ويخدم مزوّد OpenAI التضمينات من نفس Base URL والمفتاح. إذا لم تخدم بوابتك معرّف التضمين الذي تُعِدّه هناك، تنكسر إعادة الترتيب بينما تستمر إجابات المحادثة في العمل. الفصل النظيف هو إبقاء التضمينات على مزوّد Transformers المحلي، الذي يعمل على الجهاز بدون API على الإطلاق، وتوجيه فقط تركيب المحادثة عبر البوابة. إعادة التسمية تُعثِر الأدلة. Perplexica وVane هما نفس المشروع؛ الدروس القديمة تشير إلى صورة Docker باسم perplexica وconfig.toml، بينما تُشحَن النسخ الحالية باسم vane بإعدادات داخل التطبيق ومجلد بيانات دائم. إذا لم يملك تثبيتك config.toml، لا تنشئ واحداً، لا يُقرَأ؛ أعِدّ عبر الواجهة أو متغيرات البيئة الموثَّقة بدلاً من ذلك. SearxNG مستقل. إذا تدهورت الإجابات أو أعادت عمليات البحث لا شيء، فذلك حاوية SearxNG أو إعداد تنسيق JSON الخاص بها، لا نقطة نهاية LLM. Base URL يُحرِّك فقط استدعاءات المحادثة والتضمين.
من يوجّه Perplexica عبر بوابة.
- المستضيفون ذاتياً الذين يستبدلون اشتراك Perplexity ويريدون تركيباً حديث الجودة لكل بحث بأسعار tokens، بمفتاح واحد بدلاً من حساب بائع لكل عائلة نماذج.
- الفرق التي تشغّل محرك إجابات مشترك، حيث يحوّل سجل الاستخدام لكل مفتاح سؤال "كم يكلّفنا البحث" إلى رقم لكل نموذج.
- الإعدادات المركِّزة على الخصوصية التي تُبقي الاسترجاع محلياً بالكامل (SearxNG بالإضافة إلى تضمينات محلية) وتوجّه فقط استدعاء التركيب النهائي خارجاً عبر نقطة نهاية واحدة قابلة للمراجعة.
- الهواة الذين يقارنون نماذج التركيب على نفس الأسئلة: كل مرشّح مُدخَل نموذج واحد مقابل نفس Base URL.
- المطورون الذين لا يملكون وصولاً إلى فوترة بائع معيّن. الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على التسجيل لكل مزوّد.
تحقق من نقطة النهاية وصحّح أخطاء أول عملية بحث.
أكّد أن البوابة تخدم المعرّفات التي أضفتها قبل لوم التطبيق؛ يجب أن تطابق المُدخَلات في المزوّد مخرجات /v1/models تماماً. أعطال أول تشغيل تتبع نمطاً. "No chat model providers configured" يعني أن حقول المزوّد لم تُحفَظ أو أن قائمة النماذج لا تزال فارغة؛ أضف مُدخَل نموذج محادثة واحداً على الأقل. 401 في سجلات الخادم يعني أن المفتاح لا يطابق نقطة النهاية في حقل Base URL. خطأ model-not-found هو خطأ إملائي في معرّف داخل مُدخَل نموذج. أخطاء إعادة الترتيب مع إجابات تعمل تشير إلى فتحة التضمين، وهي حيث يُنقِذك مزوّد Transformers المحلي. وإذا لم يتغيّر شيء بعد تعديل متغيرات البيئة، تذكّر أن الإعداد يستمر في مجلد البيانات؛ الحقول المحفوظة بالفعل في الواجهة تفوز على تغيير بيئة لاحق، لذا عدّلها في Settings. بمجرد تدفّق عمليات البحث، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. محركات الإجابات ثقيلة بالمدخل، ورؤية رقم tokens الحقيقي لكل بحث لمزيج استعلاماتك تتفوق على أي تقدير.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50الأسئلة الشائعة
هل Perplexica هو نفس مشروع Vane؟
نعم. أُعيدت تسمية المستودع الأصلي Vane في 2026، واتبعت صورة Docker ذلك. نظام المزوّدين وتكامل SearxNG وحقل Base URL الموصوف هنا نفسه تحت كلا الاسمين؛ فقط الإصدارات القديمة لا تزال تستخدم اسم Perplexica وconfig.toml.
هل يمكن لـ Perplexica استخدام نماذج Claude أو DeepSeek للإجابات؟
نعم. يُمرِّر مزوّد OpenAI معرّفات النماذج كسلاسل نصية عادية إلى أي Base URL تضبطه. أضف claude-sonnet-4-6 أو deepseek-v4-flash كمُدخَلات نموذج مقابل Base URL الخاص بالبوابة وتظهر في منتقي النموذج مثل أي خيار آخر.
لماذا قائمة النماذج فارغة بعد تغيير Base URL؟
بالتصميم. مع Base URL غير افتراضي، لا يستطيع Perplexica افتراض النماذج التي تخدمها نقطة النهاية، لذا يسرد فقط المُدخَلات التي تضيفها للمزوّد بنفسك. أضف معرّفاتك في Settings وتظهر فوراً.
ما هي مفاتيح إعداد CUSTOM_OPENAI القديمة؟
على جيل config.toml (حتى خطي v1.10 وv1.11)، تأخذ كتلة [MODELS.CUSTOM_OPENAI] مفاتيح API_KEY وAPI_URL وMODEL_NAME. اضبط API_URL على نقطة نهاية البوابة بما فيها /v1 وMODEL_NAME على معرّف كتالوج واحد، ثم أعِد التشغيل.
هل تتوجّه التضمينات عبر Base URL المخصص أيضاً؟
إذا أعددت نماذج تضمين على مزوّد OpenAI، نعم، تستخدم نفس Base URL والمفتاح. معظم إعدادات البوابة تُبقي التضمينات على مزوّد Transformers المحلي بدلاً من ذلك، الذي لا يحتاج API ويترك إعادة الترتيب مستقلة عن نقطة نهاية المحادثة.
هل لا يزال متغيرا البيئة OPENAI_API_KEY وOPENAI_BASE_URL يعملان؟
نعم، هما التطابقان البيئيان الموثَّقان لحقلَي مزوّد OpenAI على الإصدارات الحالية. لاحظ أن القيم المحفوظة بالفعل عبر واجهة الإعدادات تستمر في مجلد البيانات، لذا عدّلها هناك إذا كان التطبيق قد أُعِدّ مرة بالفعل.