كيفية دمج Gate.AI: دليل سريع للمطورين

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

الشروط المسبقة:

• وجود حساب Gate.AI والوصول إلى إعدادات وحدة التحكم.
• إعداد بيئة محلية مع Python، Node.js، أو curl.

ما المهارات التي ستكتسبها بعد إكمال هذا الدليل؟

بعد إكمال هذا الدليل، ستكون قادرًا على إنشاء مفتاح API لـ Gate.AI، تكوين عنوان URL الأساسي المتوافق مع OpenAI، إرسال أول طلب API باستخدام model: "auto"، واختبار معرف النموذج المحدد.

ما التطبيقات التي يمكن للمطورين بناؤها عبر تكامل Gate.AI API؟

يمكن للمطورين استخدام Gate.AI API للوصول إلى نظام نماذج متعدد من خلال تنسيق طلبات متوافق مع OpenAI، مع سيناريوهات تطبيقية تشمل:

| نوع البناء | دور Gate.AI | مخرجات نموذجية | | ------------------ | ---------------------------------- | --------------------------------- | | تطبيقات الدردشة | توجيه رسائل المستخدم إلى نماذج الدردشة المدعومة | مساعد خدمة العملاء | | الأدوات الداخلية | تكوين API موحد بين الفرق | مساعد كتابة/بحث AI | | الوكلاء الذكيون والأتمتة | ربط استدعاءات النماذج وأتمتة المهام | مساعد استدعاء الأدوات | | اختبار النماذج | مقارنة التوجيه التلقائي بمعرف النموذج الثابت | سكريبت تقييم | | نقل المشاريع | استبدال عنوان URL الأساسي المتوافق مع OpenAI الحالي | نموذج متعدد النماذج الأولي |

عندما ترغب في أن يختار Gate.AI النموذج تلقائيًا، استخدم model: "auto"؛ وإذا كنت تريد تكرار سلوك معين لنموذج محدد، فاملأ معرف النموذج المحدد.

ما التحضيرات التي تحتاجها قبل البدء؟

قبل البدء، يلزم تلبية شرطين رئيسيين:

| الشرط الضروري | السبب المهم | | ------------------ | -------------------------------------------------------- | | وصول إلى حساب Gate.AI | لإنشاء مفتاح API وفحص إعدادات التوجيه | | طريقة الطلب المحلية | لإرسال طلبات اختبار باستخدام Python، Node.js، أو curl |

لا يلزم اختيار جميع النماذج في البداية. تحقق من توفر مفتاح API وURL الأساسي، ثم قم باختبار اختيار النموذج يدويًا.

الخطوة 1: إنشاء مفتاح API لـ Gate.AI

هذه الخطوة ستنشئ بيانات الاعتماد للمصادقة على API الخاص بك.

طريقة العمل:

1. ادخل إلى gate.ai.
2. اختر طريقة تسجيل الدخول وأكمل التفويض.
3. افتح Console → الإعدادات → مفاتيح API.
4. اضغط على إنشاء مفتاح.
5. انسخ مفتاح API واحفظه بشكل آمن.

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

الخطوة 2: اختيار التوجيه التلقائي أو اختيار النموذج يدويًا

هذه الخطوة تحدد ما إذا كان Gate.AI يختار النموذج تلقائيًا، أو يتم تحديده في الطلب.

طريقة العمل:

1. افتح Console → الإعدادات → التوجيه.
2. تحقق من تفعيل التوجيه التلقائي.
3. إذا أردت أن يختار Gate.AI النموذج تلقائيًا لكل طلب، احتفظ بالتوجيه التلقائي مفعلاً.
4. إذا أردت تحديد معرف النموذج يدويًا، أوقف التوجيه التلقائي واملأ معرف النموذج في جسم الطلب.

| وضع الاختيار | قيمة المعامل في الطلب | السيناريو المناسب | | ------------------ | -------------------------------------------- | ------------------------------------- | | التوجيه التلقائي | "model": "auto" | عند الحاجة لتوجيه تلقائي من Gate.AI | | اختيار النموذج يدويًا | "model": "anthropic/claude-sonnet-4.6" | عند الحاجة لاختبار أو استخدام معرف نموذج محدد |

