كيفية استخدام واجهة Gemini Decisions API مجانًا

يمكنك استخدام Gemini Decisions API مجانًا اعتبارًا من اليوم. تفرض الفئة المجانية من Google على نموذج gemini-decision-1 عدم تحصيل أي رسوم على المدخلات، ولا تحتسب أي رموز للمخرجات، وتسمح بـ 200 طلب في الدقيقة، و50,000 رمز في الدقيقة، و10,000 طلب يوميًا لكل مشروع. كل ما تحتاجه هو مفتاح API من AI Studio، دون الحاجة إلى حساب فوترة. لكن هناك ملاحظة مهمة: في الفئة المجانية، قد تستخدم Google محتواك لتحسين منتجاتها.

أدناه: ماذا تعني هذه الحدود في أحمال عمل حقيقية، ومعادلة الرموز الكامنة وراء سعر $0.10 لكل مليون في الخطة المدفوعة، والمسارات المجانية الأخرى، وكيفية إبقاء الاختبارات وCI خارج حصتك اليومية. تمت قراءة كل الحدود والأسعار من الصفحات الرسمية لـ Google بتاريخ 12 نوفمبر 2026. تصدر الواجهة البرمجية بإصدار v1beta، لذا أعد التحقق قبل اعتماد أي ميزانية. أما بالنسبة لأنواع الأسئلة نفسها (noul، choice، score)، فراجع دليل Decisions API من Google.

ماذا تشمل الفئة المجانية من Gemini Decisions API

الفئة المجانية من Gemini Decisions API هي مستوى الاستخدام بدون تكلفة من واجهة Google البرمجية للمطورين Gemini Developer API والمطبق على نموذج gemini-decision-1. تمنحك معالجة مجانية للمدخلات لكل مشروع على Google Cloud، دون أي رسوم على المخرجات، وحدود معدل ثابتة تبلغ 200 طلب في الدقيقة، و50,000 رمز في الدقيقة، و10,000 طلب يوميًا، دون أي إعداد للفوترة.

إليك ما تقوله صفحة الأسعار وصفحة حدود المعدل من Google، جنبًا إلى جنب:

البند	الفئة المجانية	المدفوعة (المستوى 1)
سعر المدخلات (نص، صورة، فيديو، صوت، PDF)	مجانًا تمامًا	$0.10 لكل مليون رمز
سعر المخرجات	غير قابل للتطبيق (0 رمز مخرجات)	غير قابل للتطبيق (0 رمز مخرجات)
الطلبات في الدقيقة	200	1,500
الرموز في الدقيقة	50,000	1,000,000
الطلبات في اليوم	10,000	50,000
استخدام المحتوى لتحسين منتجات Google	نعم	لا
التخزين المؤقت للسياق (Context caching)	غير متاح	غير متاح

ثلاث تفاصيل أهم من الأرقام الرئيسية:

الحدود لكل مشروع، وليس لكل مفتاح API. إنشاء خمسة مفاتيح في مشروع واحد لا يمنحك خمس حصص.
تُعاد الحصة اليومية عند منتصف الليل بتوقيت المحيط الهادئ. مهمة دفعية تبدأ في الساعة 11 مساءً بتوقيت المحيط الهادئ تحصل على ساعة واحدة من حصة اليوم وحصة جديدة كاملة (10,000) بعد منتصف الليل.
بيانات الفئة المجانية قد تستخدمها Google. يشير جدول الأسعار إلى "يُستخدم لتحسين منتجاتنا" بـ "نعم" في الفئة المجانية و"لا" في المدفوعة. لا ترسل بيانات العملاء الشخصية أو العقود أو الصور الطبية عبر مفتاح مجاني.

Gauge diagram of the Gemini Decisions API free tier limits: 200 requests per minute, 50,000 tokens per minute and 10,000 requests per day, resetting at midnight Pacific per project

كيفية الحصول على مفتاح Gemini Decisions API مجانًا

