دليل إعداد OpenCode

نظرة عامة

يقرأ OpenCode المزوّدين من ملفّ إعداد JSON. أضف UnoRouter مع المحوّل المتوافق مع OpenAI لاستخدام أي نموذج من UnoRouter.

إعداد سريع

الصق هذه في العميل. يُملأ مفتاحك تلقائيًا عند تسجيل الدخول.

عنوان URL الأساسي: https://api.unorouter.com/v1
مفتاح API: YOUR_API_KEY

التوافق

الإعداد خطوة بخطوة

1. 1
   افتح ملف إعداد OpenCode

   اضغط Ctrl + O داخل OpenCode والصق المسار. على Windows، استبدل YOUR_USER باسم المستخدم لديك.

   text

   C:/Users/YOUR_USER/.config/opencode/opencode.json

   سجّل الدخول لتعبئة مفتاح API تلقائياً

2. 2
   استبدل محتوى الملف

   امسح الملفّ والصق كتلة مزوّد UnoRouter. أضف مفتاح API واختر نموذجًا من الكتالوج.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "discoverModels": true,
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         }
       }
     }
   }

   سجّل الدخول لتعبئة مفتاح API تلقائياً

3. 3
   احفظ وأعد التحميل

   اضغط Ctrl + S، ثمّ Ctrl + Shift + P وشغّل Developer: Reload Window.

4. 4
   اختر نموذجا

   افتح منتقي النماذج وانتقل إلى نموذجك الجديد. يتكفّل المحوّل بالبثّ واستدعاء الأدوات.

النماذج الموصى بها

نماذج مجانية تعمل هنا. الصق أي معرّف نموذج في العميل.

ملاحظات مهمة

• !مع "discoverModels": true، يجلب OpenCode كتالوج UnoRouter الكامل من ‎/v1/models عند الإقلاع، فتظهر كلّ النماذج في المنتقي دون سردها يدويًا.
• !إن لم يُظهر Developer: Reload Window مزوّدك، فتحقّق أنّ ملفّ JSON حُفظ بلا فواصل زائدة.
• !استخدم معرّفات النماذج تمامًا كما في كتالوج UnoRouter. احذف أي بادئة مزوّد أضافها النسخ واللصق.
• !بلا الاكتشاف التلقائي، تحتاج إصدارات OpenCode الأقدم إلى كتلة "models" تسرد المعرّفات بدقّة (مثل {"gemini-3.1-flash-lite": {}}) وإلى إعادة تشغيل.