الوثائق

ربط مفتاح LLM

نماذج مُدارة تُفوتَر بالأرصدة، أو BYOK — اربط OpenAI أو Anthropic أو Google Gemini أو نموذجًا خاصًا (Ollama، LM Studio، endpoint متوافق مع OpenAI).

يتيح لك betool أن تختار، نموذجًا تلو الآخر، بين طريقتين للوصول إلى LLM:

  • النماذج المُدارة — يضع مشغّل المنصّة حسابات LLM مشتركة في متناولك. تستخدمها دون ربط أي مفتاح؛ ويُخصَم الاستهلاك بـالأرصدة، وفق جدول أسعار لكل توكِن إدخال وإخراج. لا يوجد أي نموذج مجاني.
  • BYOK (Bring Your Own Key) — توفّر مفاتيح API الخاصة بك (أو عنوان URL لنموذجك الخاص). وتُفوتَر تكاليف الاستدلال مباشرةً من مزوّدك؛ ولا يقتطع betool شيئًا على التوكِنات.

في البيئات الخاضعة للتنظيم، يبقى BYOK الخيار الموصى به: يظلّ عقدك (DPA) مع المزوّد السلسلة التعاقدية الوحيدة، وتكون فوترتك مقروءة بندًا بندًا، وتُبطل المفتاح دون المرور بنا. راجع BYOK — لماذا هو غير قابل للتفاوض في القطاعات المنظَّمة.

المزوّدون المدعومون

المزوّدالنماذجالوضع
OpenAIالجيل الحالي من GPTPublic API
AnthropicClaude (Opus، Sonnet، Haiku)Public API
GoogleGeminiPublic API
Ollamaنماذج ذات أوزان مفتوحة (open-weight)، نماذج مخصّصةمُستضاف ذاتيًا، أو Ollama Cloud
LM Studioنماذج محليةمُستضاف ذاتيًا
Endpoint متوافق مع OpenAIvLLM وغيره من الخوادم التي تُتيح واجهة OpenAI البرمجيةمُستضاف ذاتيًا (URL مخصّص)

يواكب كتالوج النماذج المُدارة الجيلَ الحالي من Claude و GPT و Gemini، إضافةً إلى نماذج ذات أوزان مفتوحة تُقدَّم عبر Ollama Cloud (Kimi، GLM…). والقائمة الدقيقة المحدَّثة ظاهرة في مُحدِّد النموذج في لوحة الإدارة.

الخطوة 1 — الحصول على مفتاح API لديك

اتّبع إجراء مزوّدك:

الخطوة 2 — تسجيل المفتاح في betool

  1. في لوحة الإدارة، افتح الإعدادات ← المزودون.
  2. انقر على + إضافة حساب.
  3. اختر المزوّد، والصِق مفتاح API (وعنوان URL بالنسبة إلى نموذج مُستضاف ذاتيًا).
  4. امنحه اسمًا مقروءًا (مثال: «OpenAI - prod»).

لا يُعيد الـAPI المفتاح أبدًا بعد حفظه. وإذا احتجت إلى إعادة توليده، فسيتعيّن عليك تحديثه يدويًا. ولا تُعيد مسارات GET سوى has_api_key: true | false.

الخطوة 3 — اختيار نماذجك

تشير بعد ذلك كل عقدة agent في الـpipelines لديك إلى الحساب والنموذج المراد استخدامهما — ويمكن للحساب نفسه أن يخدم عدّة نماذج.

فمثلًا، يمكن لحساب OpenAI واحد أن يقدّم نموذجًا متقدّمًا للوكلاء الأساسيين ونموذجًا أخفّ للتصنيف السريع.

الحسابات المشتركة

الحسابات المشتركة لـ LLM (العلَم is_shared) هي التي تحمل النماذج المُدارة. وتكون مرئية للمؤسسات دون ربط أي مفتاح، ويُفضِّل الحلّ دائمًا حساباتك الخاصة (own > shared).

التسعير

راجع التسعير لمعرفة تفاصيل القياس. تذكير: في وضع BYOK، لا نتقاضى مقابل توكِنات LLM — بل مقابل التنسيق (orchestration) لدينا فقط. أمّا على نموذج مُدار، فتُخصَم التوكِنات بالأرصدة.

الخطوة التالية

نظرة عامة على قنوات الإدخال ←