يمكنك البدء في إجراء استدعاءات مجانية خلال حوالي خمس دقائق:

سجّل الدخول إلى Google AI Studio وانقر على Create API key. سيبدأ مشروع جديد ضمن الفئة المجانية.
ثبّت الإصدار 3.2 من SDK أو أحدث: pip install -U google-genai أو npm install @google/genai@latest.
صدّر المفتاح باسم GEMINI_API_KEY ليتمكن الـ SDK من التقاطه.
أرسل طلبًا واحدًا مع http_options={"api_version": "v1beta"} واقرأ كتلة usage في الاستجابة.

from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

result = client.decisions.create(
    model="gemini-decision-1",
    input="Order 8821 arrived with a cracked screen.",
    questions={
        "is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
    },
)

print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)

الرقم usage.total_input_tokens هو ما يجب عليك تسجيله. في الفئة المجانية، هو ما يستنزف حصة الـ 50,000 رمز في الدقيقة؛ وفي الخطة المدفوعة، هو الشيء الوحيد الذي تدفع مقابله.

لمعرفة بقية العروض المجانية من Google، راجع دليل الفئة المجانية من Gemini API وكيفية استخدام Gemini مجانًا.

كيف يعمل تسعير Gemini Decisions API

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

Billing diagram for a Gemini Decisions API request: one shared input billed once fans out to five questions, each adding only its own instruction tokens, with a receipt showing input tokens times $0.10 per 1M and zero output tokens

لذا فإن معادلة الطلب الواحد بسيطة:

