Gemini Decisions API: كيف تعمل وقرار Gemini الأول وما هي أسعاره

تُعدّ واجهة Gemini Decisions API نقطة نهاية جديدة من Google تجيب عن الأسئلة المغلقة بدلاً من توليد النصوص. ترسل مُدخلًا واحدًا مشتركًا (نص أو صور أو صوت أو فيديو أو PDF) مع ما يصل إلى 1,000 سؤال مُنظَّم، ويعيد Gemini Decision 1 (gemini-decision-1) احتمالًا مُعايرًا ودرجة ثقة لكل سؤال. تكلفتها 0.10 دولار لكل مليون رمز مُدخل، والمخرجات دائمًا صفر رموز، وتذكر Google زمن استجابة يتراوح بين 150 و250 مللي ثركة من البداية إلى النهاية.

أطلقت Google الخدمة في 11 نوفمبر 2026 كنقطة نهاية v1beta. للاطلاع على تجربة عملية لبناء التكامل، راجع مقال كيفية استخدام واجهة Gemini Decisions API.

ما الذي قدّمته Google مع Gemini Decision 1

‏Gemini Decision 1 هو نموذج يقيّم مجموعة ثابتة من الإجابات المرشحة في تمريرة أمامية واحدة بدلاً من توليد النص رمزًا تلو الآخر. وتُتيح واجهة Decisions API الوصول إليه، فيحصل كودك على أرقام يمكنه التفرّع بناءً عليها.

يسرد منشور الإطلاق، «Gemini Decisions API: قرارات متعددة الوسائط سريعة ومعايرة»، الحقائق الرئيسية:

• معرّف النموذج gemini-decision-1، متاح عبر Gemini API وGoogle AI Studio
• مُدخل واحد متعدد الوسائط لكل طلب، بنافذة سياق تبلغ 262,144 رمزًا مشتركة بين المُدخل وجميع الأسئلة
• من 1 إلى 1,000 سؤال مستقل لكل طلب، من ثلاثة أنواع: noul وchoice وscore
• 0.10 دولار لكل مليون رمز مُدخل، و0 دولار للمخرجات، مع طبقة مجانية للنماذج الأولية
• دعم حزم التطوير البرمجية في google-genai الإصدار 3.2 أو أحدث (client.decisions.create(...))، مع تكاملات قيد الإطلاق مع OpenRouter وLangChain وVercel AI SDK وLiteLLM

دعم Gemini في Google Cloud (Vertex AI) مُدرج على أنه «قريبًا»، لذا تعمل الخدمة حاليًا على واجهة Developer API فقط.

لماذا نقطة نهاية للقرارات بدلاً من استدعاء دردشة

معظم أكواد «صنّف هذا» تستدعي نموذجًا توليديًا، وتطلب JSON ثم تحلل الرد. تدفع ثمن رموز المخرجات والتفكير، وينهار المحلل عندما يصبح النموذج مبدعًا في صياغة الرد.

تُلغي واجهة Decisions API خطوة التوليد. وتوضح وثائق Google ذلك بوضوح: فهي «تولّد صفر رمز نصي، لذا يكون استخدام رموز المخرجات دائمًا 0». وينتج عن ذلك ثلاث قرارات تصميمية:

1. تقييم متوازٍ ومعزول. يُنفَّذ كل سؤال مقابل المُدخل المشترك في تمريرة واحدة. لا يمكن للأسئلة أن ترى بعضها، فإضافة سؤال أو إزالته لا تؤثر على إجابات الأسئلة الأخرى.
2. قيمة مع ثقة. تخبر القيمة كودك بما يجب فعله. وتخبره الثقة ما إذا كان ينبغي تنفيذ ذلك تلقائيًا أو تصعيده لمراجعة بشرية.
3. فحوصات ذرية تُركَّب في الكود. تطرح أسئلة ضيقة النطاق وتجمع الإجابات بجُمل if وأوزان عادية.

