# استخدم مفتاحك الخاص (BYOK) (/ar/docs/verdent-manager/configuration/byok)

> استخدم مفاتيح API الخاصة بمزودك في Verdent Desktop وتعرّف على أين تتوفر نماذج BYOK



## نظرة عامة [#نظرة-عامة]

يتيح لك BYOK (استخدم مفتاحك الخاص) ربط مفاتيح API الخاصة بمزودك واستخدام تلك النماذج مباشرة داخل الوكلاء المدمجين في Verdent.

### BYOK مقابل BYOA [#byok-مقابل-byoa]

يقدّم Verdent مسارين لـ "استخدم ما لديك"—لا تخلط بينهما:

|                              | BYOK                                                                       | BYOA                                                                                           |
| ---------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **ما الذي تجلبه**            | مفتاح API من مزود                                                          | بيئة تشغيل وكيل (Codex / Claude Code)                                                          |
| **ما الذي ينفّذ مهمتك**      | الوكيل المدمج في Verdent، باستخدام المزود الذي يقف خلف مفتاحك              | وكيل CLI الخارجي على جهازك                                                                     |
| **حالة الاستخدام النموذجية** | الوصول إلى نموذج ضمن فوترتك الخاصة، أو استخدام مزود غير مضمّن بشكل افتراضي | الاحتفاظ بسير عمل Codex / Claude Code الحالي لديك مع السماح لـ Manager بتوجيه مهام Worker إليه |
| **يُضبط في**                 | الإعدادات ← النماذج ← تكوين النماذج                                        | الإعدادات ← النماذج ← وكلاء CLI                                                                |

راجع [BYOA](/docs/verdent-manager/configuration/byoa) لتشغيل مهام Worker على بيئة تشغيل وكيل خارجية.

## المزودون المدعومون [#المزودون-المدعومون]

* Anthropic
* OpenAI
* OpenRouter

## إضافة مفتاح API [#إضافة-مفتاح-api]

<Steps>
  <Step title="افتح تكوين النماذج">
    انتقل إلى **الإعدادات ← النماذج ← تكوين النماذج**.
  </Step>

  <Step title="ابدأ بإضافة مفتاح">
    حدد &#x2A;*إضافة مفتاح API +** في الزاوية العلوية اليمنى.
  </Step>

  <Step title="اختر المزود والنماذج">
    حدد مزودًا واختر النماذج التي تريد تفعيلها.
  </Step>

  <Step title="أدخل بيانات الاعتماد">
    أضف مفتاح API الخاص بك.
  </Step>

  <Step title="الحفظ والتحقق">
    حدد **حفظ**. يتحقق Verdent من صحة المفتاح تلقائيًا.
  </Step>
</Steps>

### نتائج التحقق [#نتائج-التحقق]

* إذا نجح التحقق، يُحفظ المفتاح وتصبح النماذج المحددة متاحة.
* إذا فشل التحقق، يعرض Verdent رسالة خطأ لتتمكن من تحديث المفتاح والمحاولة مرة أخرى.

## إدارة مفاتيح API الحالية [#إدارة-مفاتيح-api-الحالية]

ضمن **الإعدادات ← النماذج ← تكوين النماذج**، يمكنك:

* تفعيل أو تعطيل جميع نماذج مزود معين
* تفعيل أو تعطيل نماذج فردية
* تعديل مفتاح API موجود
* حذف مفتاح API

## أين تظهر نماذج BYOK [#أين-تظهر-نماذج-byok]

بعد إضافة مفتاح صالح، تظهر نماذج BYOK في:

* محدد نموذج المحادثة
* تكوين النموذج المُعدّ مسبقًا
* إعدادات الوكيل الفرعي
* إعدادات المراجع

تتصرف نماذج BYOK كالنماذج المدمجة بعد تفعيلها.

## القيود [#القيود]

* الميزات المدمجة مثل Smart Suggestions لا تدعم مفاتيح BYOK API.
* الضغط التلقائي لا يدعم مفاتيح BYOK API.