قبل إطلاق تطبيق Google AI Studio: مفاتيح API والتكاليف والفصل بين الواجهة والخادم

قد يحتفظ تطبيق Google AI Studio بمفتاح API بعيداً عن المستخدم، لكنه يتيح استدعاء نموذج مدفوع دون قيود مناسبة. لذلك ينبغي أن يفحص قرار الإطلاق أمرين: موضع بيانات الدخول، ومن يستطيع استخدام الخدمة التي تسمح بها.

يغطي هذا الدليل مراجعة تطبيق Google AI Studio من حيث بيئة التشغيل والصلاحيات والاستخدام والتعامل مع الفشل. راجعنا التوثيق الرسمي المشار إليه في ٢ نوفمبر ٢٠٢٦. لم نفحص مشروعاً بحساب مسجل ولم نستدعِ Gemini فعلياً؛ يعتمد مثال التكلفة على استخدام مفترض، ولم نقس زمن استجابة API.

١. حدد نوع التطبيق وبيئة تشغيله

سجل الإصدار واستهداف الويب أو الهاتف ومعرّف النموذج ومنتج API ووجهة الاستضافة ومزود الهوية. يوثق دليل التطبيقات المتكاملة بيئة خادم Node.js وإدارة الأسرار على الخادم لتطبيقات الويب. تحقق من المسار المستخدم فعلياً بعد التوليد أو التعديل أو التصدير.

لتطبيقات Android الأصلية مسار مختلف. يصف دليل وضع البناء استخدام Kotlin وJetpack Compose وFirebase AI Logic مع App Check بدلاً من تضمين مفتاح Gemini خام. لا تعمم مخطط الويب على الهاتف. التحقق من أصالة التطبيق يختلف عن صلاحية المستخدم لتنفيذ إجراء؛ افحص كليهما عندما يتطلب المنتج ذلك.

٢. افصل حماية المفتاح عن ضبط الاستدعاء

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

في الويب، افحص ملفات الواجهة والطلبات والسجلات وإعدادات النشر بحثاً عن كشف غير مقصود لبيانات الدخول. توثق Google إعداد مفتاح Gemini تلقائياً على الخادم للتطبيقات الجديدة؛ لا تفترض أن نسخة قديمة أو تعديلاً لاحقاً يحافظ عليه. تصغير الكود أو إخفاء قيمة داخله لا يحمي المفتاح.

راجع نقطة التوليد نفسها: هل يستدعيها زائر مجهول؟ هل يختار المستخدم نموذجاً غير مسموح أو سياقاً ضخماً أو مخرجات بلا حدود؟ حدد العمليات المسموحة، وتحقق من ملكية المحادثات المحفوظة، وافرض الحدود في الخادم أو الخدمة الموثوقة المناسبة. سرية المفتاح وحدها لا توفر هذه الضوابط.

٣. أضف حدود التطبيق إلى حصص المزود

يشرح دليل حدود الاستخدام قيود الطلبات والرموز التي تختلف بحسب النموذج وتُطبق على مستوى المشروع. راجع الحدود الفعلية لمشروعك، وأضف حصصاً مناسبة للمستخدم وحجماً أقصى للمدخلات والمخرجات وضبطاً للتزامن وآلية إيقاف للمسؤول.

راجع ضوابط الفوترة المتاحة أيضاً. يوثق دليل الفوترة سقوف إنفاق للمشروع مع تأخر في المعالجة واحتمال تجاوزها. لا تعد بسقف لحظي صارم؛ افهم نطاق الضابط وراقب الاستخدام، واحتسب العمل الجاري عند تصميم قواعد قبول الطلبات.

مثال مؤرخ للتكلفة دون استدعاء API

استخدمنا سيناريو نصياً توضيحياً للنموذج gemini-2.5-flash بتسعير Standard المدفوع. في ٢ نوفمبر ٢٠٢٦ عرضت صفحة الأسعار الرسمية 0.30 دولار لكل مليون رمز إدخال و2.50 دولار لكل مليون رمز إخراج، بما يشمل رموز التفكير.

نفترض 2,000 رمز إدخال و500 رمز إخراج قابل للفوترة لكل طلب، شاملة أي تفكير. الحساب المحلي هو: مجموع تكلفة رموز الإدخال والإخراج مقسوماً على مليون، أي 0.00185 دولار للطلب. تبلغ تكلفة عشرة آلاف طلب مطابق 18.50 دولاراً لهذه الرموز.

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

ما الذي فحصه مثال ضبط الاستخدام المحلي؟

شغّلنا مثال Python محلياً نملكه. اجتازت الفحوص الستة النتائج التالية:

1. مطابقة تكلفة الطلب المفترض لقيمة 0.00185 دولار.
2. مطابقة تكلفة عشرة آلاف طلب مفترض لقيمة 18.50 دولاراً.
3. رفض طلب دون هوية مستخدم اصطناعية.
4. رفض مدخل يتجاوز الحد التوضيحي للحجم.
5. منع طلب ثانٍ يتجاوز الميزانية التوضيحية بعد حجز تكلفته المقدرة.
6. منع قبول طلب إضافي بعد بلوغ الحصة المحددة للمستخدم التجريبي.

حدود المثال: لم نختبر طلب Gemini أو مصادقة حقيقية أو تطبيقاً مستضافاً. آلية القبول نموذج تعليمي متتابع، وليست محدداً موزعاً للاستخدام أو سقف فوترة لدى المزود. تعتمد التكلفة على عدد رموز مفترض؛ لم نقس جودة النموذج أو زمن استجابة الشبكة.

٤. اختبر الفشل والإصدار المنشور

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

قبل نشر التطبيق، تحقق من النطاق النهائي وبيانات الدخول والصلاحيات والتخزين وتقارير الاستخدام. عند التصدير، اضبط بيئة الخادم المطلوبة في الوجهة. اختبر الدخول والتوليد والتعافي على الإصدار الذي سيستخدمه العملاء. ولقياس الأداء الفعلي، سجل التاريخ والنموذج الدقيق وحجم الطلب والتزامن ونسبة الأخطاء وأزمنة الاستجابة؛ تبقى هذه النتائج غير متحقق منها حتى تُقاس.

تحتاج فحص مفاتيح API وتكاليف تشغيل التطبيق؟ تراجع خدمة فحص جاهزية التطبيقات المبنية بالذكاء الاصطناعي مخاطر التطبيق والبيانات والنشر ضمن نطاق متفق عليه، مع نتائج مرتبة وحدود واضحة للاختبار. تُحدد الإصلاحات بصورة منفصلة؛ المراجعة ليست شهادة أمنية.

ناقش معنا مراجعة تطبيق Google AI Studio قبل إتاحته للجمهور.