ولتوليد النصوص، أو الاستخراج وفق مخطط محدد، أو استدعاءات الأدوات، أو الاستدلال متعدد الخطوات، لا يزال Google يحوّلك إلى واجهة Interactions API.

أنواع الأسئلة الثلاثة

يتضمن كل سؤال type وinstructions، ولنوعين منها criteria. لا يرى النموذج مفتاح أسئلتك أبدًا، لذا اكتب السؤال كاملًا في instructions.

هناك بعض السلوكيات التي يُستحسن معرفتها قبل كتابة حدود القرار لديك:

• لا يصل noul أبدًا إلى 0 أو 1. تبقى الاحتمالات بين 0.01 و0.99، فالتحقق من «أعلى من 0.99» لن يتحقق أبدًا.
• تُفرز مفاتيح choice أبجديًا قبل التقييم، لذا استخدم مفتاحًا شاملًا مثل other، وليس none_of_the_above الذي يُفرز في المقدمة.
• توزّع choice الاحتمال دائمًا عبر خياراتك، حتى عندما لا يناسب أيٌّ منها. اقرنها بفحص نطاق من نوع noul أو بحد على درجة الثقة.
• ‏score هو متوسط مرجّح لمؤشرات المستويات، فالقيمة 1.12 تعني «المستوى 1 في الغالب، مع بعض المستوى 2».

تُعرَّف الثقة بالطريقة نفسها في كل مكان: احتمال النتيجة الأعلى، أو max(noul, 1 - noul) للأسئلة بنعم/لا.

مثال لطلب والرد الناتج عنه

نقطة نهاية REST هي POST https://generativelanguage.googleapis.com/v1beta/decisions، وتُصادَق باستخدام الترويسة x-goog-api-key. يطرح هذا الطلب سؤال نعم/لا وسؤال اختيار حول رسالة دعم واحدة:

curl -X POST "https://generativelanguage.googleapis.com/v1beta/decisions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-decision-1",
    "input": "Audio cuts out on the left earcup. Fix it today or I cancel my membership.",
    "questions": {
      "is_defect": {
        "type": "noul",
        "instructions": "Does the message describe a hardware defect?"
      },
      "department": {
        "type": "choice",
        "instructions": "Which department should handle this request?",
        "criteria": {
          "billing": "Payments, invoices, and refunds.",
          "technical": "Problems using the product.",
          "shipping": "Delivery and tracking.",
          "other": "Anything outside these categories."
        }
      }
    }
  }'

يتضمن الرد حقلين رئيسيين: answers (مفاتيحه هي معرّفات أسئلتك) وusage:

{
  "answers": {
    "is_defect": { "type": "noul", "noul": 0.94, "confidence": 0.94 },
    "department": {
      "type": "choice",
      "choice": "technical",
      "probabilities": { "technical": 0.9, "other": 0.05, "billing": 0.03, "shipping": 0.02 },
      "confidence": 0.9
    }
  },
  "usage": { "total_input_tokens": 120, "total_output_tokens": 0, "total_tokens": 120 }
}

الأرقام هنا توضيحية، ومُصاغة مثل الأمثلة في وثائق واجهة Decisions API من Google.

للمُدخلات غير النصية، يصبح input مصفوفة من كتل المحتوى باستخدام المخطط نفسه المعتمد في واجهة Interactions API: text وimage وaudio وvideo وdocument (‏PDF). يمكن تضمين الوسائط بشكل مباشر بترميز base64 (حتى 100 ميغابايت لكل طلب)، أو عبر عنوان URI من Files API، أو عبر رابط HTTPS (حتى 15 ميغابايت لكل عنصر). وتقبل كتل الصور والفيديو إعداد resolution لموازنة مستوى التفاصيل مقابل عدد الرموز.

إذا حجب فلتر أمان المُدخلات الطلب، فستتلقى HTTP 400 مع error.code مثل safety أو prohibited_content بدلاً من answers.

تسعير واجهة Gemini Decisions API وزمن الاستجابة وحدود المعدل

