الانتقال إلى المحتوى الرئيسي
تتم مصادقة طلبات Venice API باستخدام مفاتيح Bearer API. يوضّح هذا الدليل كيفية إنشاء مفتاح من لوحة تحكم Venice، وتخزينه بشكل آمن، والتحقق من أنه يعمل.
إذا كنت تبني وكيلاً مستقلاً (autonomous agent) يحتاج إلى إصدار مفتاحه الخاص باستخدام محفظة، فاستخدم دليل إنشاء مفتاح API للوكيل المستقل بدلاً من ذلك.

​
قبل أن تبدأ

  • سجّل الدخول إلى حساب Venice الخاص بك.
  • تأكّد من أن الحساب يمتلك رصيداً قابلاً للإنفاق قبل استدعاء نقاط النهاية المدفوعة. يمكنك إنشاء مفتاح قبل تمويل الحساب، لكن طلبات النماذج لن تنجح حتى يصبح بإمكان الحساب استهلاك DIEM أو الأرصدة المجمّعة أو USD.
1

افتح إعدادات API

قم بزيارة https://venice.ai/settings/api. يمكنك أيضاً فتح هذه الصفحة من تطبيق Venice عبر اختيار API في إعداداتك.تعرض لوحة إعدادات API أرصدتك، ومستوى API الخاص بك، والاستخدام، ومفاتيح API الحالية.
2

ابدأ إنشاء مفتاح جديد

اختر Generate New API Key، ثم قم بتهيئة المفتاح:
  • Description: استخدم اسماً قصيراً يحدّد التطبيق أو البيئة أو التكامل الذي سيستخدم هذا المفتاح.
  • API Key Type: استخدم Inference Only لطلبات النماذج العادية. استخدم Admin فقط عندما يكون المفتاح بحاجة إلى إدارة مفاتيح API برمجياً.
  • Expires at: يمكنك اختيارياً تحديد تاريخ انتهاء صلاحية. إذا تركت هذا الحقل فارغاً، فلن تنتهي صلاحية المفتاح تلقائياً.
  • Epoch Consumption Limits: يمكنك اختيارياً تحديد سقف لمقدار DIEM أو USD الذي يستطيع هذا المفتاح إنفاقه خلال حقبة (epoch) مدتها 24 ساعة. إذا تركت هذا الحقل فارغاً، فسيتمكن المفتاح من استخدام الرصيد المتاح للحساب وفقاً لحدود حسابك.
3

أنشئ المفتاح وانسخه

انقر على Generate. ستعرض Venice مفتاح API الكامل مرة واحدة فقط.
انسخ المفتاح فوراً وخزّنه في مكان آمن. بعد إغلاق مربع الحوار، لن تعرض Venice سوى البيانات الوصفية التعريفية مثل وصف المفتاح والأحرف الأخيرة منه. إذا فقدت القيمة السرية، فاحذف المفتاح وأنشئ مفتاحاً جديداً.
أضف المفتاح إلى بيئتك المحلية أو إلى مدير الأسرار الخاص بك:
export VENICE_API_KEY="your-api-key-here"
4

تحقّق من المفتاح

أرسل طلباً منخفض المخاطر للتأكد من أن المصادقة تعمل:
curl --request GET \
  --url https://api.venice.ai/api/v1/models \
  --header "Authorization: Bearer $VENICE_API_KEY"
تُرجع الاستجابة الناجحة قائمة بالنماذج المتاحة. إذا تلقّيت خطأ مصادقة، فتأكّد من أن المفتاح قد تم نسخه بالكامل وأن ترويسة Authorization مُنسّقة على شكل Bearer <api-key>.

​
أفضل الممارسات

  • أنشئ مفاتيح منفصلة لبيئات التطوير والاختبار (staging) والإنتاج.
  • فضّل مفاتيح Inference Only للتطبيقات التي تستدعي نقاط نهاية النماذج فقط.
  • اجعل مفاتيح Admin نادرة، ومحدودة النطاق بدقة، ومخزّنة فقط في بيئات موثوقة على جانب الخادم.
  • لا ترفع مفاتيح API أبداً إلى نظام التحكم في الإصدارات ولا تكشفها في الكود الذي يعمل على جانب العميل.
  • حدّد تواريخ انتهاء صلاحية وحدود استهلاك للمفاتيح المستخدمة في البيئات المؤقتة أو المشتركة أو الأعلى مخاطرة.
  • احذف المفاتيح غير المستخدمة، وقم بتدوير أي مفتاح قد يكون تعرّض للكشف.

​
الإدارة البرمجية للمفاتيح

يمكن لمفاتيح Admin إدارة مفاتيح API من خلال نقاط نهاية مرجع API:

إنشاء مفتاح API

أنشئ مفتاح API جديداً بأسلوب لوحة التحكم انطلاقاً من مفتاح admin موجود.

عرض قائمة مفاتيح API

اعرض المفاتيح النشطة وبياناتها الوصفية.

تحديث مفتاح API

قم بتحديث وصف المفتاح أو تاريخ انتهاء صلاحيته أو حدود الاستهلاك الخاصة به.

حذف مفتاح API

قم بإلغاء مفتاح لم يعد هناك حاجة إليه.