استخدام مفاتيح واجهة برمجة التطبيقات في Gemini

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

إنشاء مفتاح Gemini API أو الاطّلاع عليه

أنواع مفاتيح واجهة برمجة التطبيقات: المفاتيح العادية مقابل مفاتيح التفويض

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

  • مفاتيح واجهة برمجة التطبيقات العادية: تربط الطلبات بمشروع على Google Cloud لأغراض الفوترة والحصص. لا تحدّد المفاتيح العادية المتصل، ما يحدّ من مستوى التفاصيل في الأذونات وعناصر التحكّم في الوصول التي يمكنها دعمها.
  • مفاتيح التفويض: مرتبطة مباشرةً بحساب خدمة على Google Cloud. عند استخدام مفتاح تفويض، تتم معالجة طلباتكم ضمن هوية حساب الخدمة المرتبط هذا، ما يتيح التحكّم الدقيق في الوصول. تقتصر مفاتيح التفويض على Generative Language API (Gemini API) تلقائيًا، وتوفّر فرضًا سريعًا للمفاتيح المسربة، ما يؤدي إلى إيقاف استخدام المفاتيح المسربة التي رصدتها أنظمتنا بسرعة.

لضمان الاستخدام الآمن، ستنتقل Gemini API من استخدام المفاتيح العادية إلى مفاتيح التفويض:

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

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

يمكنكم إدارة مشاريعكم ومفاتيحكم مباشرةً في Google AI Studio.

مشاريع Google Cloud