الحصول على مفتاح واجهة برمجة التطبيقات

لاستخدام Gemini API، يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات. يمكنك إنشاء مفتاح بنقرة واحدة في Google AI Studio.

الحصول على مفتاح واجهة برمجة التطبيقات

التحقّق من مفتاح واجهة برمجة التطبيقات باستخدام أمر curl

يمكنك استخدام أمر curl للتحقّق من الإعداد. يمكنك تمرير مفتاح واجهة برمجة التطبيقات إما في عنوان URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

أو في عنوان x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

الحفاظ على أمان مفتاح واجهة برمجة التطبيقات

من المهم الحفاظ على أمان مفتاح واجهة برمجة تطبيقات Gemini. إليك بعض الأمور التي يجب التي يجب أخذها في الاعتبار عند استخدام مفتاح واجهة برمجة التطبيقات Gemini:

  • تستخدم Google AI Gemini API مفاتيح واجهة برمجة التطبيقات للحصول على الأذونات. إذا كان بإمكان المستخدمين الآخرين الوصول إلى الملف إلى مفتاح Gemini API، يمكنهم إجراء المكالمات باستخدام حصة مشروعك مما قد يؤدي إلى فقدان حصة أو رسوم فوترة إضافية (إذا كانت الفوترة مفعَّلة). تحمي مفاتيح واجهة برمجة التطبيقات أيضًا إمكانية الوصول إلى النماذج والملفات التي تم ضبطها.

  • عند النقر على الحصول على مفتاح واجهة برمجة التطبيقات في Google AI Studio، يمكنك اختيار ما إذا كنت تريد توفير مفتاح لواجهة برمجة تطبيقات Gemini في مشروع جديد أو حالي على Google Cloud تشير رسالة الأشكال البيانية قائمة مفاتيح واجهة برمجة التطبيقات في Google AI Studio جميع مفاتيح واجهة برمجة التطبيقات التي وفّرها AI Studio لاستخدامها مع Google AI Gemini API (بالإضافة إلى جميع مشاريع Google Cloud المرتبطة بها)

    • ومع ذلك، من المحتمل أن يتم حذف أي مفاتيح لواجهة برمجة التطبيقات ضمن مشروع Google Cloud. المستخدَم لاستدعاء واجهة برمجة تطبيقات Gemini المستنِد إلى الذكاء الاصطناعي من Google يمكنك عرض جميع الخاصة بالمشروع في واجهات برمجة التطبيقات الخدمات > لوحة بيانات الاعتماد في وحدة تحكُّم Google Cloud.

  • جارٍ الإضافة القيود المفروضة على مفتاح واجهة برمجة التطبيقات في تحديد مساحة السطح القابلة للاستخدام من خلال كل مفتاح من مفاتيح واجهة برمجة التطبيقات. بشكل افتراضي، لا يمكن استخدام مفتاح واجهة برمجة التطبيقات Gemini الذي أنشأه Google AI Studio إلا مع تكنولوجيات الذكاء الاصطناعي من Google. Gemini API (المعروفة رسميًا باسم "Generative Language API" أو generativelanguage.googleapis.com).

    • في حال كان هناك أي مفاتيح لواجهة برمجة تطبيقات في مشروعك على Google Cloud تفتقر إلى واجهة برمجة التطبيقات القيود أو أي مفاتيح واجهة برمجة تطبيقات أدرجت اللغة التوليدية في القائمة المسموح بها يمكن استخدام هذه المفاتيح مع Google AI Gemini API. الأفضل ممارسة قصر كل مفتاح واجهة برمجة تطبيقات على واجهات برمجة التطبيقات التي تستدعيها باستخدام تلك المفتاح.
    • تجدر الإشارة إلى أنّه حتى مع فرض قيود على مفتاح واجهة برمجة التطبيقات، إذا حصلت جهة ضارة على مفتاح واجهة برمجة التطبيقات، يمكنهم استخدامه لإجراء مكالمات باستخدام حصة مشروعك للجميع واجهات برمجة التطبيقات المُدرَجة في القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات هذا

  • تقع على عاتقك مسؤولية الحفاظ على أمان مفتاح واجهة برمجة التطبيقات في Gemini.

    • لا تتحقّق من مفاتيح واجهة برمجة التطبيقات Gemini في التحكّم في المصدر.
    • مخاطر التطبيقات من جهة العميل (Android وSwift والويب وDart/Flutter) الكشف عن مفاتيح واجهة برمجة التطبيقات، لذلك لا ننصح باستخدام حِزم تطوير البرامج (SDK) الخاصة بعميل "تكنولوجيات الذكاء الاصطناعي من Google" في تطبيقات الإنتاج لطلب البيانات من Google AI Gemini API مباشرةً من وتطبيقات الويب وتطبيقات الهاتف المحمول. اطّلِع على مقالة Quickstarts (البدء السريع) لحزمة تطوير البرامج (SDK) لمعرفة المزيد أفضل الممارسات الخاصة بكل لغة لتأمين مفتاح واجهة برمجة التطبيقات.

للاطّلاع على بعض أفضل الممارسات العامة، يمكنك أيضًا مراجعة

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