يبحث المطورون باستمرار عن نماذج قوية للذكاء الاصطناعي دون تكبد تكاليف باهظة. تلبي Google هذه الحاجة من خلال توفير وصول مجاني إلى النماذج المتقدمة، بما في ذلك الإصدارات التجريبية مثل Gemini 3 Pro.
تحافظ Google على مستوى مجاني سخي لواجهة برمجة تطبيقات Gemini عبر Google AI Studio. يتيح لك هذا الإعداد إنشاء مفتاح API والبدء في استدعاء النماذج على الفور. علاوة على ذلك، اعتبارًا من نوفمبر 2025، توفر Google وصولاً إلى نماذج معاينة Gemini 3 Pro مجانًا، ولكن مع حدود معدل مناسبة للنماذج الأولية والاختبار والتطبيقات صغيرة النطاق.
فهم تسعير واجهة برمجة تطبيقات Gemini 3
بشكل عام، تسعير Gemini 3.0 يسير على النحو التالي:
- <200 ألف رمز (توكن) 2.00 دولار دخول، 12.00 دولار خروج
- >200 ألف رمز (توكن) 4.00 دولار دخول، 18.00 دولار خروج
تاريخ قطع المعرفة لـ Gemini 3.0 محدد في يناير 2025.
إذا كنت ترغب في استخدام واجهة برمجة تطبيقات Gemini 3.0 مجانًا، فإن Google سخية بما يكفي لتتيح لك تجربتها: تقوم Google بهيكلة Gemini API حول مستويين أساسيين: مجاني ومدفوع حسب الاستخدام. يعمل المستوى المجاني بالكامل دون تنشيط الفواتير. وبالتالي، تظل جميع الطلبات مجانية حتى تقوم بتمكين Cloud Billing صراحةً للحصول على حصص أعلى.
يعمل Google AI Studio كواجهة أساسية للوصول المجاني. هنا، تقوم بإنشاء نماذج أولية للمطالبات، وإنشاء مفاتيح API، واستدعاء النماذج مباشرة. تظهر النماذج التجريبية مثل Gemini 3 Pro تلقائيًا في محدد النماذج عندما تكون متاحة في منطقتك.
تشمل المزايا الرئيسية للمستوى المجاني ما يلي:
- لا يتطلب بطاقة ائتمان
- الوصول إلى أحدث النماذج التجريبية، بما في ذلك Gemini 3 Pro
- دعم المدخلات متعددة الوسائط (النص، الصور، الفيديو، الصوت)
- استدعاء الوظائف، المخرجات المهيكلة، وأدوات تنفيذ التعليمات البرمجية
- حدود معدل يتم إعادة تعيينها يوميًا، وهي كافية للتطوير والاستخدام الإنتاجي المعتدل
ومع ذلك، يفرض المستوى المجاني حصصًا لضمان الاستخدام العادل. تبلغ الحدود النموذجية لنماذج معاينة Gemini 3 Pro حوالي 5-10 طلبات في الدقيقة (RPM)، و 250,000 رمز في الدقيقة (TPM)، و 50-100 طلب في اليوم (RPD). تختلف هذه القيم حسب نوع النموذج والمنطقة، وتقوم Google بتعديلها بشكل دوري.
خطوة بخطوة: أنشئ مفتاح Gemini 3 API الخاص بك
تبدأ بإنشاء مفتاح API في Google AI Studio. اتبع هذه الخطوات الدقيقة:
- انتقل إلى aistudio.google.com.
- سجل الدخول باستخدام حسابك في Google (شخصي أو Workspace).
4. انقر فوق أيقونة الملف الشخصي في الزاوية العلوية اليمنى واختر "الحصول على مفتاح API". اختر "إنشاء مفتاح API في مشروع جديد" (أو حدد مشروعًا موجودًا).
6. تقوم Google بإنشاء المفتاح على الفور. انسخه على الفور – لا يمكنك رؤيته مرة أخرى.
علاوة على ذلك، يمكنك إنشاء مفاتيح متعددة وتقييدها على مراجعين محددين أو عناوين IP لأسباب أمنية. تعامل دائمًا مع المفتاح كبيانات حساسة؛ لا تلتزم أبدًا بإدخاله في المستودعات العامة.
للوصول المباشر إلى معاينة Gemini 3 Pro، قم بزيارة هذا الرابط المقدم من Google: https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview. يفتح هذا واجهة دردشة مهيأة مسبقًا باستخدام نموذج المعاينة.
دعنا نجرب Gemini 3.0 API في Google AI Studio
تثبيت حزم SDK الرسمية لـ Gemini للوصول البرمجي
توفر Google مكتبات عميل بلغات متعددة. يمكنك تثبيتها عبر مديري الحزم.
لمطوري بايثون:
pip install -U google-generativeai
ثم قم بتكوين المكتبة:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY_HERE")
model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content("Explain quantum entanglement in simple terms.")
print(response.text)
لمستخدمي Node.js قم بتشغيل:
npm install @google/generative-ai
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY_HERE");
const model = genAI.getGenerativeModel({ model: "gemini-3-pro-preview-11-2025" });
const result = await model.generateContent("Write a Python function to calculate Fibonacci numbers.");
console.log(result.response.text());
تشمل اللغات الأخرى المدعومة Go و Java و Swift. تتعامل جميع المكتبات مع المصادقة وإعادة المحاولة والبث تلقائيًا.
إرسال أول طلب لك إلى Gemini 3 API باستخدام curl
يمكنك الاختبار مباشرة باستخدام curl للتحقق السريع:
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview-11-2025:generateContent?key=YOUR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
"contents": [{
"role": "user",
"parts": [{ "text": "Describe the key improvements in Gemini 3 over previous versions." }]
}]
}'
تعيد نقطة النهاية هذه استجابة JSON تحتوي على النص الذي تم إنشاؤه وبيانات التعريف الخاصة بالاستخدام.
استخدم Apidog لسير عمل اختبار API أفضل وأكثر تكاملاً
تعمل أوامر curl الخام للاختبارات البسيطة، لكن التطوير بدرجة الإنتاج يتطلب أدوات أفضل. يتفوق Apidog هنا كعميل API كامل الميزات ومنصة توثيق.
يمكنك استيراد مواصفات Gemini OpenAPI الرسمية إلى Apidog، والتي تنشئ تلقائيًا جميع نقاط النهاية والمعاملات وهيئات الطلبات. بعد ذلك، يمكنك:
- حفظ مفتاح API الخاص بك كمتغير بيئة
- إنشاء مجموعات لحالات الاستخدام المختلفة (توليد النص، الرؤية، استدعاء الوظائف)
- إرسال طلبات متعددة الوسائط عن طريق تحميل الصور أو مقاطع الفيديو مباشرة
- عرض استخدام الرمز (توكن) وبيانات تعريف الاستجابة في الوقت الفعلي
- إنشاء رمز العميل (Python، JS، إلخ) من الطلبات الفعلية
- خوادم وهمية لاختبار الواجهة الأمامية دون استهلاك الحصة
واجهة Apidog لاختبار نقاط نهاية Gemini 3 API
يختار العديد من المطورين Apidog خصيصًا لسير عمل Gemini لأنه يتعامل مع عمليات تحميل الملفات الكبيرة، واستجابات البث، ومخرجات JSON المهيكلة بسلاسة – وهي ميزات تعاني منها Postman في واجهات برمجة التطبيقات التوليدية.
ما هي حدود معدل واجهة برمجة تطبيقات Gemini 3.0؟
لا تكشف Google عن حد معدل واجهة برمجة تطبيقات Gemini 3.0 حاليًا، على الرغم من أن المستخدمين يبلغون أنهم يعانون من حدود المعدل في غضون بضع محادثات (رمز الخطأ: لقد وصلت إلى حد المعدل الخاص بك. يرجى المحاولة مرة أخرى لاحقًا).
استنادًا إلى وثائق Google الرسمية، تحتوي واجهة برمجة تطبيقات Gemini على مستوى مجاني يمكن الوصول إليه عبر Google AI Studio وهو خاضع لقيود معدل لضمان الاستخدام العادل. تقاس هذه القيود بشكل أساسي بـ الطلبات في الدقيقة (RPM)، وبالنسبة لبعض النماذج، أيضًا بـ الطلبات في اليوم (RPD) و الرموز في الدقيقة (TPM). على سبيل المثال، يمتلك النموذج القياسي gemini-1.0-pro حد معدل مجاني يبلغ 60 طلبًا في الدقيقة، وهو كافٍ بشكل عام للتطوير والاختبار. تُقدم هذه الحدود مجانًا ولا تتطلب إعداد حساب فوترة.
نماذج مختلفة ضمن عائلة Gemini لها حدود معدل مختلفة. تجاوز حد معدل النموذج سيؤدي إلى خطأ HTTP 429 "Resource Exhausted" (الموارد مستنفدة). للتعامل مع هذا، يجب على المطورين تنفيذ معالجة الأخطاء باستراتيجية التراجع الأسي، والتي تتضمن الانتظار لفترات أطول تدريجيًا قبل إعادة محاولة الطلب. للتطبيقات التي تتطلب حجم طلب أعلى مما يسمح به المستوى المجاني، يجب عليك تمكين الفوترة في مشروع Google Cloud والانتقال إلى خطة الدفع حسب الاستخدام، والتي توفر حدودًا أعلى بكثير (ai.google.dev).
لتحقيق إنتاجية أعلى، يمكنك إنشاء حسابات Google متعددة (لكل منها مفتاح خاص بها) وتدويرها – وهي ممارسة شائعة بين المطورين الذين يبقون ضمن الحدود المجانية.
الرؤية والفيديو مع واجهة برمجة تطبيقات Gemini 3.0
يعالج Gemini 3 الصور والفيديو بشكل طبيعي. مثال على كود Python لتحليل الصور:
from google.generativeai.types import File
image_file = genai.upload_file(path="diagram.png")
model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content([
"Explain this architecture diagram in detail:",
image_file
])
print(response.text)
يعمل فهم الفيديو بالمثل – قم بتحميل ملف MP4 واطرح أسئلة حول المحتويات أو الطوابع الزمنية أو الإجراءات.
الخلاصة
تتيح Google وصولاً غير مسبوق إلى الذكاء الاصطناعي على مستوى الحدود من خلال مستواها المجاني. يمكنك الحصول على مفتاح في أقل من دقيقتين، والبدء في استدعاء نماذج معاينة Gemini 3 Pro على الفور، وإنشاء تطبيقات متطورة دون إنفاق المال.
اجمع هذه القدرة مع عميل API قوي مثل Apidog، وستحصل على بيئة تطوير كاملة تنافس الخدمات المدفوعة. الآلاف من المطورين يقومون بالفعل بإنشاء نماذج أولية للوكلاء، وأنظمة RAG، والتطبيقات متعددة الوسائط بهذه الطريقة.
اتخذ إجراءً الآن: توجه إلى Google AI Studio، أنشئ مفتاحك، قم بتنزيل Apidog، وأرسل أول طلب لك إلى Gemini 3. لم يكن حاجز البناء باستخدام أحدث تقنيات الذكاء الاصطناعي أدنى من أي وقت مضى.