BYOK · استخدم مفتاح LLM الخاص بك

BYOK (إحضار مفتاحك الخاص) هو المفهوم الأساسي لـ Braidrun لفواتير LLM Token: يمكنك الاحتفاظ بمفتاح API الذي تحصل عليه من OpenAI / Anthropic / DeepSeek / Kimi / OpenRouter، وما إلى ذلك، وسيساعدك Braidrun على تعديله دون زيادة السعر.

لماذا بيوك

• فواتير شفافة — يتم تسجيل استهلاك الرمز المميز مباشرة في حساب LLM الخاص بك، ولا يقوم Braidrun بتحويل الأسعار أو زيادتها.
• حرية النموذج — يمكنك استخدام Claude Opus وGPT-5 الخاص بحسابك الخاص وأي نموذج صغير لتوجيه OpenRouter - دون التقيد بالحزمة الموحدة للنظام الأساسي.
• الحصة والحد الحالي تحت سيطرتك — هل تحتاج إلى TPM أعلى؟ ما عليك سوى الانتقال إلى OpenAI والترقية إلى المستوى. لا حاجة للتعامل مع المنصة.
• آمنة ويمكن السيطرة عليها — يمكن إلغاء المفتاح في وحدة تحكم OpenAI في أي وقت، ويكون لك القول الفصل في الرابط بأكمله.

مقدمي الخدمات المدعومة

• OpenAI — GPT-4.1 / 4.1-mini / GPT-5 / o1 / o3
• Anthropic — Claude Opus 4 / Sonnet 4 / Haiku 4
• Claude Code — Anthropic API Key or Claude Subscription Token (credential provider=claude code oauth)
• Codex — OpenAI API Key or Codex Subscription auth.json (Credentials provider=codex subscription)
• DeepSeek — DeepSeek-V3.5 / DeepSeek-Reasoning
• Kimi — Kimi K2 / 128K context
• OpenRouter — التوجيه عبر OpenRouter إلى أي من الطرز المدعومة (Mistral / Llama / Gemini وما إلى ذلك)
• LLM داخلي (يمكن لإصدار Enterprise الوصول إلى نقطة نهاية vLLM / TGI / Ollama ذاتية الاستضافة)

الخطوة 1: اذهب إلى الموفر للحصول على المفتاح

الخطوة 2: الحفظ في مركز بيانات الاعتماد

1. "إدارة بيانات الاعتماد" على اليسار → "بيانات الاعتماد الجديدة".
2. اقتراحات التسمية:
   • openai_main / openai_prod / openai_test
   • anthropic_team_budget / anthropic_personal
   • deepseek_production
3. النوع: api_key؛ القيمة: الصق المفتاح الذي قدمه لك الموفر؛ مساحة الاسم: فردية أو جماعية (اعتمادًا على ما إذا كنت تستخدمها بمفردك أو تشاركها مع عدة أشخاص).
4. يحفظ. تشفير النظام الأساسي وتخزينه.

الخطوة 3: ربط الموفر بالوكيل

agents:
  writer:
    preset: writer
    overrides:
      model: claude-opus-4-7
      provider: anthropic_team_budget    # ← 凭据中心的凭据名

مساعد لشؤون التنفيذ: الحساب الجاري

The in-app AI Assistant no longer depends on centralized admin formation. Go to account Settings . AI Assistant to choose the model provider, or choose API key / participation-a mode in the Claude Code / Codex section. فالحفظ لا يؤثر إلا على الحساب الجاري.

الخطوة 4 (اختياري): تكوين تفاصيل الموفر

يتطلب بعض الموفرين مزيدًا من التكوين - api_base، ومعرف المؤسسة، والرؤوس المخصصة. قم بالتوسيع في "إدارة بيانات الاعتماد → تكوين الموفر":

# 凭据中心 → Provider 配置
# 类型: OpenAI
api_base: https://api.openai.com/v1   # 或你的代理 / Azure endpoint
organization: org_xxxxx                 # 分账 organization
default_headers:
  OpenAI-Beta: assistants=v2

مشاركة دفتر الأستاذ متعدد المفاتيح

السيناريو: تريد الاحتفاظ بالحسابات حسب القسم، أو لديك مجموعتين من المفاتيح للتطوير/الإنتاج.

