
"مرحباً، لدي حساب على Google AI Studio، ولكن تظهر رسالة تفيد بأن الرصيد المجاني قد نفد. أرغب في الاستمرار في استخدام AI Studio لإنشاء النماذج، لكن حسابي المجاني لا يمكن شحنه. كيف يمكنني شحن رصيد حساب جوجل هذا، أو ما هي الطرق الأخرى للاستمرار في الاستخدام؟"
هذا استفسار نتلقاه يومياً من المستخدمين. رصيد Google AI Studio المجاني محدود بالفعل، وفي ديسمبر 2025، قامت جوجل بخفض حصص الفئة المجانية بشكل كبير.
الخبر السار هو: لا تحتاج إلى شحن رصيد حساب جوجل الخاص بك لتتمكن من مواصلة استخدام سلسلة نماذج Gemini الكاملة.
الفكرة الأساسية بسيطة: قم بتصدير الكود الخاص بك، واستدعه محلياً للتطوير.
سيتناول هذا المقال بالتفصيل 3 حلول لمساعدتك على الاستمرار في استخدام Gemini بعد نفاذ الرصيد المجاني.
فهم قيود رصيد AI Studio
حصص الفئة المجانية الحالية (عام 2026)
في 7 ديسمبر 2025، أجرت جوجل تعديلات كبيرة على حصص Gemini Developer API، وبدأ العديد من المطورين فجأة في مواجهة خطأ 429:
| النموذج | RPM الفئة المجانية | RPD الفئة المجانية | RPM الفئة المدفوعة |
|---|---|---|---|
| Gemini 1.5 Pro | 5 | 25 | 1,000 |
| Gemini 1.5 Flash | 15 | 500 | 2,000 |
| Gemini 2.0 Flash | 15 | 1,500 | 4,000 |
ملاحظة: RPM = عدد الطلبات في الدقيقة، RPD = عدد الطلبات في اليوم.
لماذا ينفد الرصيد فجأة؟
| السبب | التوضيح |
|---|---|
| تجاوز حد RPM | عدد كبير جداً من الطلبات في وقت قصير |
| تجاوز حد RPD | إجمالي الطلبات اليومية وصل إلى الحد الأقصى |
| تجاوز حد TPM | السياق الطويل يستهلك كمية كبيرة من الـ Tokens |
| خفض الحصص | القيود أصبحت أكثر صرامة بعد تعديلات جوجل في ديسمبر 2025 |
تنبيه هام: لا يمكن ربط عدة مفاتيح API لزيادة الحصص
يعتقد الكثير من المستخدمين أن إنشاء عدة مفاتيح API سيوفر لهم حصة أكبر، ولكن في الواقع:
تُحسب الحصص لكل مشروع (Project)، وليس لكل مفتاح API. إنشاء مفاتيح API متعددة في نفس المشروع لن يؤدي إلى زيادة الحصة.