التسعير يعتمد على المُدخل فقط: 0.10 دولار لكل مليون رمز مُدخل في الطبقة المدفوعة، ومجانًا في الطبقة المجانية، ولا يوجد بند للمخرجات لأن المخرجات دائمًا 0 رمز. وذلك من صفحة تسعير Gemini Developer API من Google، وتم التحقق منها في 12 نوفمبر 2026. تُنبّه الصفحة نفسها إلى أن محتوى الطبقة المجانية يُستخدم لتحسين منتجات Google، بينما لا يُستخدم محتوى الطبقة المدفوعة لذلك.

تفصيلان في الفوترة يهمّان:

• يُحتسب المُدخل المشترك مرة واحدة لكل طلب، مهما كان عدد الأسئلة. يضيف كل سؤال رموز تعليماته ومعاييره فقط.
• لا يوجد تخزين مؤقت للسياق، ولا Batch API، ولا استدلال Flex/Priority لهذه النقطة، لذا فإن المُدخل نفسه المُرسل في طلبين يُحتسب مرتين.

حساب تقريبي: تذكرة دعم بحجم 2,000 رمز مع 20 سؤالًا بحوالي 40 رمزًا لكل منها تعطي نحو 2,800 رمز مُدخل، أي ما يقارب 0.00028 دولار لكل استدعاء قرار في الطبقة المدفوعة.

أرقام زمن الاستجابة من Google نفسها: وسيط 50 إلى 100 مللي ثانية من حوسبة النموذج، و150 إلى 250 مللي ثانية من البداية إلى النهاية، مع بقاء الزمن شبه ثابت من 1 إلى 100 سؤال للمُدخلات حتى 16 ألف رمز. وتدّعي Google أيضًا أدنى خطأ معايرة في مجموعة معاييرها القياسية، وتكلفة أدنى بنحو 5 أضعاف مقارنة بـ Gemini 3.5 Flash-Lite عبر واجهة Interactions API. تعامل مع كلا الرقمين كأرقام من المورّد حتى تقيس حركة مرورك بنفسك.

حدود المعدل من صفحة حدود المعدل على Google، تم التحقق منها في 12 نوفمبر 2026:

تُغطى الطبقة المجانية بالتفصيل في مقال استخدام Gemini Decisions API مجانًا.

أين تناسب واجهة Decisions API

تذكر وثائق Google خمسة أنماط استخدام، وتطبّقها فرقها الداخلية عليها:

• توجيه النماذج. يوجّه Gemini Notebook الاستعلامات إلى طبقة نموذج ومستوى تفكير، بانخفاض في زمن الاستجابة يصل إلى 40% على الاستعلامات اليومية، وفق Google.
• فحوصات السياسات. تطبيق قواعد عديدة على مُدخل واحد في استدعاء واحد؛ يستخدمه Google Search كطبقة أمان لأدوات MCP.
• التحكم في الوكلاء. تحديد الأدوات التي يجب تحميلها، أو ما إذا كان ينبغي الضغط، أو التصعيد، أو التوقف.
• التقييم والترتيب. إعطاء درجات للمرشحين أو المقاطع المسترجعة وفق معايير محددة.
• الوسائط في الوقت الفعلي. يختار CC من Google Labs رمز تعبير (emoji) من بين أكثر من 200 خيار.

تنصح Google بتحديد حد الثقة هذا انطلاقًا من أمثلة مُصنَّفة مأخوذة من حركة مرورك الخاصة، مع موازنة تكلفة النتيجة الإيجابية الخاطئة مقابل السلبية الخاطئة.

أطلقت OpenAI نقطة نهاية مشابهة في أكتوبر على GPT-6 Luna، بأسئلة من أنواع predicate وchoice وscore؛ ويغطي ذلك مقالنا شرح واجهة OpenAI Decisions API. أما المقارنة المباشرة بين الاثنين من حيث الحدود والوسائط والتسعير فتجدها في مقارنة Gemini Decisions API مقابل OpenAI Decisions API.