التوجيه التلقائي مناسب للوصول السريع والاختبار العام؛ الاختيار اليدوي مناسب لتقييم قابل للتكرار لنموذج واحد.

الخطوة 3: تكوين عنوان URL الأساسي المتوافق مع OpenAI

هذه الخطوة توجه عميل OpenAI الحالي إلى Gate.AI بدلاً من نقطة النهاية الافتراضية لـ OpenAI.

استخدم عنوان URL التالي:

النص

صيغة المصادقة كالتالي:

النص Authorization: Bearer YOUR_API_KEY

توثيق Gate.AI يحدد أن مسار API هو /openai/v1 وليس فقط /v1 (حتى يونيو 2026). يرجى الالتزام بكتابة عنوان URL كامل بشكل صحيح.

| عنصر التكوين | القيمة | | ------------------ | --------------------------------------------------- | | عنوان URL الأساسي | أدخل هنا | | طريقة المصادقة | Authorization: Bearer YOUR_API_KEY | | التنسيق | متوافق مع OpenAI | | نقطة نهاية الدردشة | POST /chat/completions | | نقطة نهاية نماذج البيانات | GET /models |

معظم أخطاء التكامل تأتي من اختصارات عنوان URL أو نسخ خاطئ لمفتاح API. تحقق من هذين الأمرين قبل تعديل إعدادات النموذج.

الخطوة 4: إرسال أول طلب API

هذه الخطوة لاختبار أن مفتاح API، عنوان URL، وتنسيق الدردشة المتوافق مع OpenAI يعملون بشكل متناسق.

مثال باستخدام Python:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="auto", messages=[ {"role": "system", "content": "أنت مساعد مختصر."}, {"role": "user", "content": "قل مرحبًا من Gate.AI."} ], )

print(completion.choices[0].message.content)

مثال باستخدام Node.js:

javascript import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "", });

const completion = await client.chat.completions.create({ model: "auto", messages: [ { role: "system", content: "أنت مساعد مختصر." }, { role: "user", content: "قل مرحبًا من Gate.AI." } ], });

console.log(completion.choices[0].message.content);

مثال باستخدام curl:

bash curl /chat/completions
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{ "model": "auto", "messages": [ {"role": "system", "content": "أنت مساعد مختصر."}, {"role": "user", "content": "قل مرحبًا من Gate.AI."} ] }'

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

الخطوة 5: اختبار معرف النموذج المحدد

هذه الخطوة تتحقق من أن اختيار النموذج يدويًا يعمل بشكل صحيح عند الحاجة.

قم بتغيير معامل model من auto إلى معرف نموذج محدد يدعم النموذج الذي تريده:

python from openai import OpenAI

client = OpenAI( api_key="YOUR_API_KEY", base_url="", )

completion = client.chat.completions.create( model="anthropic/claude-sonnet-4.6", messages=[ {"role": "user", "content": "اشرح التوجيه في النموذج في فقرة واحدة."} ], )

print(completion.choices[0].message.content)

تأكد من كتابة معرف النموذج بدقة وفقًا لوثائق أو قائمة نماذج Gate.AI. أي خطأ إملائي قد يؤدي إلى فشل الطلب حتى لو كانت مفاتيح API وURL صحيحة.

كيف يعمل التوجيه التلقائي في طلبات Gate.AI API؟

التوجيه التلقائي عبر Gate.AI يتم عن طريق وضع model: "auto" في جسم الطلب، مع إعدادات التوجيه في وحدة التحكم، ليتم اختيار النموذج تلقائيًا. حتى يونيو 2026، يمكن إدارة إعدادات التوجيه من خلال Console → الإعدادات → التوجيه.

| نوع التوجيه | مكان الإعداد | معلمة API في الطلب | | ------------------ | ------------------------------------- | ------------------------------ | | التوجيه التلقائي | Console → الإعدادات → التوجيه | "model": "auto" | | اختيار النموذج يدويًا | جسم الطلب | تحديد معرف النموذج | | التحكم في استراتيجية التوجيه | إعدادات التوجيه في وحدة التحكم | تخصيص السلوك |

