نقاط نهاية بوابة AI ومتغيرات البيئة

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

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

تستمع خدمة الوكيل لبوابة AI على http://127.0.0.1:11580. للتوافق مع SDKs والأدوات الخاصة بموردين مختلفين، توفر البوابة نقاط نهاية بتنسيقات بروتوكول متعددة على نفس المنفذ:

تنسيق البروتوكول	مسار نقطة النهاية	سيناريو الاستخدام
متوافق مع 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 وغيرها

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

المصادقة: استخدام المفاتيح الافتراضية

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

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

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

تفترض الأمثلة التالية أنك حصلت على مفتاح افتراضي (يُشار إليه بـ <你的虚拟密钥>).

SDK / أدوات متوافقة مع 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 هو النموذج الذي قمت بتكوينه في القنوات والمسموح للمفتاح الافتراضي باستدعائه.

المتطلبات المسبقة

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

الأسئلة الشائعة (FAQ)

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

الخلاصة

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