نقاط نهاية بوابة الذكاء الاصطناعي ومتغيرات البيئة

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

نقطة النهاية عن طريق الوكيل

توفر خدمة الوكيل الخاصة ببوابة الذكاء الاصطناعي نقطة الاستماع على http://127.0.0.1:11580. لضمان التوافق مع حزم الـ SDK والأدوات من مختلف المزودين، توفر البوابة عدة صيغ من نقاط النهاية على نفس المنفذ:

صيغة البروتوكول	مسار نقطة النهاية	السيناريوهات الملائمة
متوافق مع OpenAI	http://127.0.0.1:11580/v1	أي أداة أو SDK يتبع صيغة OpenAI API (مثل /v1/chat/completions)
متوافق مع Anthropic	http://127.0.0.1:11580/v1/messages	حزم Anthropic SDK مثل Claude Code وغيرها
متوافق مع Gemini	http://127.0.0.1:11580/v1beta	Google Gemini SDK وأدوات Gemini CLI وغيرها

كل ما عليك هو اختيار صيغة البروتوكول حسب الأداة أو الـ SDK الذي تستخدمه، وتوجيه الطلبات إلى عنوان البوابة. ستقوم البوابة بتوجيه الطلبات تلقائيًا إلى القناة المناسبة بحسب صلاحيات المفتاح الافتراضي.

التحقق من الهوية: استخدام المفاتيح الافتراضية

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

في صفحة بوابة الذكاء الاصطناعي → نقاط النهاية (Endpoints)، يمكنك تحديد مفتاح افتراضي، وستقوم البوابة تلقائيًا بإنشاء مقطع متغيرات البيئة الجاهز للنسخ لأدواتك الشائعة.

أمثلة لمتغيرات البيئة

الأمثلة التالية تفترض أنك حصلت على مفتاح افتراضي (وليكن <مفتاحك الافتراضي>).

SDKs أو أدوات متوافقة مع OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<مفتاحك الافتراضي>"

Claude Code / Anthropic

# ملاحظة: بروتوكول Anthropic يستخدم عنوان البوابة بدون /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<مفتاحك الافتراضي>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<مفتاحك الافتراضي>"

مثال على الاستدعاء (متوافق مع OpenAI)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <مفتاحك الافتراضي>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

يجب أن يكون model من بين النماذج التي أعددتها في قسم القنوات ومسموح بها للمفتاح الافتراضي المستخدم.

المتطلبات الأساسية

• خدمة وكيل بوابة الذكاء الاصطناعي يجب أن تكون فعالة.
• تم إعداد قناة واحدة على الأقل وبحالة نشطة، كما تم إنشاء مفتاح افتراضي يملك صلاحية استخدام النماذج/القنوات المناسبة.

الأسئلة المتكررة (FAQ)

• س: الطلب يُعيد فشل في التحقق من الهوية؟
  • ج: تأكد من استخدام المفتاح الافتراضي (وليس مفتاح المزود الأصلي)، وتحقق أن المفتاح صالح وغير منتهي أو ملغى.
• س: تظهر رسالة أن النموذج غير متاح أو غير مصرح به؟
  • ج: تأكد أن قيمة model تم إعدادها ضمن قناة ما وأن صلاحيات المفتاح الافتراضي تتضمنها.
• س: كيف أختار صيغة نقطة النهاية المناسبة؟
  • ج: اختر بناءً على البروتوكول الذي يستخدمه SDK — أدوات OpenAI استخدم /v1، وأدوات Anthropic استخدم /v1/messages (مع عنوان أساسي بدون /v1)، ولـ Gemini استخدم /v1beta.
• س: هل يمكن للأجهزة الأخرى في الشبكة المحلية الوصول إلى البوابة؟
  • ج: بشكل افتراضي، تستمع البوابة فقط على 127.0.0.1 (أي محلي على هذا الجهاز فقط). وذلك من باب الأمان.

الملخص

توفر بوابة الذكاء الاصطناعي نقاط نهاية محلية ومتوافقة مع OpenAI وAnthropic وGemini، متحدة ضمن آلية تحقق موحدة باستخدام المفاتيح الافتراضية. يمكنك ربط أي تطبيق أو أداة ذكاء اصطناعي بالبوابة للاستفادة من إدارة المفاتيح وتتبع الاستخدام. بالنسبة للأدوات الشائعة من نوع CLI، يمكنك تسهيل الأمر أكثر باستخدام الاستحواذ بنقرة واحدة.