بوابة OpenCode AI: قم بتوصيل نماذج اللغة الكبيرة المتعددة من خلال واجهة برمجة تطبيقات واحدة

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

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

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

لماذا تستخدم بوابة OpenCode AI في المقام الأول؟

تم تصميم OpenCode للعمل مع العديد من المزودين، وتظهر الوثائق العامة دعمًا لتكوين المزود المخصص، قيم baseURL.

• ونقاط النهاية المتوافقة مع OpenAI. تلك المرونة قوية، لكنها تعني أيضًا أنك قد تجد نفسك تدير كل مزود بشكل منفصل عندما يكون كل ما تريده حقًا هو سير عمل برمجي نظيف.
• مفتاح API واحد بدلاً من مفتاح لكل مزود نموذج.
• سطح فواتير واحد بدلاً من عدة لوحات تحكم.
• تبديل أنظف بين النماذج للتعديلات السريعة، المهام طويلة السياق، أو إعادة الهيكلة الثقيلة.

طبقة توجيه يمكن أن تساعد عندما يكون المزود بطيئًا، غير متوفر، أو لم يعد الأنسب للعمل.

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

كيف يدعم OpenCode هذا الإعداد وثائق مزود OpenCode, ، يمكنك تخصيص إعدادات المزود من خلال opencode.json, ، تعيين إعداد مخصص قيم, ، واستخدام @ai-sdk/openai-compatible لمزودي OpenAI-compatible. المستودع العام OpenCode GitHub يوثق أيضًا مسارات التكوين ويؤكد أن الأداة مصممة لمرونة على مستوى المزود.

هذا يعني أنك لا تحتاج إلى حزمة تكامل ShareAI خاصة للبدء. يمكنك إضافة ShareAI كمزود مخصص، الاحتفاظ بمفتاح API الخاص بك في متغير بيئة، ثم اختيار النموذج الذي تريد أن يستخدمه OpenCode.

الخطوة 1: قم بإنشاء مفتاح API الخاص بـ ShareAI واختر نموذجًا

ابدأ بإنشاء بيانات الاعتماد في إنشاء مفتاح API. ثم تصفح سوق نماذج ShareAI لتحديد النموذج الذي يجب أن يدعم سير عمل OpenCode الخاص بك.

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

الخطوة 2: أضف ShareAI كمزود مخصص في opencode.json

يتيح لك OpenCode تعريف مزود مخصص بنقطة نهاية متوافقة مع OpenAI. يبدو قالب البداية البسيط كما يلي:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

استبدل نموذجك-في-shareai باستخدام معرف النموذج الدقيق الذي تريد استخدامه من كتالوج نماذج ShareAI. احتفظ بمفتاح API خارج الملف نفسه وقم بتحميله من خلال متغير بيئة بدلاً من ذلك.

export SHAREAI_API_KEY="your_api_key_here"

إذا كنت تريد تنسيق الطلب الأوسع وتفاصيل المصادقة، فإن مرجع API يغطي تدفق API الأساسي لـ ShareAI.

الخطوة 3: تبديل النماذج دون إعادة بناء الإعداد الخاص بك

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

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

عندما تكون مفاتيح المزود المباشرة لا تزال منطقية

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

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

خلاصة نهائية

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