الانتقال إلى المحتوى الرئيسي
OpenCode هو وكيل برمجة بالذكاء الاصطناعي للـ terminal. يعمل Venice عبر تكوين موفّر OpenCode المخصص باستخدام المحوّل المتوافق مع OpenAI وبـ base URL مخصص.

موفّر مخصص

أضف Venice كموفّر في opencode.json

متوافق مع OpenAI

يستخدم endpoint /chat/completions الخاص بـ Venice

مفتاح البيئة

يقرأ مفتاح API الخاص بك من VENICE_API_KEY

المتطلبات


الإعداد

1

عيّن مفتاح Venice API الخاص بك

صدّر مفتاح Venice API في shell حيث تشغل OpenCode:
export VENICE_API_KEY="your-api-key"
2

أنشئ ملف تكوين OpenCode

لإعداد خاص بالمشروع، أنشئ opencode.json في جذر مشروعك.لإعداد شامل، استخدم ~/.config/opencode/opencode.json بدلًا من ذلك.
3

أضف موفّر Venice

الصق هذا التكوين في opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "venice/zai-org-glm-5-1",
  "small_model": "venice/zai-org-glm-5-1",
  "provider": {
    "venice": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Venice AI",
      "options": {
        "baseURL": "https://api.venice.ai/api/v1",
        "apiKey": "{env:VENICE_API_KEY}"
      },
      "models": {
        "zai-org-glm-5-1": {
          "name": "GLM 5.1"
        },
        "kimi-k2-5": {
          "name": "Kimi K2.5"
        },
        "minimax-m25": {
          "name": "MiniMax M2.5"
        }
      }
    }
  }
}
4

شغّل OpenCode

ابدأ OpenCode من نفس دليل المشروع:
opencode
سيُحمِّل OpenCode opencode.json، ويستخدم VENICE_API_KEY، ويوجّه نموذج Venice المختار عبر https://api.venice.ai/api/v1.

التحقق من الإعداد

داخل OpenCode، شغّل:
/models
يجب أن ترى نماذج Venice من تكوينك. اختر واحدًا، ثم أرسل مطالبة اختبار صغيرة. إذا قمت بتعيين "model": "venice/zai-org-glm-5-1" كما هو موضح أعلاه، يجب أن يستخدم OpenCode نموذج Venice هذا افتراضيًا. يمكنك تغيير الافتراضي باستبدال zai-org-glm-5-1 بأي معرّف نموذج من كتالوج النماذج النصية وإضافته إلى خريطة models.

ملاحظات التكوين

  • احتفظ بـ baseURL مُعيَّنًا إلى https://api.venice.ai/api/v1. يستخدم المحوّل المتوافق مع OpenAI في OpenCode هذا الـ base URL لإكمالات المحادثة.
  • احتفظ بـ npm مُعيَّنًا إلى @ai-sdk/openai-compatible لـ endpoint محادثة Venice المتوافق مع OpenAI.
  • معرّف الموفّر هو venice، لذا تستخدم إشارات النموذج تنسيق venice/<model-id>.
  • إذا فضّلت تدفق /connect في OpenCode، اختر Other، استخدم venice كمعرّف الموفّر، الصق مفتاح Venice API الخاص بك، وأزل options.apiKey من التكوين.
يدعم OpenCode بالفعل قيم baseURL المخصصة للموفّر والموفّرين المتوافقين مع OpenAI عبر @ai-sdk/openai-compatible. لا تتطلب نواة OpenCode تغييرات في الموفّر من أجل Venice.

الموارد

نماذج Venice النصية

معرّفات نماذج Venice المتاحة

وثائق موفّر OpenCode

مرجع الموفّر المخصص و base URL