نقطة نهاية API مخصصة: كيفية ربط API متوافق مع OpenAI
ما هي نقطة نهاية API المخصصة وما هو Base URL، وكيفية ربط API متوافق مع OpenAI أو مُرحِّل أو بروكسي أو بوابة بعنوان ومفتاح فقط.
- نقطة نهاية API المخصصة (custom API endpoint) هي عنوان الويب، أو العنوان الأساسي (Base URL)، لخدمة ذكاء اصطناعي غير مدمجة في تطبيقك، مثل API متوافق مع OpenAI، أو مُرحِّل (relay)، أو بروكسي (proxy)، أو بوابة (gateway). ولربطها في Oriveo يكفي عادةً أمران: ذلك العنوان ومفتاح API.
- يتعرّف Oriveo على البروتوكول تلقائيًا (OpenAI Chat Completions أو OpenAI Responses أو Anthropic Messages أو Gemini)، ويضيف مسار الإصدار، مثل /v1، حين يُكتب العنوان الجذري وحده.
- يجب أن تستخدم العناوين العامة HTTPS. وأي خدمة طرف ثالث ترى كل ما يمر عبرها، لذا يُخصَّص لها مفتاح مستقل بحد إنفاق، ولا يُعطى لها أبدًا مفتاح المزوّد الرسمي.

ما هو Base URL أو نقطة نهاية API؟
لكل خدمة ذكاء اصطناعي عنوان ويب ترسل إليه التطبيقات طلباتها. يسميه المطورون Base URL (العنوان الأساسي)، أو API endpoint (نقطة نهاية API)، أو request URL (عنوان الطلب)، والمعنى هنا واحد. ويشبه أي عنوان ويب عادي؛ فعنوان OpenAI مثلًا هو https://api.openai.com/v1.
في Oriveo، عناوين المزوّدين الـ 15 المدمجين مضبوطة مسبقًا، فيكفي لصق المفتاح. أما نقطة النهاية المخصصة فلكل ما عدا ذلك: خدمة تقدّم API متوافقًا مع OpenAI، أو مُرحِّل أو بوابة تديرها شركة، أو بوابة تشغّلها على خادمك الخاص.
و«متوافق مع OpenAI» يعني أن الخدمة تقبل الطلبات بالصيغة نفسها التي يستخدمها OpenAI API، فتستطيع التطبيقات المصممة لـ OpenAI التعامل معها. وكثير من المزوّدين والبوابات يقدّمون هذه الصيغة.
المُرحِّل والبروكسي والبوابة: ما الفرق؟
تُستخدم هذه الكلمات بتساهل، وهي من ناحية ربط التطبيق تعمل بالطريقة نفسها: خدمة تقف بين تطبيقك ومزوّدي النماذج، تستقبل طلبك وتمرّره. بعضها يجمع عدة مزوّدين خلف مفتاح واحد وفاتورة واحدة، وبعضها يضيف ضوابط استخدام للفرق، وبعضها برنامج تشغّله على خادمك.
لا يوصي Oriveo بأي منها ولا يرتّبها. وأيًّا كانت الخدمة، فالخطوات أدناه واحدة.
ماذا أحتاج لربط نقطة نهاية مخصصة؟
أمران في العادة، وكلاهما من لوحة تحكم الخدمة أو وثائقها:
- عنوان الطلب (Base URL)، مثل https://api.example.com/v1. ويجب أن يبدأ بـ https:// إن كانت الخدمة على الإنترنت العام.
- مفتاح API أصدرته لك الخدمة. ويمكن إضافة مفاتيح أخرى عبر «إضافة مفتاح آخر».
- اختياريًا: اسم للاتصال، لتمييزه عن غيره.
كيف أضيف نقطة نهاية مخصصة في Oriveo؟
الخطوات واحدة على iPhone وAndroid والويب.
- فتح «مزودو الخدمة» والضغط على زر + («إضافة مزوّد»).
- اختيار شريحة «مخصص»، ثم «مرحل مخصص» («اتصل بخدمة النموذج الخاصة بك»).
- في شاشة «اتصل بمرحل مخصص»، لصق عنوان الطلب ومفتاح API. ويعرض سطر «سيُرسَل الطلب إلى …» العنوان الكامل الذي سيستخدمه Oriveo. ثم الضغط على «التالي».
- يتحقق Oriveo من الاتصال، ويقرأ قائمة النماذج، ويحدد بروتوكول كل نموذج. وهذه الخطوة تقرأ القائمة دون إرسال أي رسالة دردشة.
- تحديد النماذج المطلوبة ثم الضغط على «حفظ (المحدد: N)». وإن لم تعرض الخدمة نماذجها، يُستخدم خيار «إضافة معرّف النموذج يدويًا».
- قبل الحفظ يرسل Oriveo طلبًا صغيرًا واحدًا إلى أول نموذج محدد. ويُحفظ الاتصال حين ينجح هذا الاختبار؛ وإن فشل، تبقى الشاشة على الخطوة نفسها لتصحيح المشكلة.

