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

لاستخدام 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، بإمكانهم إجراء مكالمات باستخدام حصة مشروعك، مما قد يؤدي إلى فقدان الحصة أو تحصيل رسوم فوترة إضافية (في حال كانت الفوترة مفعّلة). وتعمل مفاتيح واجهة برمجة التطبيقات أيضًا على حماية إمكانية الوصول إلى النماذج والملفات التي تم ضبطها.

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

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

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

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

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

للحصول على بعض أفضل الممارسات العامة، يمكنك أيضًا مراجعة مقالة الدعم هذه.

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