الخيار الأول: تصدير الكود للتطوير المحلي (موصى به)
الفكرة الأساسية
يُعد AI Studio في جوهره أداة مرئية لتصحيح أخطاء الموجه (Prompt). يمكنك تصدير النماذج والموجهات التي قمت بإنشائها وتصحيحها في AI Studio ككود برمج، واستخدامها في بيئتك المحلية باستخدام مفتاح API الخاص بك.
خطوات العمل
الخطوة 1: إكمال تصحيح الموجه (Prompt) في AI Studio
استخدم الحصة المجانية في AI Studio لضبط الموجه الخاص بك، وتكوين المعلمات، وما إلى ذلك.
الخطوة 2: تصدير الكود
يوفر AI Studio عدة طرق للتصدير:
- تحميل ZIP: تصدير حزمة الكود كاملة إلى جهازك المحلي.
- الدفع إلى GitHub: إرسال الكود مباشرة إلى مستودع الكود الخاص بك.
- نسخ مقتطفات الكود: نسخ كود Python أو JavaScript أو curl.
الخطوة 3: تكوين مفتاح API محلياً
# إعداد متغير البيئة (موصى به)
export GEMINI_API_KEY="your-api-key-here"
# أو
export GOOGLE_API_KEY="your-api-key-here"
الخطوة 4: التشغيل محلياً
import google.generativeai as genai
import os
# القراءة التلقائية لمفتاح API من متغيرات البيئة
genai.configure(api_key=os.environ.get("GEMINI_API_KEY"))
model = genai.GenerativeModel('gemini-2.0-flash')
response = model.generate_content("你好,请介绍一下自己")
print(response.text)
ملاحظات هامة
| الأمر | التوضيح |
|---|---|
| أمان مفتاح API | لا تضع مفتاح API مباشرة (Hardcode) داخل كود العميل |
| متغيرات البيئة | استخدم GEMINI_API_KEY أو GOOGLE_API_KEY |
| القيود لا تزال قائمة | تظل الاستدعاءات المحلية خاضعة لقيود حصة المستوى المجاني |
🎯 نصيحة تقنية: بعد تصدير الكود، إذا كانت الحصة المجانية لا تزال غير كافية، يمكنك التفكير في استخدام مزودي خدمة API خارجيين مثل APIYI (apiyi.com). توفر هذه المنصات حصصاً أعلى وطرق محاسبة أكثر مرونة.
الخيار الثاني: استخدام خدمة وكيل API خارجية (الحل الأمثل)
ما هي خدمة وكيل API؟
يقوم مزودو خدمة وكيل API بتجميع العديد من مفاتيح API وموارد الحسابات لتوفير واجهة API موحدة. كل ما تحتاجه هو:
- التسجيل في منصة الوكيل للحصول على مفتاح API.
- تغيير عنوان API في الكود الخاص بك إلى عنوان الوكيل.
- المتابعة في الاستخدام دون القلق بشأن قيود الحصة.
لماذا تختار وكيل API؟
| الميزة | التوضيح |
|---|---|
| لا قلق بشأن الحصة | الوكيل يدير الحصص، وأنت تركز على الاستخدام فقط |
| دعم كامل لسلسلة النماذج | تغطية شاملة لـ Gemini Pro و Flash و Nano Banana وغيرها |
| تنسيق متوافق مع OpenAI | لا حاجة لتغيير هيكل الكود الحالي |
| الدفع حسب الاستخدام | ادفع مقابل ما تستخدمه فقط، بدون رسوم شهرية |
| أكثر استقراراً | موازنة تحميل عبر عدة نقاط لتجنب تقييد التدفق |
مثال على هجرة الكود
قبل الهجرة (استدعاء مباشر لـ Google API):
import google.generativeai as genai
genai.configure(api_key="YOUR_GOOGLE_API_KEY")
model = genai.GenerativeModel('gemini-2.0-flash')
response = model.generate_content("Hello")
بعد الهجرة (باستخدام وكيل API):
import openai
client = openai.OpenAI(
api_key="YOUR_APIYI_KEY",
base_url="https://api.apiyi.com/v1" # الواجهة الموحدة لـ APIYI
)
response = client.chat.completions.create(
model="gemini-2.0-flash",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)
قائمة النماذج المدعومة
| سلسلة النماذج | النموذج المحدد | التوضيح |
|---|---|---|
| Gemini 2.5 | gemini-2.5-pro, gemini-2.5-flash | أحدث النماذج متعددة الوسائط |
| Gemini 2.0 | gemini-2.0-flash, gemini-2.0-flash-thinking | نماذج استدلال سريعة |
| Gemini 3 | gemini-3-pro-image-preview | نماذج توليد الصور |
| Nano Banana | nano-banana-pro | توليد صور أصلي |
💡 بداية سريعة: نوصي باستخدام منصة APIYI (apiyi.com) للوصول السريع. تدعم المنصة سلسلة Gemini بالكامل وتوفر تنسيقاً متوافقاً مع OpenAI، مما يسمح لك بإكمال عملية الهجرة في غضون 5 دقائق.
الخيار الثالث: الترقية إلى فئة Google المدفوعة
مقارنة حصص الفئات المدفوعة
إذا كنت ترغب في الاستمرار في استخدام خدمات Google الرسمية، يمكنك التفكير في الترقية إلى الفئة المدفوعة:
| الفئة | شرط التفعيل | Gemini 2.5 Pro (طلب/دقيقة) | Gemini 2.5 Flash (طلب/دقيقة) |
|---|---|---|---|
| مجانية (Free) | افتراضي | 5 | 15 |
| الفئة 1 (Tier 1) | تفعيل الفوترة | 150 | 1,000 |
| الفئة 2 (Tier 2) | إنفاق +50$ | 500 | 2,000 |
| الفئة 3 (Tier 3) | إنفاق +500$ | 1,000 | 4,000 |
خطوات الترقية
- تسجيل الدخول إلى Google Cloud Console
- إنشاء أو اختيار مشروع
- تفعيل الفوترة (Billing) عبر ربط بطاقة ائتمان
- تحقق من تغير الحصة (Quota) في AI Studio
مشاكل الفئة المدفوعة
| المشكلة | التوضيح |
|---|---|
| تطلب بطاقة ائتمان دولية | يصعب على بعض المستخدمين المحليين الحصول عليها |
| تطلب حساب Google Cloud | الإعداد معقد نسبياً |
| حد أدنى للإنفاق | الترقية للفئات العليا تتطلب الوصول لمستوى إنفاق معين |
| لا يزال هناك حد أقصى للحصة | يتم رفع السقف فقط، وليس استخداماً غير محدود |
مقارنة بين الخيارات الثلاثة