input tokens = shared input + sum(each question's instructions + criteria)
paid cost    = input tokens / 1,000,000 x $0.10

الجزء المثير للاهتمام هو ما يحدثه ذلك على الفئة المجانية. مع النصوص، عادةً ما يكون عدد الطلبات (200 RPM، 10,000 RPD) هو العامل المحدد أولًا. مع الصور أو الصوت أو المستندات الطويلة، يصبح حد الـ 50,000 رمز في الدقيقة هو المحدد أولًا.

أمثلة عملية على التكلفة: الفئة المجانية مقابل المدفوعة

أرقام رموز الأسئلة أدناه تقديرية (حوالي 30 رمزًا لكل سؤال قصير). أعداد الصور والصوت مأخوذة من جدول دقة الوسائط من Google، الذي يذكر 280 رمزًا لكل صورة بدقة low، و1,120 بدقة high، و25 رمزًا لكل ثانية من الصوت لنماذج Gemini الحالية. شغّل طلبًا حقيقيًا واحدًا واستبدل أرقامي بقيم usage الخاصة بك.

10,000 صورة منتج × 16 سؤالًا

لنفترض أنك تفحص صور التوصيل للتأكد من عدم وجود تلف، وصحة المكان، ووضوح الملصق، و13 أمرًا آخر.

لكل طلب بدقة low: 280 (الصورة) + 20 (السياق النصي) + 16 × 30 (الأسئلة) = 780 رمزًا
10,000 صورة: 10,000 × 780 = 7.8 مليون رمز
التكلفة المدفوعة: 7.8 × $0.10 = $0.78
بدقة high: 1,120 + 20 + 480 = 1,620 رمزًا لكل صورة، أي 16.2 مليون رمز، $1.62

في الفئة المجانية، تحدد حصة TPM سرعتك: 50,000 ÷ 780 = حوالي 64 صورة في الدقيقة. تكتمل الـ 10,000 صورة خلال حوالي ساعتين و36 دقيقة، وتستهلك حصة يوم كامل بالضبط من 10,000 طلب. بدقة high، تكون السرعة حوالي 30 صورة في الدقيقة، وتستغرق العملية 5.5 ساعة.

والآن الخطأ الذي يجب تجنبه. إذا أرسلت الفحوصات الـ 16 كطلبات منفصلة، فسيعيد كل طلب إرسال الصورة: 16 × 300 = 4,800 رمزًا (الصورة والسياق) بالإضافة إلى 480 رمزًا للأسئلة نفسها، أي حوالي 5,280 رمزًا لكل صورة. هذا يعني 52.8 مليون رمز ($5.28 مدفوعة) و160,000 طلب، أي 16 يومًا من حصة الفئة المجانية. ادمج الأسئلة في طلب واحد.

10,000 تذكرة دعم × 3 أسئلة توجيه

لكل طلب: 250 (نص التذكرة) + 3 × 40 (أسئلة مع معايير) = 370 رمزًا
10,000 تذكرة: 3.7 مليون رمز، $0.37 مدفوعة
الفئة المجانية: 50,000 ÷ 370 = 135 طلبًا في الدقيقة، وهو ما يقع تحت حد الـ 200 RPM. حصة الـ 10,000 طلبات اليومية تغطي 10,000 تذكرة.

ملفات PDF الطويلة

نافذة السياق تبلغ 262,144 رمزًا، لكن حصة TPM المجانية هي 50,000 فقط، لذا فإن عقدًا واحدًا يتكون من 120,000 رمز يتجاوز ميزانية دقيقة كاملة من الفئة المجانية. لا توضح وثائق Google كيف تتعامل الفئة المجانية مع طلب واحد يتجاوز حد TPM، لذا اختبر طلبًا واحدًا أولًا. المستندات الطويلة هي الحالة التي يجعل فيها المستوى 1 (مليون TPM) تكلفته مبررة.

طرق أخرى لاستخدام Gemini Decision 1 بتكلفة صفرية

المسار	التكلفة	هل يلزم بطاقة أو فوترة؟	ما يصلح له
الفئة المجانية من Gemini API (مفتاح AI Studio)	$0، 200 RPM / 50,000 TPM / 10,000 RPD	لا	النماذج الأولية، الأدوات الداخلية، المهام الدفعية الليلية التي تقل عن 10,000 طلب
Decisions Playground في AI Studio	$0 (فئة مجانية، حسب منشور الإطلاق من Google)	لا	تجربة صياغة الأسئلة قبل كتابة الكود
OpenRouter (`google/gemini-decision-1`)	$0.10 لكل مليون مدخلات، $0 للمخرجات	نعم، رصيد	مفتاح واحد عبر عدة مزودين؛ غير مجاني

صفحة النموذج على OpenRouter، كما تم فحصها بتاريخ 12 نوفمبر 2026، تعرض مزودًا واحدًا (Google AI Studio) بسعر $0.10 لكل مليون رمز مدخلات، ومخرجات مجانية، دون أي نسخة :free. يعمل عبر نقطة نهاية Decisions على OpenRouter، لذا لن تستطيع SDKs المحادثة (chat completions) استدعاءه.

كيف تبقى داخل الفئة المجانية

تساعدك هذه الممارسات على إبقاء النموذج الأولي بتكلفة $0 لأطول فترة ممكنة:

اطرح كل الأسئلة في طلب واحد. المدخل المشترك يُحتسب مرة واحدة، ويمكن أن يضم الطلب الواحد حتى 1,000 سؤال.
اخفض دقة الوسائط. الدقة low تكلف ربع تكلفة high لكل صورة.
أرسل فقط الحقول التي تحتاجها الأسئلة. تقول Google إن المحتوى غير ذي الصلة يقلل الدقة، وهو أيضًا يستنزف TPM.
اضبط المعدل على TPM وليس RPM. نظّم إيقاع العاملين بحيث يُقسم 50,000 على عدد الرموز المقاسة لكل طلب.
خزّن الإجابات بنفسك. الواجهة البرمجية لا تدعم التخزين المؤقت للسياق وتحتسب المدخلات المتكررة بالكامل، لذا احسب هاش (hash) للمدخل والأسئلة معًا وتجاوز التكرارات.
ابدأ المهام الكبيرة بعد منتصف الليل بتوقيت المحيط الهادئ لتحصل على يوم كامل من الحصة.
أبقِ الاختبارات وCI بعيدًا عن الواجهة الحقيقية. مجموعة اختبارات تستدعيها عند كل عملية push قد تستنفد 10,000 طلب قبل الغداء. استخدم بدائل المحاكاة (mocking) بدلًا من ذلك.

دع وكيل البرمجة الخاص بك يحاكي Decisions API باستخدام Apidog CLI

اختبارات الوحدات لا تحتاج نموذجًا حقيقيًا. إنها تحتاج الشكل الصحيح فقط: خريطة answers، وقيمة noul بين 0.01 و0.99، وقيمة confidence، وقيمة usage.total_output_tokens: 0. يمكن لوكيل البرمجة الخاص بك بناء هذا المحاكاة باستخدام Apidog CLI، بحيث يبقى اختبار دخان (smoke test) واحد فقط هو ما يلمس Google.

الإعداد لمرة واحدة:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

ثم أعطِ Claude Code أو Codex أو Cursor هذا الأمر (prompt) واحدًا:

In Apidog project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.

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

apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <id> --file decisions-endpoint.json

apidog cli-schema get mock-create
apidog cli-schema validate mock-create --file mock-damaged.json
apidog mock create --project <id> --file mock-damaged.json

apidog cli-schema get test-case-create
apidog test-case create --project <id> --file decisions-case.json
apidog run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apidog run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli

في CI، شغّل بيئة المحاكاة فقط مع -r junit (ملف المسار في دليل CI/CD لـ Apidog CLI)؛ وإعداد الوكيل موجود في Apidog CLI في Claude Code. تغطي الخطة المجانية من Apidog ما يصل إلى 4 مستخدمين، لذا يمكن لفريق صغير مشاركة المحاكيات دون أي تكلفة. هل تفكر أيضًا في نسخة OpenAI؟ راجع شرح OpenAI Decisions API.

الأسئلة الشائعة

هل Gemini Decisions API مجاني؟ نعم، ضمن حدود معينة. الفئة المجانية لا تفرض أي رسوم على المدخلات، والمخرجات هي دائمًا 0 رمز. تحصل على 200 طلب في الدقيقة، و50,000 رمز في الدقيقة، و10,000 طلب يوميًا لكل مشروع. وبعد ذلك، فعّل الفوترة وادفع $0.10 لكل مليون رمز مدخلات.

هل أحتاج بطاقة ائتمان للفئة المجانية من Gemini Decisions API؟ لا. مفتاح API من Google AI Studio يبدأ ضمن الفئة المجانية. تقول صفحة حدود المعدل من Google إنك تنتقل إلى خطة مدفوعة فقط بعد إعداد الفوترة في AI Studio.

هل تدرب Google على بياناتي من الفئة المجانية لـ Decisions API؟ تشير صفحة الأسعار من Google إلى "يُستخدم لتحسين منتجاتنا" بـ "نعم" للفئة المجانية و"لا" للمدفوعة. تعامل مع المفاتيح المجانية على أنها غير مناسبة للبيانات الحساسة.

لماذا أواجه أخطاء 429 رغم أنني أقل بكثير من 200 طلب في الدقيقة؟ على الأرجح أنك تجاوزت 50,000 رمز في الدقيقة. مدخلات الصور والصوت وPDF تستهلك رموزًا كثيرة، لذا يصبح TPM هو المحدد قبل RPM عادةً. سجّل usage.total_input_tokens واضبط إيقاع الطلبات بقسمة 50,000 على هذا الرقم.

هل يوجد نموذج Gemini Decision 1 مجاني على OpenRouter؟ لا، حتى تاريخ 12 نوفمبر 2026. تعرض OpenRouter النموذج google/gemini-decision-1 بسعر $0.10 لكل مليون رمز مدخلات و$0 للمخرجات، دون أي نسخة :free.

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