حدود مفتاح API: IP والأدوات
يمكن أن يكون لكل مفتاح API NeuralSpace قيدين: العناوين التي يعمل منها والأدوات التي يتيح الوصول إليها. الإعداد موجود على الصفحة مفاتيح واجهة برمجة التطبيقات، يتم تطبيقه مباشرة بعد الحفظ ويتم فحصه على الخادم قبل الوصول إلى النموذج: تم رفض الطلب المحظور بسبب الخطأ 403، ولا يتم خصم الرموز المميزة له.
لماذا تقييد المفتاح
مفتاح API هو الوصول إلى النماذج المدفوعة ضمن رصيدك. إذا وقع المفتاح في الأيدي الخطأ، فسيتم إنفاق طلبات الآخرين من حسابك، ولن تتمكن من ملاحظة ذلك إلا من خلال النظر في سجل الخصم. هناك قيدان بسيطان يغطيان السيناريو الأكثر شيوعًا:
- المفتاح موجود في رمز الروبوت أو التطبيق الذي يتم تشغيله من خادم واحد - اربط المفتاح بعنوان هذا الخادم، ولن تعمل نسخة مسروقة من المفتاح من جهاز شخص آخر؛
- يتم إصدار المفتاح لمهمة محددة - اترك فقط الأدوات الضرورية، على سبيل المثال الدردشة والصور، وقم بإيقاف تشغيل الفيديو والصوت وكل شيء آخر حتى لا يتم استخدامها "في نفس الوقت".
أين تضع القيود
- افتح الصفحة مفاتيح واجهة برمجة التطبيقات.
- تحت المفتاح المطلوب، انقر فوق "القيود".
- املأ قائمة عناوين IP المسموح بها وقم بإلغاء تحديد المربعات التي لا ينبغي للمفتاح استخدامها.
- انقر فوق "حفظ" - تدخل القيود حيز التنفيذ على الفور.
ترتبط الإعدادات بمفتاح محدد: كل مفتاح له قائمة عناوين خاصة به ومجموعة أدوات خاصة به. تعمل القيود في كل من سمات الصفحة الفاتحة والداكنة.
عناوين IP المسموح بها
في حقل العناوين، يمكنك تحديد عنوان IP واحد أو أكثر - عنوان واحد في كل سطر، حتى 50 عنوانًا إجمالاً. يعني الحقل الفارغ أنه تم قبول المفتاح من أي عنوان، كما كان من قبل: يتم تمكين التقييد فقط عندما تكون القائمة ممتلئة.
يتم التحقق من العنوان الحقيقي للعميل، حتى لو جاء الطلب إلينا من خلال طبقة وكيل أو خادم - أي أن الارتباط بالخادم يعمل أيضًا في المخططات حيث يوجد التطبيق خلف الموازن. إذا تغير العنوان من الخادم، فما عليك سوى إضافة عنوان جديد إلى القائمة وحفظه.
الأدوات المتاحة
يوجد أسفل قائمة العناوين شجرة من الأدوات. المستوى الأعلى هو خمس فئات: LLM (نماذج الدردشة)، الصور، الفيديو، الصوت وغيرها. يؤدي إلغاء تحديد الفئة إلى تعطيلها تمامًا؛ عند تمكين الفئة، تعمل مربعات الاختيار الموجودة بالداخل بطريقة مستهدفة - يمكنك ترك نموذجين محددين وتعطيل الباقي.
بشكل افتراضي، يتم تمكين كل شيء. نقوم بتخزين تلك التي تم إيقاف تشغيلها فقط، لذا فإن الأدوات والنماذج الجديدة التي سنحصل عليها لاحقًا متاحة على الفور عند المفتاح - ليست هناك حاجة لتشغيلها بشكل منفصل.
ماذا يحدث للطلب المرفوض؟
يتلقى طلب من عنوان لم يتم حله أو إلى أداة معطلة استجابة 403 مع وصف واضح للسبب، ويحدث هذا قبل الاتصال بالنموذج - لا يتم خصم الأموال مقابل هذه المكالمة.
طلبات الخدمة - التحقق من الرصيد وقائمة النماذج ومساعدة واجهة برمجة التطبيقات - لا تخضع للقيود: فهي تظل متاحة مع أي مفتاح حتى يتمكن التطبيق دائمًا من معرفة رصيده وكتالوجه.
حيث تنطبق القيود
يتم احترام القيود الأساسية في جميع مسارات التنفيذ: في واجهة برمجة التطبيقات العامة وفي خادم MCP وفي الاتصالات الصوتية. من المستحيل حظر وضع تشغيل واحد بشكل منفصل والسماح بوضع آخر - يتم إجراء الفحص على الأداة الفعلية التي تنفذ الطلب.
من سيستفيد من هذا؟
أي شخص يأخذ المفتاح خارج جهاز الكمبيوتر الخاص به: مطورو الروبوتات وتطبيقات الهاتف المحمول، والفرق التي لديها مفتاح مشترك للعديد من الخدمات، وأولئك الذين يمنحون حق الوصول للمقاولين طوال مدة المشروع. لا تتعلق القيود بعدم الثقة، بل تتعلق بحقيقة أن تسريب المفتاح لم يعد مكلفًا.
الأسئلة المتداولة
هل من الممكن تحديد نطاق العنوان أو القناع؟
لا، العناوين الفردية مدرجة - ما يصل إلى 50 قطعة. إذا كان هناك المزيد من العناوين أو تغيرت، تحقق من المهمة: عادة ما يكون ذلك كافيا لربط المفتاح بخادم دائم واحد.
ماذا يحدث إذا تركت القائمة فارغة؟
يعمل المفتاح من أي عنوان، كما كان الحال قبل وضع القيود. يتم تمكين القاعدة فقط عند اكتمال القائمة.
هل التوازن وقائمة النماذج والوثائق محدودة؟
لا، هذه طلبات خدمة، وهي متوفرة بأي مفتاح - وإلا فلن يتمكن التطبيق من التحقق من الرصيد وإظهار الموديلات المتاحة.
هل أحتاج إلى تمكين النماذج الجديدة يدويًا؟
لا، سيتم إيقاف تشغيل ما قمت بإلغاء تحديده فقط؛ كل شيء آخر، بما في ذلك الأدوات الجديدة، يعمل فورًا باستخدام المفتاح.
هل يمكن تغيير القيود لاحقًا؟
نعم، في أي وقت. افتح "القيود" بجوار المفتاح، وقم بتحرير القائمة أو مربعات الاختيار وحفظها - سيتم تطبيق التغييرات على الطلبات التالية.