| بُعد المقارنة | تصدير الكود للتطوير محلياً | خدمة بروكسي API | الترقية للفئة المدفوعة |
|---|---|---|---|
| صعوبة الإعداد | متوسطة | بسيطة | معقدة |
| قيود الحصة | لا تزال مقيدة | بلا قيود | زيادة الحد الأقصى |
| التكلفة | مجاني (بقيود) | حسب الاستخدام | حسب الاستخدام |
| يتطلب بطاقة ائتمان | لا | لا | نعم (بطاقة دولية) |
| الاستقرار | عادي | عالي | عالي |
| حالات الاستخدام | استخدام خفيف | موصى به لمعظم المستخدمين | احتياجات المؤسسات |
دليل تفصيلي: الانتقال من AI Studio إلى وكيل API
الخطوة 1: تسجيل حساب على منصة وكيل API
قم بزيارة APIYI (apiyi.com)، وسجل حسابًا للحصول على مفتاح API (API Key).
الخطوة 2: تثبيت OpenAI SDK
# Python
pip install openai
# Node.js
npm install openai
الخطوة 3: تعديل إعدادات الكود
مثال بلغة Python:
import openai
# 配置 API 代理
client = openai.OpenAI(
api_key="YOUR_APIYI_KEY",
base_url="https://api.apiyi.com/v1" # APIYI统一接口
)
# 调用 Gemini 模型
def chat_with_gemini(prompt):
response = client.chat.completions.create(
model="gemini-2.5-flash", # 可选其他 Gemini 模型
messages=[
{"role": "user", "content": prompt}
],
temperature=0.7,
max_tokens=2048
)
return response.choices[0].message.content
# 使用示例
result = chat_with_gemini("用 Python 写一个快速排序算法")
print(result)
مثال بلغة Node.js:
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'YOUR_APIYI_KEY',
baseURL: 'https://api.apiyi.com/v1'
});
async function chatWithGemini(prompt) {
const response = await client.chat.completions.create({
model: 'gemini-2.5-flash',
messages: [
{ role: 'user', content: prompt }
]
});
return response.choices[0].message.content;
}
// 使用示例
const result = await chatWithGemini('解释什么是机器学习');
console.log(result);
الخطوة 4: الاختبار والتحقق
# 测试连接
try:
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": "Hello, 测试连接"}],
max_tokens=50
)
print("连接成功:", response.choices[0].message.content)
except Exception as e:
print("连接失败:", e)