التوجيه التلقائي لا يعني حذف حقل النموذج. يجب تحديد حقل model وملؤه بـ "auto" ليعمل التوجيه التلقائي.

أي تكامل يجب أن أختاره؟

اختر طريقة التكامل حسب بيئة تطبيقك:

| الطريقة | السيناريو المناسب | التغييرات الرئيسية | | ------------------------------ | ---------------------------------------- | ------------------------------------- | | SDK Python | لديك سكريبت أو خدمة Python موجودة | إعداد base_url و api_key | | SDK Node.js | تستخدم JavaScript أو TypeScript | إعداد baseURL و apiKey | | curl | تريد التحقق بسرعة | إرسال رؤوس الطلب و JSON مباشرة | | تطبيق متوافق مع OpenAI الحالي | يدعم عنوان URL مخصص أو تكامل مخصص | استبدال عنوان URL و API المفتاح |

معظم المطورين يفضلون التحقق بسرعة باستخدام curl، ثم يدمجون Python أو Node.js في تطبيقاتهم.

ما أسباب فشل طلبات Gate.AI API الشائعة؟

عند مواجهة مشاكل، استعرض القائمة التالية للتحقق:

| العرض | السبب المحتمل | الحل المقترح | | -------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------- | | 401 أو مفتاح API غير صالح | مفتاح API مفقود، منتهي، أو تم نسخه بشكل خاطئ، أو لم يُستخدم Bearer | إعادة إنشاء أو نسخ المفتاح، واستخدام Authorization: Bearer YOUR_API_KEY | | عدم العثور على النموذج | معرف النموذج غير صحيح أو غير متاح للحساب | مراجعة وثائق نماذج Gate.AI، أو اختبار التوجيه بـ model: "auto" | | أخطاء فورية في كود OpenAI المتوافق | عنوان URL غير كامل أو فقط /v1 مكتوب | استخدم عنوان URL كامل ومتوافق مع المثال السابق | | التوجيه التلقائي لا يعمل كما هو متوقع | التوجيه التلقائي مغلق أو إعدادات التوجيه غير صحيحة | تحقق من تفعيل التوجيه التلقائي في Console → الإعدادات → التوجيه | | استجابة فارغة أو استثنائية | تنسيق جسم الطلب غير صحيح أو النموذج غير مدعوم حاليًا | جرب أبسط طلب دردشة، ثم أضف المعاملات تدريجيًا |

ابدأ بالتحقق من المصادقة، ثم عنوان URL، ثم معرف النموذج. غالبًا، يمكن حل معظم مشاكل الوصول السريع عبر هذه الخطوات.

ما المحتوى الذي يمكن تكوينه لاحقًا؟

بعد نجاح الطلب الأول، يمكن للمطورين توسيع التكامل عبر:

• تكوين سلوك التوجيه للنماذج في وحدة التحكم.
• مراجعة توافر النماذج واختيار معرف نموذج ثابت للاختبارات الإنتاجية.
• مقارنة الأسعار واختيار النماذج المناسبة لسيناريوهات الحمل العالي.

الأسئلة الشائعة

لماذا يُنصح باستخدام model: "auto" أولاً؟

لأنه يتيح التحقق من صحة مفاتيح API، عنوان URL، تنسيق الطلب، وإعدادات التوجيه بشكل موحد، قبل اختبار معرف النموذج المحدد.

هل يمكن استخدام SDK OpenAI الحالي مع Gate.AI؟

نعم، يدعم Gate.AI تنسيق API متوافق مع OpenAI، فقط قم بتعيين مفتاح API الخاص بـ Gate.AI واستبدل عنوان URL.

لماذا يفشل الطلب عند التبديل إلى نموذج معين؟

قد يكون معرف النموذج غير موجود، أو مكتوب بشكل خاطئ، أو غير مدعوم من قبل حسابك. تحقق من معرف النموذج في وثائق Gate.AI قبل إعادة المحاولة.

هل يجب إيقاف التوجيه التلقائي عند استخدام نموذج معين؟

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