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

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

الحصول على مفتاح Gemini API في Google AI Studio

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

لإجراء الاختبار الأولي، يمكنك تضمين مفتاح واجهة برمجة التطبيقات في الرمز البرمجي، ولكن يجب أن يكون ذلك مؤقتًا فقط لأنّه غير آمن. يتناول الجزء المتبقّي من هذا القسم كيفية إعداد مفتاح واجهة برمجة التطبيقات محليًا كمتغيّر بيئة مع أنظمة التشغيل المختلفة.

Linux/macOS - Bash

‫Bash هي لغة إعدادات شائعة لوحدة الطرفية في نظامَي التشغيل Linux وmacOS. يمكنك التحقّق مما إذا كان لديك ملفّ إعدادات له من خلال تنفيذ الأمر التالي:

~/.bashrc

إذا كان الردّ "ما مِن ملف أو دليل بهذا الاسم"، عليك إنشاء هذا الملف وفتحه من خلال تنفيذ الأوامر التالية، أو استخدام zsh:

touch ~/.bashrc
open ~/.bashrc

بعد ذلك، عليك ضبط مفتاح واجهة برمجة التطبيقات من خلال إضافة أمر التصدير التالي:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

بعد حفظ الملف، طبِّق التغييرات من خلال تنفيذ:

source ~/.bashrc

‫macOS - Zsh

‫Zsh هو إعداد شائع لوحدة الطرفية في نظامَي التشغيل Linux وmacOS. يمكنك التحقّق مما إذا كان لديك ملفّ إعدادات له من خلال تنفيذ الأمر التالي:

~/.zshrc

إذا كان الردّ "ما مِن ملف أو دليل بهذا الاسم"، عليك إنشاء هذا الملف وفتحه من خلال تنفيذ الأوامر التالية، أو استخدام bash:

touch ~/.zshrc
open ~/.zshrc

بعد ذلك، عليك ضبط مفتاح واجهة برمجة التطبيقات من خلال إضافة أمر التصدير التالي:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

بعد حفظ الملف، طبِّق التغييرات من خلال تنفيذ:

source ~/.zshrc

Windows

  1. ابحث عن "متغيّرات البيئة" في إعدادات النظام.
  2. عدِّل "متغيّرات المستخدم" (للمستخدم الحالي) أو "متغيّرات النظام" (لجميع المستخدمين - يُرجى استخدامها بحذر).
  3. أنشئ المتغيّر وأضِف export GEMINI_API_KEY=your_key_here.
  4. تطبيق التغييرات

إرسال أول طلب من Gemini API

يمكنك استخدام الأمر curl للتحقّق من الإعداد:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

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

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

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

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

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

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

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