مفاتيح مزوّدي الذكاء الاصطناعي
اضبط بيانات اعتماد مفاتيحك الخاصة لمزوّدي النصوص والصوت.
اضبط بيانات اعتماد مفاتيحك الخاصة لمزوّدي النصوص والصوت.
تتيح ميزة استخدام مفتاحك الخاص (BYOK) أن تستخدم طلبات الذكاء الاصطناعي المدعومة حسابك لدى مزوّد الذكاء الاصطناعي. لا تحتاج إلى مفتاح: فالمنصة توفّر النماذج افتراضيًا. يتطلب حفظ مفتاح باقة Scale. أما المفاتيح المحفوظة مسبقًا فتواصل العمل في باقتي Launch وOperate. وتظل تدفع اشتراك باقة Make Agent Fast بالإضافة إلى رسم ثابت للمنصة عن كل إجراء، بينما يحاسبك المزوّد مباشرة على استخدام نماذجه.
المزوّدون المدعومون#
يمكن إضافة مفاتيح جديدة لمزوّدين اثنين فقط: أحدهما للنصوص والآخر للصوت:
| المزوّد | الاستخدام | إنشاء مفتاح أو مراجعته |
|---|---|---|
| OpenRouter | توليد نصوص الوكيل عبر النماذج التي يوجّه OpenRouter الطلبات إليها | مفاتيح OpenRouter API |
| Speko | تحويل الكلام إلى نص وتحويل النص إلى كلام | منصة Speko |
المفاتيح القديمة#
تظهر مفاتيح المزوّدين المباشرين المحفوظة قبل الانتقال إلى OpenRouter وSpeko ضمن المفاتيح القديمة. تظل تعمل حتى تلغيها، ويمكنك إلغاؤها، لكن لا يمكنك إضافة مفتاح قديم أو استبداله:
| المزوّد القديم | الاستخدام | مرجع المزوّد |
|---|---|---|
| Anthropic وOpenAI وGoogle Gemini وxAI وDeepSeek | توليد نصوص الوكيل | وثائق Anthropic API، البدء السريع مع OpenAI API، مفاتيح Gemini API |
| Deepgram | تحويل الكلام إلى نص عندما يكون Deepgram هو مزوّد STT المضبوط | مفاتيح Deepgram API |
| ElevenLabs | تحويل النص إلى كلام عندما يكون ElevenLabs هو المضبوط | مصادقة ElevenLabs |
يعتمد توفّر المزوّدين أيضًا على مزوّدي النصوص والكلام والوقت الفعلي المضبوطين في المنصة. ولا يعني حفظ مفتاح صالح أن كل ميزة ستستخدم ذلك المزوّد حتمًا.
إضافة مفتاح مزوّد#
- أنشئ مفتاحًا في وحدة تحكم OpenRouter أو Speko، وفعّل الفوترة لدى المزوّد أو حدًّا للإنفاق إذا لزم الأمر.
- افتح لوحة التحكم ← الإعدادات ← مفاتيح مزوّدي الذكاء الاصطناعي. وحده مالك الفوترة في مساحة عمل Scale يستطيع حفظ مفتاح.
- الصق المفتاح في بطاقة OpenRouter أو Speko.
- اختر اختبار وحفظ.
- انتظر نتيجة التحقق، ثم اختبر الميزة التي تستخدم المزوّد.
يُجري Make Agent Fast طلب تحقق مباشرًا قبل حفظ المفتاح، ولا يستهلك ذلك أي رموز نماذج أو أرصدة من المنصة. يجب ألا يحتوي المفتاح على مسافات أو فواصل أسطر، وأن يتراوح طوله بين 16 و512 حرفًا. يجب أن تبدأ مفاتيح OpenRouter بـ sk-or-، وأن تبدأ مفاتيح Speko بـ sk_speko_ أو sk_live_. ويبقى التحقق المباشر هو المرجع النهائي.
يؤدي حفظ مفتاح آخر صالح للمزوّد نفسه إلى استبدال القيمة المخزّنة سابقًا. أما المفتاح الذي يفشل في التحقق فلا يُحفظ، ولذلك يستمر المفتاح المحفوظ مسبقًا في العمل. ولا تحتفظ لوحة التحكم إلا ببيانات تعريف آمنة، مثل آخر أربعة أحرف ووقت التحقق والحالة.
كيف يتم اختيار مزوّد النصوص#
لتوليد النصوص، تكون الأولوية لمفتاح OpenRouter النشط. وإن لم يوجد، يبحث Make Agent Fast عن مفتاح قديم نشط يطابق مزوّد النصوص المضبوط في المنصة، ثم عن بقية مفاتيح النصوص القديمة (Anthropic وOpenAI وGemini وxAI وDeepSeek) بهذا الترتيب. وإذا لم يوجد مفتاح BYOK مناسب، يستخدم مزوّد المنصة متى سمحت الباقة والنشر بذلك.
مفاتيح الكلام خاصة بكل مزوّد. يُستخدم مفتاح Speko عندما يجري الكلام عبر Speko. ويُستخدم مفتاح Deepgram القديم فقط عندما يكون مزوّد تحويل الكلام إلى نص النشط هو Deepgram، ويُستخدم مفتاح ElevenLabs القديم فقط عندما يكون تحويل النص إلى كلام مضبوطًا على ElevenLabs.
لا تحلّ مفاتيح BYOK حاليًا محل بيانات اعتماد تضمين المعرفة الخاصة بالمنصة. يستمر استيعاب المعرفة واسترجاعها في استخدام مزوّد التضمين المضبوط في النشر.
الفوترة والأرصدة#
- يحاسب المزوّد الخارجي استخدام رموز الذكاء الاصطناعي على الحساب الذي أصدر المفتاح.
- يواصل Make Agent Fast احتساب الاشتراك بالإضافة إلى رسم ثابت للمنصة عن كل إجراء يعمل بمفتاحك: رصيد واحد لكل رد في المحادثة بدلًا من الرسوم المبنية على الرموز. يغطي هذا الرسم الاسترجاع والتنسيق والاستضافة المحيطة بالاستدعاء، وهو ليس نسبة من فاتورة الرموز لديك.
- يُطبَّق الرسم على كل استدعاء للمزوّد. أما خطوات الكلام التي تموّلها المنصة (مثل التفريغ النصي عندما يكون لديك مفتاح نصوص فقط) فتُحتسب بالسعر المعتاد، وتستخدم المكالمات المباشرة دائمًا سعر المنصة.
- قد يفشل الطلب عند استنفاد حصة المزوّد حتى مع بقاء أرصدة في Make Agent Fast.
راجع كلًا من الاستخدام والأرصدة في Make Agent Fast ولوحة الاستخدام الخاصة بالمزوّد.
حالات المفتاح ومعالجة الأعطال#
| الحالة | المعنى | ما العمل |
|---|---|---|
active | نجح التحقق المباشر | اختبر الميزة المعنية وراقب استخدام المزوّد |
invalid | رفض المزوّد المفتاح المخزّن لاحقًا | تحقق من الفوترة لدى المزوّد والقيود والحصة وحالة الإلغاء، ثم احفظ مفتاحًا بديلًا (OpenRouter أو Speko) |
revoked | المفتاح معطّل في Make Agent Fast | احفظ مفتاح OpenRouter أو Speko جديدًا إذا أردت أن تواصل الميزة استخدام BYOK |
إذا فشل طلب لأن المزوّد رفض بيانات الاعتماد أو بسبب الحصة، فقد يضع Make Agent Fast علامة «غير صالح» على المفتاح المخزّن. ولا يؤدي إصلاح المفتاح لدى المزوّد إلى كشف السر المخزّن أو إعادة كتابته؛ ففي حالة مفتاح OpenRouter أو Speko، استخدم اختبار الاتصال لإعادة التحقق منه، أو احفظ المفتاح العامل مرة أخرى. أما المفتاح القديم الذي يصبح غير صالح فلا يمكن استبداله بمفتاح قديم آخر؛ انقل ذلك المزوّد إلى OpenRouter أو Speko بدلًا من ذلك.
تدوير مفتاح المزوّد#
- أنشئ مفتاحًا جديدًا لدى المزوّد دون حذف المفتاح القديم.
- احفظ المفتاح الجديد في Make Agent Fast وتأكد من أنه أصبح نشطًا.
- اختبر محادثة نصية أو رسائل صوتية، بحسب ما يستخدم ذلك المزوّد.
- ألغِ المفتاح القديم في وحدة تحكم المزوّد.
- افحص سجلات المزوّد بحثًا عن أي استخدام غير متوقع للمفتاح القديم.
إذا انكشف مفتاح في نظام إدارة الإصدارات أو في شيفرة المتصفح، فألغِه لدى المزوّد فورًا. فحذفه من Make Agent Fast وحده لا يمنع أي طرف آخر يملكه من استخدامه مباشرة لدى المزوّد.