ضبط كل شيء يدويًا: «الإعداد اليدوي»
يجمع «الإعداد اليدوي» كل شيء في صفحة واحدة: العنوان، والمفتاح، ومعرّف النموذج، واسمًا اختياريًا للاتصال، والبروتوكول الافتراضي الذي يبدأ على الوضع التلقائي. ثم الضغط على «تحقق واحفظ». وإن فشل التحقق، فلا يُحفظ شيء بعد، وتعرض بطاقة الفشل خيار «احفظ على أي حال (غير متحقق)» لمن يريد إبقاء الاتصال واختباره لاحقًا.
هل يتعرّف Oriveo على البروتوكول تلقائيًا؟
في الغالب نعم. تعتمد خدمات الذكاء الاصطناعي واحدة من صيغ قليلة للطلبات تُسمى البروتوكولات. ويدعم Oriveo أربعة منها: OpenAI Chat Completions وOpenAI Responses وAnthropic Messages وGemini generateContent.
ويقرر Oriveo لكل نموذج على حدة: يستخدم ما تذكره الخدمة عن النموذج إن توفرت هذه المعلومة، وإلا فيختار المرشحين الأرجح بحسب عائلة النموذج. وعند الحفظ يُختبر أول نموذج محدد بطلب حقيقي، أما البقية فتُفحص لاحقًا، عند بدء استخدامها.
لذلك يكفي العنوان والمفتاح في معظم الحالات. وإن نصّت وثائق الخدمة على بروتوكول بعينه، أو فشل فحص أحد النماذج، فالحل اختيار البروتوكول يدويًا في «الإعداد اليدوي».
هل يجب إضافة /v1 إلى العنوان؟
عادةً لا. فعند كتابة العنوان الجذري وحده (مثل https://api.example.com)، يضيف Oriveo مسار الإصدار القياسي للبروتوكول: /v1 لصيغتي OpenAI وAnthropic، و/v1beta لصيغة Gemini.
وإن كان العنوان يتضمن إصدارًا، مثل /api/paas/v4، يُبقيه Oriveo كما هو. وإن لُصقت نقطة نهاية كاملة تنتهي بـ /chat/completions أو /responses أو /messages أو :generateContent، يحذف Oriveo هذه النهاية ويستدل بها على البروتوكول الذي تعتمده الخدمة.
يُستحسن مراجعة سطر «سيُرسَل الطلب إلى …» قبل الضغط على «التالي». وإن ظهرت رسالة «قد يشير العنوان إلى صفحة ويب. تحقّق مما إذا كان /v1 ناقصًا.»، فالخطوة التالية مقارنة العنوان بوثائق الخدمة.
| ما يُكتب | ما يطلبه Oriveo (صيغة OpenAI) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1 (باستخدام Chat Completions) |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
ما العناوين المسموح بها؟
يتبع Oriveo بضع قواعد لحماية مفتاحك:
- يجب أن تبدأ العناوين العامة بـ https://. فعنوان http:// على الإنترنت العام لا يمكن اختباره ولا حفظه.
- لا تُقبل العناوين التي تتضمن اسم مستخدم وكلمة مرور، ولا التي فيها معاملات استعلام (أي شيء بعد «?»). ولا يجرّب Oriveo أبدًا مفاتيح API مأخوذة من معاملات الاستعلام.
- عناوين http:// العادية على شبكتك المنزلية أو على شبكة VPN خاصة، مثل خادم نماذج على حاسوبك، تُضاف عبر المدخل المنفصل «الحوسبة المحلية» (على iPhone: «الحوسبة المحلية والشبكة المحلية»)، لا عبر «مرحل مخصص».
- على iPhone وAndroid يتصل التطبيق بالعنوان مباشرة.
- في تطبيق الويب تمر عناوين الطلب العامة عبر خادم Oriveo لتجاوز قيود CORS في المتصفح (قاعدة أمان في المتصفح تمنع كثيرًا من الطلبات المباشرة)، ولا يُحتفظ بمفتاح API في الذاكرة إلا طوال ذلك الطلب، دون حفظه أو تسجيله. أما عناوين الشبكة المحلية فيُتصل بها مباشرةً من جهازك، ويلزم HTTPS في الحالتين؛ لذلك يحتاج عنوان http:// عادي على شبكتك المنزلية إلى تطبيق iPhone أو Android ومدخل الحوسبة المحلية فيه («الحوسبة المحلية والشبكة المحلية» على iPhone، و«الحوسبة المحلية» على Android).
- تبقى المفاتيح على هذا الجهاز فقط ولا تُرفع عبر المزامنة السحابية.
عناوين Base URL للمزوّدين المدمجين
لا حاجة إلى هذه العناوين في Oriveo: يكفي اختيار المزوّد باسمه. ونسردها لأن كثيرين يبحثون عنها لاستخدامها في أدوات أخرى. وكل عنوان منها هو العنوان الرسمي المتوافق مع OpenAI المذكور في وثائق المزوّد، حتى 18 نوفمبر 2026.
- تصف Anthropic طبقة التوافق مع OpenAI لديها بأنها مخصصة للاختبار والمقارنة، ولا يصف دليل البدء السريع لدى Mistral الـ API الخاص بها بأنه متوافق مع OpenAI. لذا يُفضَّل إضافة الاثنين من قائمة المزوّدين المدمجين بدلًا من ذلك.
| المزوّد | Base URL المتوافق مع OpenAI |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI (Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax (الدولي) | https://api.minimax.io/v1 |
| Z.ai (الدولي) | https://api.z.ai/api/paas/v4/ |
| Qwen (إقليم سنغافورة) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi (الدولي) | https://api.moonshot.ai/v1 |
| SiliconFlow (الدولي) | https://api.siliconflow.com/v1 |
هل استخدام مُرحِّل أو API من طرف ثالث آمن؟
الحذر مطلوب. فأي خدمة تقف بينك وبين النموذج تستطيع قراءة ما تكتبه، والملفات التي ترفقها، والردود، وهي تحدد أسعارها بنفسها. ولا يستطيع Oriveo رؤية ما بداخلها ولا ضمانها.
- عدم إعطاء أي خدمة طرف ثالث مفتاح API من حسابك الرسمي لدى المزوّد، واستخدام المفتاح الذي تصدره لك الخدمة.
- إنشاء مفتاح مستقل لـ Oriveo، وضبط حد إنفاق أو إبقاء رصيد صغير عليه إن سمحت الخدمة بذلك.
- عدم إرسال كلمات المرور أو أرقام الهوية أو أعمال سرية عبر خدمة غير موثوقة.
- مراجعة الاستخدام في لوحة تحكم الخدمة نفسها. فأرقام التكلفة في Oriveo تقديرية، وسجلات الخدمة هي النهائية.
- إذا تسرّب مفتاح، يُحذف من لوحة تحكم الخدمة ويُنشأ مفتاح جديد.
لماذا لا تتصل نقطة النهاية المخصصة؟
يبيّن Oriveo سبب المشكلة في سطر واحد. وهذه هي الرسائل كما تظهر بالعربية:
- لأكواد مثل 401 و402 و429، يشرح دليلنا لأخطاء مفاتيح API معنى كل منها.
| الرسالة في Oriveo | ما يُراجَع |
|---|---|
| قد يشير العنوان إلى صفحة ويب. تحقّق مما إذا كان /v1 ناقصًا. | مقارنة العنوان بوثائق الخدمة، وإضافة مسار الإصدار أو حذفه |
| المفتاح غير صالح. | نسخ المفتاح من جديد من لوحة تحكم الخدمة |
| لا يملك هذا المفتاح صلاحية عرض قائمة النماذج. يمكنك إضافة النماذج يدويًا. | إضافة معرّف النموذج يدويًا في الخطوة التالية |
| تعذّر الاتصال. تحقّق من الشبكة أو الوكيل. | التحقق من اتصال الإنترنت ومن إمكانية الوصول إلى العنوان |
| الخدمة على هذا العنوان تحدّ من معدل الطلبات حاليًا. | الانتظار قليلًا ثم إعادة المحاولة |
| تعذّر على هذا الاتصال الوصول إلى مزوّده المصدر. | قد يكون حساب الخدمة نفسها لدى المزوّد غير صالح أو نفد رصيده أو بلغ حد المعدل؛ والحل التواصل مع الجهة المشغّلة لها |
أسئلة شائعة حول التطبيق
ما هي نقطة نهاية API المخصصة؟
ما هو API المتوافق مع OpenAI؟
ما هو Base URL الذي يجب إدخاله؟
هل يمكنني استخدام نقطة نهاية مخصصة على iPhone وAndroid؟
لماذا يشترط Oriveo استخدام HTTPS؟
هل استخدام مُرحِّل أو بروكسي لـ API آمن؟
قراءات ذات صلة
من المدوّنة
ربط خدمة النماذج الخاصة بك
يكفي فتح تطبيق الويب أو تنزيل Oriveo على iPhone أو Android، ثم اختيار «مرحل مخصص» ولصق العنوان والمفتاح من خدمتك.
ليس لديك مفتاح API بعد؟ ابدأ باستخدام Oriveo Free.