الحدود والأسئلة المفتوحة

ما تذكره الوثائق حاليًا:

• v1beta على واجهة Gemini Developer API، مع نموذج Gemini Decision 1 فقط
• تعليمات الأسئلة نصية فقط؛ لا يُدعم تضمين الوسائط في الأسئلة
• سجل المحادثة، وكتل التفكير، وكتل استدعاء الأدوات ليست مُدخلات صالحة؛ حوّل سياق المحادثات متعددة الأدوار إلى نص

لم تُعلن Google بعد عن تاريخ الإتاحة العامة (GA) أو المناطق أو شروط إقامة البيانات. كما تحذّر من أن نص المستخدم يمكنه أن يجادل لصالح تصنيف نفسه، لذا أبقِ فحصًا بشريًا على الإجراءات عالية المخاطر مثل صرف المدفوعات.

دع وكيل البرمجة الخاص بك يختبرها عبر Apidog CLI

لا تُعد نقطة نهاية القرارات مفيدة إلا إذا بقي عقد الواجهة قائمًا: كل درجة ثقة بين 0 و1، وكل choice ضمن مجموعة خياراتك. يستطيع وكيل البرمجة الخاص بك كتابة اختبار الانحدار هذا وتشغيله باستخدام Apidog CLI بينما تواصل عملك.

نفّذ الإعداد مرة واحدة:

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

ثم امنح وكيلك تعليمات واحدة:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Define POST /v1beta/decisions with header x-goog-api-key: {{GEMINI_API_KEY}}
and the support-ticket body from this article. Add a test case asserting:
status 200, usage.total_output_tokens == 0, every answers.*.confidence is
between 0 and 1, answers.department.choice is one of billing|technical|shipping|other,
and answers.is_defect.noul is between 0.01 and 0.99. Run it and summarize failures.

يتحقق الوكيل من صحة كل حمولة وفق مخططها، ثم ينشئ الحالة ويشغّلها:

apidog environment create gemini --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get environment-update
apidog environment update <envId> --project <projectId> --file env.json
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <projectId> --file decisions-endpoint.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file decisions-case.json
apidog test-case create --project <projectId> --file decisions-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

لإبقاء المفتاح خارج البيئة المحفوظة، مرّره وقت التشغيل باستخدام --env-var "GEMINI_API_KEY=..." بدلاً من ذلك. ويمكن استخدام الأمر نفسه apidog run مع -r junit في أنظمة CI؛ إذ يعرض مرجع أمر apidog run جميع الخيارات، ويوضح مقال استخدام Apidog CLI في Claude Code إعداد الوكيل كاملًا. تغطي الخطة المجانية من Apidog حتى 4 مستخدمين.

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

هل واجهة Gemini Decisions API مجانية؟ نعم، ضمن الطبقة المجانية: 200 طلب في الدقيقة، و50,000 رمز في الدقيقة، و10,000 طلب في اليوم. أما الاستخدام المدفوع فتكلفته 0.10 دولار لكل مليون رمز مُدخل.

كم سؤالًا يمكنني طرحها في طلب واحد؟ من 1 إلى 1,000، ويتحدد ذلك بنافذة السياق البالغة 262,144 رمزًا المشتركة بين المُدخل وكل سؤال.

ماذا يعني noul؟ إنه نوع الأسئلة بنعم/لا. يعيد احتمال أن تكون الإجابة نعم، بين 0.01 و0.99، بالإضافة إلى درجة ثقة.

هل يمكن استخدامها على Vertex AI؟ ليس بعد. تُدرج Google دعم Gemini في Google Cloud على أنه قريبًا؛ وهي حاليًا متاحة على واجهة Gemini Developer API (v1beta).

هل تدعم المعالجة الدفعية أو التخزين المؤقت للسياق؟ لا. لا يُدعم التخزين المؤقت للسياق ولا Batch API ولا استدلال Flex أو Priority، لذا يُحتسب المُدخل المتكرر بكامل قيمته.