ترحيل نماذج توليد الصور
توليد الصور في AI Studio
إذا كنت تستخدم ميزة توليد الصور من Gemini (Nano Banana Pro) في AI Studio، يمكنك الاستمرار في استخدامها من خلال بروكسي واجهة برمجة التطبيقات (API) بنفس الطريقة:
import openai
client = openai.OpenAI(
api_key="YOUR_APIYI_KEY",
base_url="https://api.apiyi.com/v1"
)
# توليد الصور
response = client.images.generate(
model="nano-banana-pro",
prompt="قطة برتقالية لطيفة تأخذ غفوة تحت أشعة الشمس، بأسلوب تصوير واقعي",
size="1024x1024",
quality="hd"
)
image_url = response.data[0].url
print(f"الصورة التي تم إنشاؤها: {image_url}")
الحوار متعدد الوسائط (دمج النصوص والصور)
import base64
def encode_image(image_path):
with open(image_path, "rb") as f:
return base64.b64encode(f.read()).decode()
image_base64 = encode_image("example.jpg")
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "صف محتوى هذه الصورة"},
{
"type": "image_url",
"image_url": {
"url": f"data:image/jpeg;base64,{image_base64}"
}
}
]
}
]
)
print(response.choices[0].message.content)
💰 تحسين التكلفة: بالنسبة لاحتياجات توليد الصور، توفر منصة APIYI (apiyi.com) خيارات فوترة مرنة، وتدعم مجموعة متنوعة من النماذج مثل Nano Banana Pro وDALL-E وStable Diffusion، مما يتيح لك اختيار الحل الأمثل بناءً على متطلباتك.
التعامل مع الأخطاء الشائعة
الخطأ 1: 429 طلبات كثيرة جداً (Too Many Requests)
import time
from tenacity import retry, stop_after_attempt, wait_exponential
@retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=2, max=10))
def call_api_with_retry(prompt):
return client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": prompt}]
)
الخطأ 2: مفتاح API غير صالح
# التحقق من إعدادات مفتاح API
import os
api_key = os.environ.get("APIYI_KEY")
if not api_key:
raise ValueError("يرجى إعداد المتغير البيئي APIYI_KEY")
client = openai.OpenAI(
api_key=api_key,
base_url="https://api.apiyi.com/v1"
)
الخطأ 3: النموذج غير موجود
# التأكد من صحة اسم النموذج
SUPPORTED_MODELS = [
"gemini-2.5-pro",
"gemini-2.5-flash",
"gemini-2.0-flash",
"nano-banana-pro"
]
model_name = "gemini-2.5-flash"
if model_name not in SUPPORTED_MODELS:
print(f"تحذير: قد لا يكون {model_name} ضمن قائمة النماذج المدعومة")
الأسئلة الشائعة FAQ
س1: متى يتم إعادة تعيين الرصيد المجاني في AI Studio؟
- RPM (عدد الطلبات في الدقيقة): نافذة متغيرة، يتم إعادة تعيينها كل دقيقة.
- RPD (عدد الطلبات اليومية): يتم إعادة تعيينها عند منتصف الليل بتوقيت المحيط الهادئ.
- TPM (عدد الـ Tokens في الدقيقة): نافذة متغيرة، يتم إعادة تعيينها كل دقيقة.
إذا كنت بحاجة ماسة للاستخدام، ننصحك بالاستعانة بمنصة APIYI (apiyi.com) للوصول إلى النماذج دون الحاجة لانتظار إعادة تعيين الحصص.
س2: هل استخدام وكيل API (Proxy) آمن؟
اختيار مزود خدمة وكيل API رسمي وموثوق يعتبر أمراً آمناً. عليك فقط الانتباه للنقاط التالية:
- اختر مزود خدمة يتمتع بسمعة طيبة.
- لا تضع مفتاح الـ API (API Key) بشكل مباشر داخل الكود (Hardcoding).
- استخدم متغيرات البيئة (Environment Variables) لإدارة مفاتيحك.
س3: كيف هي أسعار وكيل الـ API؟
تعتمد معظم خدمات وكلاء الـ API نظام "الدفع حسب الاستخدام"، وغالباً ما تكون أسعارها أكثر تنافسية من الأسعار الرسمية. توفر منصة APIYI (apiyi.com) نظام تسعير شفاف يمكنك الاطلاع على تفاصيله مباشرة عبر موقعهم.
س4: هل يحتاج الكود لتعديلات كبيرة بعد الانتقال؟
إذا كنت تستخدم تنسيق API متوافق مع OpenAI، فإن التعديلات ستكون طفيفة جداً:
- ستحتاج فقط لتعديل
api_keyوbase_url. - قد يتطلب الأمر تعديل اسم النموذج المستخدم.
- لا حاجة لتغيير أي من المنطق البرمجي الآخر في الكود.
س5: هل يمكن استخدام عدة خدمات API في نفس الوقت؟
نعم، يمكنك اختيار الخدمة المناسبة حسب السيناريو:
- استخدم الرصيد المجاني في AI Studio للاختبارات البسيطة.
- استخدم خدمات وكيل API لعمليات التطوير اليومية.
- استخدم الخدمات الرسمية المدفوعة للمتطلبات الخاصة جداً.
الخلاصة
عندما ينفد رصيدك المجاني في Google AI Studio، لديك 3 خيارات:
| الخيار | الفئة المستهدفة | الإجراء الأساسي |
|---|---|---|
| التصدير للتطوير المحلي | المستخدمون العاديون | تصدير الكود واستدعاؤه محلياً |
| خدمة وكيل API | أغلب المطورين | تعديل الـ base_url والمتابعة فوراً |
| ترقية فئة الدفع | احتياجات الشركات | ربط بطاقة ائتمان دولية لزيادة الحصص |
نصائح جوهرية:
- لا تشحن رصيد حساب جوجل مباشرة (إلا إذا كنت تملك بطاقة ائتمان دولية وتحتاج فعلاً لخدمات مخصصة للشركات).
- قُم بتصدير الكود الخاص بك إلى بيئتك المحلية.
- استخدم خدمة وكيل API لمواصلة استدعاء نماذج Gemini.
- الخلاصة في جملة واحدة: صَدّر كودك، وشغله وطوره في بيئتك المحلية.
نوصي باستخدام APIYI (apiyi.com) لاستئناف استخدام Gemini بسرعة، حيث تدعم المنصة سلسلة نماذج Gemini بالكامل، وتوفر تنسيقاً متوافقاً مع OpenAI، مما يجعل تكلفة الانتقال شبه معدومة.
قراءات إضافية:
- حدود معدل استهلاك Gemini API: ai.google.dev/gemini-api/docs/rate-limits
- وضع البناء في AI Studio: ai.google.dev/gemini-api/docs/aistudio-build-mode
- دليل استخدام مفتاح API Key: ai.google.dev/gemini-api/docs/api-key
📝 المؤلف: الفريق التقني لمنصة APIYI | متخصصون في دمج وتحسين نماذج لغة كبيرة عبر API
🔗 التواصل التقني: تفضل بزيارة APIYI (apiyi.com) للحصول على دعم استدعاء سلسلة نماذج Gemini الكاملة.
