OpenCode با Muapi

برای استفاده از مدل‌های متنی Muapi، آن را به‌عنوان provider سفارشی سازگار با OpenAI در OpenCode اضافه کنید.

۱. ساخت کلید و انتخاب مدل

در داشبورد Muapi یک API key بسازید و مدل‌های متنی را فهرست کنید:

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

مدلی را انتخاب کنید که capabilities.tools: true داشته باشد. OpenCode برای ویرایش فایل و اجرای فرمان‌های ترمینال به ابزار نیاز دارد.

۲. افزودن Muapi به‌عنوان provider

در shellای که OpenCode را اجرا می‌کند، متغیر MUAPI_API_KEY را تنظیم کنید (macOS/Linux):

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

این provider را به فایل 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 جایگزین کنید. کلید را در متغیر محیطی نگه دارید و در فایل مشترک یا commitشده قرار ندهید.

۳. انتخاب مدل

OpenCode را اجرا کنید، /models را بزنید و مدل Muapi را انتخاب کنید. با یک کار کوچک برنامه‌نویسی بررسی کنید که فایل را می‌خواند و تغییر می‌دهد.

عیب‌یابی

• اگر Muapi در /models نیست، syntax تنظیمات، شناسه مدل و دسترسی به فایل را بررسی کنید.
• اگر احراز هویت خطا می‌دهد، وجود MUAPI_API_KEY در محیط اجرای OpenCode را بررسی کنید.
• اگر مدل از ابزار استفاده نمی‌کند، مدلی با capabilities.tools: true بردارید.
• prompt مخزن بزرگ می‌تواند اعتبار زیادی مصرف کند؛ با کاری محدود شروع کنید و مصرف را در داشبورد Muapi ببینید.

برای گزینه‌های جاری، مستندات providerهای OpenCode را ببینید.