1. في مركز الاعتماد، يكون لكل مفتاح اسم مستقل (openai_marketing / openai_engineering).
2. يرتبط وكلاء سير العمل المختلفين بموفرين مختلفين.
3. من ناحية OpenAI، يتم تقسيم المشاريع إلى مشاريع لتتبع استهلاك الرمز المميز، ويتم فصل فواتير كل مشروع بشكل طبيعي.

تتبع التكلفة

حتى لو كانت الفاتورة من جانب الموفر، فإن Braidrun لا يزال يتتبع الرمز المميز والتكلفة المقدرة المحولة من السعر الحالي للنموذج:

• يعرض الملخص العلوي لكل عملية تنفيذ الرموز المميزة + التكلفة المقدرة
• يتم تجميع صفحة "لوحة البيانات" حسب اليوم/الأسبوع/الشهر
• يمكنك ضبط "التنبيه عندما تتجاوز تكلفة التنفيذ الفردي X"

لاحظ أن تقديرات Braidrun تعتمد على قائمة أسعار مقدمي الخدمة العامة - إذا استفدت من الخصومات (عقد OpenAI Enterprise / DeepSeek ربع السنوي)، فستكون الفاتورة الحقيقية أقل من التقدير.

الحد الحالي وإعادة المحاولة

يحتوي مفتاحك على حد أعلى لـ TPM (الرموز المميزة في الدقيقة). تحتوي المنصة على ثلاث طبقات من الحماية:

1. الحد الحالي للموفر (صعب على جانب الموفر، إذا تجاوز 429)
2. Braidrun الحد الناعم الداخلي لـ TPM (لتجنب الانفجار لمرة واحدة)
3. إعادة المحاولة على مستوى الخطوة (إعادة محاولة التراجع التلقائي العابرة 429)

دوران المفتاح

1. قم بإنشاء مفتاح جديد من جانب الموفر (لا تقم بإلغاء المفتاح القديم).
2. مركز بيانات اعتماد Braidrun → ابحث عن بيانات الاعتماد المقابلة → الصق المفتاح الجديد في "قيمة التحديث".
3. انتظر ساعة واحدة (للسماح للتنفيذ الجاري بالمفتاح القديم بالانتهاء).
4. تأكد من أن كل شيء طبيعي، وانتقل إلى جانب الموفر لإلغاء المفتاح القديم.

تجاوز الفشل / التراجع

عندما يشعر الموفر أحيانًا بالقلق، يمكنك تكوين خيار احتياطي في الوكيل:

agents:
  writer:
    preset: writer
    overrides:
      model: claude-opus-4-7
      provider: anthropic_main
      fallback:
        model: gpt-4.1
        provider: openai_main

يتم تبديل الخيار الاحتياطي تلقائيًا عندما يقوم الموفر الرئيسي بإرجاع 5xx / حد السعر.

FAQ

هل يمكن لـ Braidrun رؤية القيمة الرئيسية الخاصة بي؟

The runtime platform service needs to use the clear text Key to call the Provider - this moment is technically visible. لكن:

• يتم استخدام تشفير AES-256-GCM عند إسقاط قاعدة البيانات، ولا يمكن رؤية النص العادي في تفريغ قاعدة البيانات؛
• لا يسري مفعول فك التشفير في وقت التشغيل إلا في سياق خطوة واحدة، ولا يدخل سجلات أو يكتب لقطات أو يتدفق إلى خطوات أخرى؛
• يدعم إصدار Enterprise تكامل HSM / KMS، ويتم فك تشفير المفاتيح في KMS المُدار.

هل يمكنني مزج رصيد النظام الأساسي + BYOK؟

نعم. إذا لم يكن الوكيل مجهزًا بموفر، فسوف يستخدم المفتاح الموحد للمنصة (مع الحصول على حصة المنصة)؛ إذا كان مزودًا بمزود، فسوف يستخدم مفتاحك. يمكن دمج خطوات مختلفة في نفس سير العمل.

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

• بيانات الاعتماد — مركز الاعتماد لمزيد من التفاصيل
• دليل المفاوضة — حقول التجاوز التي يتم استخدامها مع الموفر