استخدام Muapi مع OpenCode

أضف Muapi إلى OpenCode كمزوّد مخصص متوافق مع OpenAI لاستخدام نماذج Muapi النصية.

1. أنشئ مفتاحًا واختر نموذجًا

أنشئ مفتاح API من لوحة تحكم Muapi، ثم اعرض قائمة النماذج النصية:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

اختر نموذجًا يتضمن capabilities.tools: true. يحتاج OpenCode إلى دعم الأدوات لتحرير الملفات وتنفيذ أوامر الطرفية.

2. أضف Muapi كمزوّد

عيّن متغير البيئة MUAPI_API_KEY في الصدفة التي تشغّل OpenCode (macOS أو Linux):

export MUAPI_API_KEY="your-muapi-api-key"

أضف المزوّد إلى ملف الإعداد opencode.json للمشروع أو للمستخدم:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "muapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Muapi",
      "options": {
        "baseURL": "https://api.muapi.ai/v1",
        "apiKey": "{env:MUAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "Muapi text model" }
      }
    }
  }
}

استبدل YOUR_MODEL_ID بالمعرّف الدقيق من قائمة نماذج Muapi. احتفظ بالمفتاح في متغير البيئة، ولا تضعه في ملف إعداد مشترك أو مضاف إلى المستودع.

3. اختر النموذج

شغّل OpenCode ونفّذ /models، ثم اختر النموذج ضمن مزوّد Muapi. ابدأ بمهمة برمجية صغيرة وتأكد من إمكانية قراءة ملف وتعديله.

استكشاف الأخطاء وإصلاحها

• إذا لم يظهر Muapi في /models، فتحقق من صياغة الإعداد ومعرّف النموذج وإمكانية قراءة الملف.
• عند خطأ المصادقة، تأكد من تعيين MUAPI_API_KEY في بيئة تشغيل OpenCode.
• إذا لم يستخدم النموذج الأدوات، فاختر نموذجًا بقيمة capabilities.tools: true.
• قد تستهلك مطالبات المستودعات الكبيرة الرصيد سريعًا. ابدأ بمهمة محدودة وتحقق من الاستخدام في لوحة Muapi.

راجع توثيق مزوّدي OpenCode لمعرفة خيارات الإعداد الحالية.