{ "aboutHtml": "

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

تعطي بطاقة النموذج المحددة حد إدخال يبلغ 1,048,576 رمزًا وحد إخراج يبلغ 65,536 رمزًا. خطط للمصدر والنتيجة، كلًّا منهما على حدة: لا يمكن استيعاب مقتطف طويل من مستودع أو مجموعة مستندات أو تسجيل إلا عندما يتسع حد الإدخال لتمثيله المعالَج وتعليماته، وتظل الإجابة بحاجة إلى طول مخصص لها. ضع تسميات للمصادر المرتبطة وحدّد المادة المعتمدة. ولمطالبة طويلة، يوصي دليل المطور بوضع السؤال المحدد بعد البيانات وربطه صراحة بالمعلومات السابقة.

التفكير ديناميكي، والمستوى high هو الافتراضي الموثق لهذا النموذج. المستويات المدعومة هي minimal وlow وmedium وhigh. وهي حصص استدلال نسبية وليست أعداد رموز مضمونة. قد يظل minimal متضمنًا بعض الاستدلال في مشكلة برمجية صعبة. اختر المستوى بحسب المهمة: يحتاج تحويل قصير ومشكلة تصحيح أخطاء متعددة الشروط إلى معالجة مختلفة. استخدم تعليمات مباشرة وواضحة بدلًا من فرض طقوس استدلال معقدة داخل المطالبة؛ واطلب المادة النهائية والفحوص التي تجعلها قابلة للاستخدام.

تسرد بطاقة الشركة المنتجة المخرجات المنظَّمة واستدعاء الدوال وتنفيذ الشيفرة واستخدام الحاسوب والبحث في الملفات وإسناد الإجابات إلى البحث وإلى Google Maps وسياق URL والتخزين المؤقت. يمكن الجمع بين الأدوات المدمجة واستدعاء الدوال المخصصة ضمن مسار Gemini 3 الموثق. يعرّف التطبيق الدوال، ويفحص وسائطها، وينفذ الإجراءات المقبولة، ويرسل نتائجها. ولمساعد برمجي، تستطيع أداة قراءة ملفات أو مشغّل اختبارات مضبوط توفير أدلة ملموسة للخطوة التالية. ينبغي أن يظل الإجراء المقترح ونتيجة الأداة الملحوظة متميزين في التقرير النهائي.

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

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

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

لا يعلن النموذج النصي عن توليد صور أو صوت أو دعم Live API. ويميز الدليل أيضًا بين الفهم المرئي وتجزئة الصور على مستوى البكسل، وهي ليست قدرة مدعومة في Gemini 3 Flash. استخدم نتيجة نهائية مناسبة للمهمة الفعلية: ملاحظات مرتبطة بالمصادر، أو سجل منظَّم، أو تغيير برمجي، أو قرار تُذكر افتراضاته. افحص العمليات الحسابية، وتحقق من الشيفرة في البيئة المقصودة، وراجع معلومات الأدوات المعادة. وعندما تكون الحقائق الحديثة مهمة، استخدم مصادر الإسناد المهيأة أو البيانات الراهنة المقدمة بدلًا من افتراض أن معرفة النموذج قاعدة بيانات حية.

", "aboutText": "Gemini 3 Flash Preview هو نموذج استدلال من Google للفهم متعدد الوسائط والبرمجة ومهام الوكلاء. يقبل النصوص والصور والفيديو والصوت وPDF ويعيد نصًا. ولذلك يمكن للطلب أن يجمع التعليمات المكتوبة وملفات المصدر والملاحظات المرئية وسجل المحادثة حول مشكلة واحدة. قد تكون النتيجة شرحًا أو مقترح شيفرة أو بيانات مستخرجة أو خطة مستندة إلى تلك المواد، بدلًا من صورة مولدة أو استجابة منطوقة.\n\nتعطي بطاقة النموذج المحددة حد إدخال يبلغ 1,048,576 رمزًا وحد إخراج يبلغ 65,536 رمزًا. خطط للمصدر والنتيجة، كلًّا منهما على حدة: لا يمكن استيعاب مقتطف طويل من مستودع أو مجموعة مستندات أو تسجيل إلا عندما يتسع حد الإدخال لتمثيله المعالَج وتعليماته، وتظل الإجابة بحاجة إلى طول مخصص لها. ضع تسميات للمصادر المرتبطة وحدّد المادة المعتمدة. ولمطالبة طويلة، يوصي دليل المطور بوضع السؤال المحدد بعد البيانات وربطه صراحة بالمعلومات السابقة.\n\nالتفكير ديناميكي، والمستوى high هو الافتراضي الموثق لهذا النموذج. المستويات المدعومة هي minimal وlow وmedium وhigh. وهي حصص استدلال نسبية وليست أعداد رموز مضمونة. قد يظل minimal متضمنًا بعض الاستدلال في مشكلة برمجية صعبة. اختر المستوى بحسب المهمة: يحتاج تحويل قصير ومشكلة تصحيح أخطاء متعددة الشروط إلى معالجة مختلفة. استخدم تعليمات مباشرة وواضحة بدلًا من فرض طقوس استدلال معقدة داخل المطالبة؛ واطلب المادة النهائية والفحوص التي تجعلها قابلة للاستخدام.\n\nتسرد بطاقة الشركة المنتجة المخرجات المنظَّمة واستدعاء الدوال وتنفيذ الشيفرة واستخدام الحاسوب والبحث في الملفات وإسناد الإجابات إلى البحث وإلى Google Maps وسياق URL والتخزين المؤقت. يمكن الجمع بين الأدوات المدمجة واستدعاء الدوال المخصصة ضمن مسار Gemini 3 الموثق. يعرّف التطبيق الدوال، ويفحص وسائطها، وينفذ الإجراءات المقبولة، ويرسل نتائجها. ولمساعد برمجي، تستطيع أداة قراءة ملفات أو مشغّل اختبارات مضبوط توفير أدلة ملموسة للخطوة التالية. ينبغي أن يظل الإجراء المقترح ونتيجة الأداة الملحوظة متميزين في التقرير النهائي.\n\nللبرمجة، قدّم الملفات ذات الصلة واللغة والسلوك المتوقع ومدخلًا يوضح المشكلة. حدّد نطاق التغيير وسمِّ الواجهة أو السلوك الذي يجب الحفاظ عليه. اطلب تنفيذًا معدلًا والحالات التي ينبغي فحصها. ولمهمة مستندية تحليلية، عرّف السؤال والحقول المطلوبة والمراجع المصدرية. وإذا استُخدمت مخرجات منظَّمة، فقدّم مخططًا ذا معانٍ واضحة للحقول وقواعد للقيم المفقودة. تحقق من صحة بنيته ومن أن كل قيمة تستند إلى المادة الأصلية.\n\nللتحليل متعدد الوسائط، حدّد ما يهم في كل مصدر. يمكن للقطة شاشة دعم شرح واجهة، ولـPDF توفير جدول أو مخطط، ولتسجيل تقديم أحداث منطوقة أو مرئية. يناقش دليل المطور عناصر التحكم في دقة الوسائط لأن التفاصيل تغير التمثيل المعالَج واستخدام الرموز. يستطيع مسار تنفيذ الشيفرة لدى الشركة المنتجة قص الصور المقدمة أو تكبيرها وإجراء حسابات من البيانات المرئية وإضافة تعليقات توضيحية قبل أن يعد النموذج إجابته. قد تتطلب قراءة نص صغير إعدادًا مختلفًا عن وصف مشهد عام. أبقِ الصفحة أو الصورة أو المقطع المعني متاحًا للتحقق من الملاحظات، بدلًا من اعتبار ملخص سلس دليلًا على قراءة كل تفصيل بصورة صحيحة.\n\nيجب الاحتفاظ بحالة المحادثة والأدوات في الواجهة المختارة. يستخدم Gemini 3 توقيعات التفكير لنقل سياق الاستدلال بين الاستدعاءات؛ ويميز دليل المطور بين السجل ذي الحالة المُدار والسجل عديم الحالة المُدار يدويًا. حافظ على السياق المطلوب عند متابعة مهمة بأداة أو تعديل نتيجة. توصي Google أيضًا بالإبقاء على درجة الحرارة الافتراضية 1.0 بدلًا من استيراد وصفة بدرجة حرارة منخفضة قد تسبب حلقات تكرار أو تراجعًا في السلوك في المهام المعقدة. هذه ممارسات تكامل لدى الشركة المنتجة، وليست ادعاءات جديدة بشأن آلية النقل في تطبيق معين.\n\nلا يعلن النموذج النصي عن توليد صور أو صوت أو دعم Live API. ويميز الدليل أيضًا بين الفهم المرئي وتجزئة الصور على مستوى البكسل، وهي ليست قدرة مدعومة في Gemini 3 Flash. استخدم نتيجة نهائية مناسبة للمهمة الفعلية: ملاحظات مرتبطة بالمصادر، أو سجل منظَّم، أو تغيير برمجي، أو قرار تُذكر افتراضاته. افحص العمليات الحسابية، وتحقق من الشيفرة في البيئة المقصودة، وراجع معلومات الأدوات المعادة. وعندما تكون الحقائق الحديثة مهمة، استخدم مصادر الإسناد المهيأة أو البيانات الراهنة المقدمة بدلًا من افتراض أن معرفة النموذج قاعدة بيانات حية.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "52f81a4f9e960bbc15082b72e8054bad790b3a89f14779689a3430ca5f4ca431", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
G

Google: Gemini 3 Flash Preview (batch)

Google /google/gemini-3-flash-preview:batch

البداية

يجمع Gemini 3 Flash Preview بين الفهم متعدد الوسائط والاستدلال مع مخرجات نصية. يدعم تحليل الشيفرة والمستندات والمواد المرئية والنتائج المنظَّمة ومسارات العمل المتمحورة حول الأدوات، مع أربعة مستويات تفكير موثقة لاختيار عمق التحليل.

المدخلات المقبولة
النص
النتائج
النص
عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

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

تعطي بطاقة النموذج المحددة حد إدخال يبلغ 1,048,576 رمزًا وحد إخراج يبلغ 65,536 رمزًا. خطط للمصدر والنتيجة، كلًّا منهما على حدة: لا يمكن استيعاب مقتطف طويل من مستودع أو مجموعة مستندات أو تسجيل إلا عندما يتسع حد الإدخال لتمثيله المعالَج وتعليماته، وتظل الإجابة بحاجة إلى طول مخصص لها. ضع تسميات للمصادر المرتبطة وحدّد المادة المعتمدة. ولمطالبة طويلة، يوصي دليل المطور بوضع السؤال المحدد بعد البيانات وربطه صراحة بالمعلومات السابقة.

التفكير ديناميكي، والمستوى high هو الافتراضي الموثق لهذا النموذج. المستويات المدعومة هي minimal وlow وmedium وhigh. وهي حصص استدلال نسبية وليست أعداد رموز مضمونة. قد يظل minimal متضمنًا بعض الاستدلال في مشكلة برمجية صعبة. اختر المستوى بحسب المهمة: يحتاج تحويل قصير ومشكلة تصحيح أخطاء متعددة الشروط إلى معالجة مختلفة. استخدم تعليمات مباشرة وواضحة بدلًا من فرض طقوس استدلال معقدة داخل المطالبة؛ واطلب المادة النهائية والفحوص التي تجعلها قابلة للاستخدام.

تسرد بطاقة الشركة المنتجة المخرجات المنظَّمة واستدعاء الدوال وتنفيذ الشيفرة واستخدام الحاسوب والبحث في الملفات وإسناد الإجابات إلى البحث وإلى Google Maps وسياق URL والتخزين المؤقت. يمكن الجمع بين الأدوات المدمجة واستدعاء الدوال المخصصة ضمن مسار Gemini 3 الموثق. يعرّف التطبيق الدوال، ويفحص وسائطها، وينفذ الإجراءات المقبولة، ويرسل نتائجها. ولمساعد برمجي، تستطيع أداة قراءة ملفات أو مشغّل اختبارات مضبوط توفير أدلة ملموسة للخطوة التالية. ينبغي أن يظل الإجراء المقترح ونتيجة الأداة الملحوظة متميزين في التقرير النهائي.

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

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

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

لا يعلن النموذج النصي عن توليد صور أو صوت أو دعم Live API. ويميز الدليل أيضًا بين الفهم المرئي وتجزئة الصور على مستوى البكسل، وهي ليست قدرة مدعومة في Gemini 3 Flash. استخدم نتيجة نهائية مناسبة للمهمة الفعلية: ملاحظات مرتبطة بالمصادر، أو سجل منظَّم، أو تغيير برمجي، أو قرار تُذكر افتراضاته. افحص العمليات الحسابية، وتحقق من الشيفرة في البيئة المقصودة، وراجع معلومات الأدوات المعادة. وعندما تكون الحقائق الحديثة مهمة، استخدم مصادر الإسناد المهيأة أو البيانات الراهنة المقدمة بدلًا من افتراض أن معرفة النموذج قاعدة بيانات حية.

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · المعالجة الدفعية POST /v1/batches
الإدخال
text
الإخراج
text
صيغة الإخراج
محتوى JSON مضمّن في results[].response.body
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلendpointالنوعstringالمتطلبمطلوبالقيم والحدود
/v1/chat/completions
القيمة الافتراضية—
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
google/gemini-3-flash-preview:batch
القيمة الافتراضية—
الحقلrequestsالنوعbatch_item[]المتطلبمطلوبالقيم والحدود
الحد الأدنى للعناصر: ⁦1⁩
القيمة الافتراضية—
الحقلrequests[].custom_idالنوعstringالمتطلبمطلوبالقيم والحدودالقيمة الافتراضية—
الحقلrequests[].body.messagesالنوعmessage[]المتطلبمطلوبالقيم والحدودالقيمة الافتراضية—
الحقلcompletion_windowالنوعstringالمتطلباختياريالقيم والحدود
24h
القيمة الافتراضية—
الحقلproviderالنوعobject|nullالمتطلباختياريالقيم والحدودالقيمة الافتراضية—
الحقلrequests[].body.modelالنوعstringالمتطلباختياريالقيم والحدود
google/gemini-3-flash-preview:batch, google/gemini-3-flash-preview
القيمة الافتراضية—
الحقلprovider.onlyالنوعstring[]المتطلباختياريالقيم والحدود
google-vertex/global
القيمة الافتراضية—
الحقلprovider.allow_fallbacksالنوعboolean|nullالمتطلباختياريالقيم والحدود
false, null
القيمة الافتراضية—
معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتendpoint, model, requests
المعلمةmaterial_typesالمواصفاتtext
المعلمةrepresentationالمواصفاتطلبات requests[] مضمّنة؛ يحتوي كل عنصر على custom_id وbody
المعلمةrequest_endpoint_profileالمواصفات/v1/chat/completions
المعلمةfile_materialالمواصفاتيمكن للمستدعي قراءة محتوى JSONL الفعلي بترميز UTF-8 محليًا إلى requests[]. لا يُستخدم غرض للرفع ولا input_file_id ولا مرجع إلى ملف. إذا كانت مواد العميل مفقودة أو فارغة، يتوقف التحضير قبل POST.
المعلمةserialization_orderالمواصفاتendpoint, model, provider (إذا تم توفيره), completion_window (إذا تم توفيره), requests في النهاية
المعلمةoptional_controlsالمواصفاتprovider.only, provider.allow_fallbacks, completion_window
المعلمةschema_scopeالمواصفاتأجسام طلبات Text Chat Completions ضمن غلاف Batch المضمّن الموثّق.

دورة الحياة: asynchronous

GET /v1/batches/{operation_id} · قيمة response.id الفعلية من استجابة الإنشاء الأصلية؛ مع المستخدم والمفتاح والمجموعة نفسها

الباقات

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
غير محدد عند اختيار الوضع السريع
الوضع المرن
غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال
غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تسعير التخزين المؤقت الصريح
غير مفعّل عند طلب التخزين المؤقت الصريح

تعرفات Ailoot

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعداداتجدول التعرفةرموز السياق، أكثر منرموز السياق، حتى القيمة شاملةًالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةرموز السياق، أكثر من—رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصىالرسوم
الإدخال · رموز الإدخال $0.0005 / 1K من الرموز
الإخراج · رموز الإخراج $0.003 / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز
الإعداداتالشريحة 1 لطول الطلبجدول التعرفة—رموز السياق، أكثر من⁦0⁩رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصىالرسوم
الإدخال · رموز الإدخال $0.0005 / 1K من الرموز
الإخراج · رموز الإخراج $0.003 / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · المعالجة الدفعية

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3-flash-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n

استلام النتائج وحفظها

Ailoot Ultra · المعالجة الدفعية

محتوى JSON مضمّن في results[].response.body

التحقق من حالة المهمة
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\n
الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

احتفظ بمحتوى JSON الكامل للحالة الأصلية، وبكل نتيجة وcustom_id، وبجسم الاستجابة أو الخطأ كاملًا. احفظ results[] المكتملة بصيغة JSONL دون تصفية.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بمعرّف العملية الأصلي. تتضمن الاستجابة 503 result_pending_check الترويسة X-Should-Retry:false؛ لا تُعِد إرسال الدفعة الأصلية التي لا تُعرف نتيجتها مطلقًا.

حقول الاستجابة
الحقلالنوع
الحقلresults[].custom_idالنوعstring
الحقلresults[].response.body.choices[].message.contentالنوعstring|null
الحقلresults[].errorالنوعobject|null
الحقلusageالنوعobject|null
الحقلidالنوعstring
الحقلmodelالنوعstring
الحقلendpointالنوعstring
الحقلstatusالنوعstring
الحقلrequest_countsالنوعobject
الحقلresults[].idالنوعstring
الحقلresults[].response.status_codeالنوعinteger
الحقلresults[].response.request_idالنوعstring
الأخطاء والخطوات التالية
الاستجابةالشرطالخطوة التالية
الاستجابة⁦400⁩ · invalid_request_errorالشرطالغلاف المضمّن الموثّق غير صالح، أو توجد مفاتيح مكررة أو مشكلة في هوية العناصر، أو تعارض مع قدرات النموذج المضبوطة.الخطوة التاليةصحح الحقول المحددة قبل أي إرسال جديد.
الاستجابة⁦401⁩ · authentication_errorالشرطمفتاح API غير صالح.الخطوة التاليةاستخدم مفتاح Ailoot المصرّح به.
الاستجابة⁦403⁩ · permission_errorالشرطمجموعة المعالجة الدفعية غير متاحة.الخطوة التاليةتحقق من صلاحية الوصول الممنوحة للمفتاح والمجموعة.
الاستجابة⁦422⁩ · invalid_request_errorالشرطتستخدم المعالجة الدفعية الفوترة من الرصيد؛ ويُرفض إنشاؤها عبر الاشتراك.الخطوة التاليةاستخدم المجموعة المصرّح بها التي تُخصم رسومها من الرصيد.
الاستجابة⁦422⁩ · price_unavailableالشرطلا يمكن تقديم تقدير تكلفة لمدخلات المعالجة الدفعية.الخطوة التاليةاحتفظ بالاستجابة؛ واستخدم المدخلات الموثّقة لعائلة الواجهات.
الاستجابة⁦402⁩ · billing_errorالشرطحجز الرصيد للمعالجة الدفعية غير متاح.الخطوة التاليةعالج ما يمنع قبول الطلب قبل إرسال طلب جديد.
الاستجابة⁦503⁩ · price_unavailableالشرطسعر طريقة المعالجة الدفعية أو تعرفاتها الأصلية غير متاحة.الخطوة التاليةاحتفظ بالاستجابة؛ ولا تستبدل الأسعار.
الاستجابة⁦503⁩ · api_errorالشرطمسار المورّد المحدد غير متاح.الخطوة التاليةاحتفظ بالاستجابة لإصلاح المسار.
الاستجابة⁦503⁩ · result_pending_checkالشرطالنتيجة الأصلية تتطلب التحقق؛ X-Should-Retry:false.الخطوة التاليةاحتفظ بقيمة operation_id/id الأصلية واقرأ حالتها؛ ولا تُكرر POST الأصلي مطلقًا.
الاستجابة⁦404⁩ · not_foundالشرطعملية حالة المعالجة الدفعية غير موجودة أو مملوكة لهوية أخرى.الخطوة التاليةاستخدم id الأصلي كما هو، والمستخدم والمفتاح والمجموعة نفسها.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra google/gemini-3-flash-preview:batch

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

google/gemini-3-flash-preview:batch

", "method_identity": { "effective_request_model_id": "google/gemini-3-flash-preview:batch", "fmt": "batches", "http": "POST", "path": "/v1/batches", "request_model_id": "google/gemini-3-flash-preview:batch", "route_label": "Ultra" }, "method_key": "Ultra|batches|/v1/batches|google%2Fgemini-3-flash-preview%3Abatch", "ordinal": 0, "rawMethod": { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "الغلاف المضمّن الموثّق غير صالح، أو توجد مفاتيح مكررة أو مشكلة في هوية العناصر، أو تعارض مع قدرات النموذج المضبوطة.", "http_status": 400, "recovery": "صحح الحقول المحددة قبل أي إرسال جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "مفتاح API غير صالح.", "http_status": 401, "recovery": "استخدم مفتاح Ailoot المصرّح به.", "type": "authentication_error" }, { "code": null, "condition": "مجموعة المعالجة الدفعية غير متاحة.", "http_status": 403, "recovery": "تحقق من صلاحية الوصول الممنوحة للمفتاح والمجموعة.", "type": "permission_error" }, { "code": null, "condition": "تستخدم المعالجة الدفعية الفوترة من الرصيد؛ ويُرفض إنشاؤها عبر الاشتراك.", "http_status": 422, "recovery": "استخدم المجموعة المصرّح بها التي تُخصم رسومها من الرصيد.", "type": "invalid_request_error" }, { "code": null, "condition": "لا يمكن تقديم تقدير تكلفة لمدخلات المعالجة الدفعية.", "http_status": 422, "recovery": "احتفظ بالاستجابة؛ واستخدم المدخلات الموثّقة لعائلة الواجهات.", "type": "price_unavailable" }, { "code": null, "condition": "حجز الرصيد للمعالجة الدفعية غير متاح.", "http_status": 402, "recovery": "عالج ما يمنع قبول الطلب قبل إرسال طلب جديد.", "type": "billing_error" }, { "code": null, "condition": "سعر طريقة المعالجة الدفعية أو تعرفاتها الأصلية غير متاحة.", "http_status": 503, "recovery": "احتفظ بالاستجابة؛ ولا تستبدل الأسعار.", "type": "price_unavailable" }, { "code": null, "condition": "مسار المورّد المحدد غير متاح.", "http_status": 503, "recovery": "احتفظ بالاستجابة لإصلاح المسار.", "type": "api_error" }, { "code": "result_pending_check", "condition": "النتيجة الأصلية تتطلب التحقق؛ X-Should-Retry:false.", "http_status": 503, "recovery": "احتفظ بقيمة operation_id/id الأصلية واقرأ حالتها؛ ولا تُكرر POST الأصلي مطلقًا.", "type": null }, { "code": "not_found", "condition": "عملية حالة المعالجة الدفعية غير موجودة أو مملوكة لهوية أخرى.", "http_status": 404, "recovery": "استخدم id الأصلي كما هو، والمستخدم والمفتاح والمجموعة نفسها.", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "google/gemini-3-flash-preview:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "احتفظ بمحتوى JSON الكامل للحالة الأصلية، وبكل نتيجة وcustom_id، وبجسم الاستجابة أو الخطأ كاملًا. احفظ results[] المكتملة بصيغة JSONL دون تصفية.", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "محتوى JSON مضمّن في results[].response.body" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-3-flash-preview:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-3-flash-preview:batch", "google/gemini-3-flash-preview" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "google-vertex/global" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "google-vertex/global" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "google/gemini-3-flash-preview:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "google-vertex/global" ] ], "items": { "enum": [ "google-vertex/global" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "google/gemini-3-flash-preview:batch", "google/gemini-3-flash-preview" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "google/gemini-3-flash-preview:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "يمكن للمستدعي قراءة محتوى JSONL الفعلي بترميز UTF-8 محليًا إلى requests[]. لا يُستخدم غرض للرفع ولا input_file_id ولا مرجع إلى ملف. إذا كانت مواد العميل مفقودة أو فارغة، يتوقف التحضير قبل POST.", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "طلبات requests[] مضمّنة؛ يحتوي كل عنصر على custom_id وbody", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "أجسام طلبات Text Chat Completions ضمن غلاف Batch المضمّن الموثّق.", "serialization_order": [ "endpoint", "model", "provider (إذا تم توفيره)", "completion_window (إذا تم توفيره)", "requests في النهاية" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "قيمة response.id الفعلية من استجابة الإنشاء الأصلية؛ مع المستخدم والمفتاح والمجموعة نفسها", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "احتفظ بمعرّف العملية الأصلي. تتضمن الاستجابة 503 result_pending_check الترويسة X-Should-Retry:false؛ لا تُعِد إرسال الدفعة الأصلية التي لا تُعرف نتيجتها مطلقًا." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "التعرفات الأساسية للرموز", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "الشريحة 1 لطول الطلب", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{\"endpoint\":\"/v1/chat/completions\",\"model\":\"google/gemini-3-flash-preview:batch\",\"requests\":[{\"custom_id\":\"req-0001\",\"body\":{\"messages\":[{\"role\":\"user\",\"content\":\"Hello!\"}],\"max_tokens\":16}}]}')\nPath(\"batch-request.json\").write_text(json.dumps(body,ensure_ascii=False),encoding=\"utf-8\")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError(\"Customer JSONL file is missing\")\n items = [json.loads(line) for line in path.read_text(encoding=\"utf-8\").splitlines() if line.strip()]\n if not items: raise ValueError(\"Customer JSONL contains no requests\")\n ids = set()\n for item in items:\n if set(item) != {\"custom_id\", \"body\"}: raise ValueError(\"Each item needs custom_id and body\")\n cid = item[\"custom_id\"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError(\"custom_id must be nonempty and unique\")\n ids.add(cid)\n if not isinstance(item[\"body\"], dict) or not item[\"body\"].get(\"messages\"): raise ValueError(\"Supply actual text messages\")\n supplied_model = item[\"body\"].get(\"model\")\n if supplied_model is not None and supplied_model not in ['google/gemini-3-flash-preview:batch', 'google/gemini-3-flash-preview']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"google/gemini-3-flash-preview:batch\", \"requests\":items}\n\nif __name__ == \"__main__\":\n material = os.environ.get(\"AILOOT_BATCH_REQUESTS_JSONL\", \"\")\n if not material: raise SystemExit(\"Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file\")\n body = prepare_requests(material)\n key = os.environ.get(\"AILOOT_API_KEY\", \"\")\n if not key: raise SystemExit(\"Set AILOOT_API_KEY\")\n request = Request(\"https://api.ailoot.ai/v1/batches\", data=json.dumps(body, ensure_ascii=False).encode(\"utf-8\"), headers={\"Authorization\":\"Bearer \" + key, \"Content-Type\":\"application/json\"}, method=\"POST\")\n with urlopen(request) as response:\n raw = response.read()\n Path(\"batch-create-response.json\").write_bytes(raw)\n print(raw.decode(\"utf-8\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nBATCH_OPERATION_ID=\"$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path(\"batch-create-response.json\").read_text(encoding=\"utf-8\"))\noperation = response.get(\"id\")\nif not isinstance(operation, str) or not operation: raise SystemExit(\"No actual original operation ID; preserve the response and do not resubmit\")\nprint(quote(operation, safe=\"\"))\nPY_ID\n)\"\ncurl --fail-with-body --silent --show-error \"https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -o batch-status-response.json\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import json\nfrom pathlib import Path\nraw = Path(\"batch-status-response.json\").read_bytes()\nresponse = json.loads(raw)\nif response.get(\"status\") != \"completed\":\n raise SystemExit(\"Keep the original operation; read its status without resubmitting\")\nresults = response.get(\"results\")\nif not isinstance(results, list) or not results:\n raise SystemExit(\"Preserve the original response; completed results are missing\")\nPath(\"batch-results.jsonl\").write_text(\"\".join(json.dumps(item, ensure_ascii=False) + \"\\n\" for item in results), encoding=\"utf-8\")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 0.5, "input": [ "text" ], "label": "المعالجة الدفعية", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 3, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "google/gemini-3-flash-preview:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": null, "cache_read_multiplier": null, "cache_write": null, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 0.5, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 3, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } } ], "model_id": "google/gemini-3-flash-preview:batch", "nativeProvenance": { "input_facts_canonical_sha256": "a5098882e8531bcf509c70da2908e58de4a9bfc0d3fddd2f4c1e66d614f0abaf", "input_html_sha256": "9315e975740665c0dde9c9f6eaa7dc358ce2f3fd75737fe1ff70b82d95602f8e", "private_audit_sha256": "792ec552828c3d95918f8d332fb138052a9b8d596302781ceefff1886cf2cfe2", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ar/google-gemini-3-flash-preview-u003a-batch/", "description": "يجمع Gemini 3 Flash Preview بين الفهم متعدد الوسائط والاستدلال مع مخرجات نصية. يدعم تحليل الشيفرة والمستندات والمواد المرئية والنتائج المنظَّمة ومسارات العمل المتمحورة حول الأدوات، مع أربعة مستويات تفكير موثقة لاختيار عمق التحليل.", "locale": "ar", "md_url": "https://ailoot.ai/models/ar/google-gemini-3-flash-preview-u003a-batch/index.md", "title": "Google: Gemini 3 Flash Preview (batch) — Ailoot", "url": "https://ailoot.ai/models/ar/google-gemini-3-flash-preview-u003a-batch/" }, "rawModel": { "about": "Gemini 3 Flash Preview هو نموذج استدلال من Google للفهم متعدد الوسائط والبرمجة ومهام الوكلاء. يقبل النصوص والصور والفيديو والصوت وPDF ويعيد نصًا. ولذلك يمكن للطلب أن يجمع التعليمات المكتوبة وملفات المصدر والملاحظات المرئية وسجل المحادثة حول مشكلة واحدة. قد تكون النتيجة شرحًا أو مقترح شيفرة أو بيانات مستخرجة أو خطة مستندة إلى تلك المواد، بدلًا من صورة مولدة أو استجابة منطوقة.\n\nتعطي بطاقة النموذج المحددة حد إدخال يبلغ 1,048,576 رمزًا وحد إخراج يبلغ 65,536 رمزًا. خطط للمصدر والنتيجة، كلًّا منهما على حدة: لا يمكن استيعاب مقتطف طويل من مستودع أو مجموعة مستندات أو تسجيل إلا عندما يتسع حد الإدخال لتمثيله المعالَج وتعليماته، وتظل الإجابة بحاجة إلى طول مخصص لها. ضع تسميات للمصادر المرتبطة وحدّد المادة المعتمدة. ولمطالبة طويلة، يوصي دليل المطور بوضع السؤال المحدد بعد البيانات وربطه صراحة بالمعلومات السابقة.\n\nالتفكير ديناميكي، والمستوى high هو الافتراضي الموثق لهذا النموذج. المستويات المدعومة هي minimal وlow وmedium وhigh. وهي حصص استدلال نسبية وليست أعداد رموز مضمونة. قد يظل minimal متضمنًا بعض الاستدلال في مشكلة برمجية صعبة. اختر المستوى بحسب المهمة: يحتاج تحويل قصير ومشكلة تصحيح أخطاء متعددة الشروط إلى معالجة مختلفة. استخدم تعليمات مباشرة وواضحة بدلًا من فرض طقوس استدلال معقدة داخل المطالبة؛ واطلب المادة النهائية والفحوص التي تجعلها قابلة للاستخدام.\n\nتسرد بطاقة الشركة المنتجة المخرجات المنظَّمة واستدعاء الدوال وتنفيذ الشيفرة واستخدام الحاسوب والبحث في الملفات وإسناد الإجابات إلى البحث وإلى Google Maps وسياق URL والتخزين المؤقت. يمكن الجمع بين الأدوات المدمجة واستدعاء الدوال المخصصة ضمن مسار Gemini 3 الموثق. يعرّف التطبيق الدوال، ويفحص وسائطها، وينفذ الإجراءات المقبولة، ويرسل نتائجها. ولمساعد برمجي، تستطيع أداة قراءة ملفات أو مشغّل اختبارات مضبوط توفير أدلة ملموسة للخطوة التالية. ينبغي أن يظل الإجراء المقترح ونتيجة الأداة الملحوظة متميزين في التقرير النهائي.\n\nللبرمجة، قدّم الملفات ذات الصلة واللغة والسلوك المتوقع ومدخلًا يوضح المشكلة. حدّد نطاق التغيير وسمِّ الواجهة أو السلوك الذي يجب الحفاظ عليه. اطلب تنفيذًا معدلًا والحالات التي ينبغي فحصها. ولمهمة مستندية تحليلية، عرّف السؤال والحقول المطلوبة والمراجع المصدرية. وإذا استُخدمت مخرجات منظَّمة، فقدّم مخططًا ذا معانٍ واضحة للحقول وقواعد للقيم المفقودة. تحقق من صحة بنيته ومن أن كل قيمة تستند إلى المادة الأصلية.\n\nللتحليل متعدد الوسائط، حدّد ما يهم في كل مصدر. يمكن للقطة شاشة دعم شرح واجهة، ولـPDF توفير جدول أو مخطط، ولتسجيل تقديم أحداث منطوقة أو مرئية. يناقش دليل المطور عناصر التحكم في دقة الوسائط لأن التفاصيل تغير التمثيل المعالَج واستخدام الرموز. يستطيع مسار تنفيذ الشيفرة لدى الشركة المنتجة قص الصور المقدمة أو تكبيرها وإجراء حسابات من البيانات المرئية وإضافة تعليقات توضيحية قبل أن يعد النموذج إجابته. قد تتطلب قراءة نص صغير إعدادًا مختلفًا عن وصف مشهد عام. أبقِ الصفحة أو الصورة أو المقطع المعني متاحًا للتحقق من الملاحظات، بدلًا من اعتبار ملخص سلس دليلًا على قراءة كل تفصيل بصورة صحيحة.\n\nيجب الاحتفاظ بحالة المحادثة والأدوات في الواجهة المختارة. يستخدم Gemini 3 توقيعات التفكير لنقل سياق الاستدلال بين الاستدعاءات؛ ويميز دليل المطور بين السجل ذي الحالة المُدار والسجل عديم الحالة المُدار يدويًا. حافظ على السياق المطلوب عند متابعة مهمة بأداة أو تعديل نتيجة. توصي Google أيضًا بالإبقاء على درجة الحرارة الافتراضية 1.0 بدلًا من استيراد وصفة بدرجة حرارة منخفضة قد تسبب حلقات تكرار أو تراجعًا في السلوك في المهام المعقدة. هذه ممارسات تكامل لدى الشركة المنتجة، وليست ادعاءات جديدة بشأن آلية النقل في تطبيق معين.\n\nلا يعلن النموذج النصي عن توليد صور أو صوت أو دعم Live API. ويميز الدليل أيضًا بين الفهم المرئي وتجزئة الصور على مستوى البكسل، وهي ليست قدرة مدعومة في Gemini 3 Flash. استخدم نتيجة نهائية مناسبة للمهمة الفعلية: ملاحظات مرتبطة بالمصادر، أو سجل منظَّم، أو تغيير برمجي، أو قرار تُذكر افتراضاته. افحص العمليات الحسابية، وتحقق من الشيفرة في البيئة المقصودة، وراجع معلومات الأدوات المعادة. وعندما تكون الحقائق الحديثة مهمة، استخدم مصادر الإسناد المهيأة أو البيانات الراهنة المقدمة بدلًا من افتراض أن معرفة النموذج قاعدة بيانات حية.", "alias_of": null, "aliases": [], "author": "Google", "capabilities": { "context_length": 1048576, "manufacturer_input": [ "text", "image", "file", "audio", "video" ], "manufacturer_output": [ "text" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" } ], "summary": "التسعير الكامل للتكوين في التفاصيل." } ], "ctx": null, "formats": [ "batches" ], "id": "google/gemini-3-flash-preview:batch", "input": [ "text" ], "kind": "text", "max_out": null, "methods": [ { "available": null, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Preserve full JSON and every result; provider real IDs are only read from actual returned responses.", "authentication": { "api_key_source": "AILOOT_API_KEY", "header": "Authorization: Bearer" }, "errors": [ { "code": null, "condition": "الغلاف المضمّن الموثّق غير صالح، أو توجد مفاتيح مكررة أو مشكلة في هوية العناصر، أو تعارض مع قدرات النموذج المضبوطة.", "http_status": 400, "recovery": "صحح الحقول المحددة قبل أي إرسال جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "مفتاح API غير صالح.", "http_status": 401, "recovery": "استخدم مفتاح Ailoot المصرّح به.", "type": "authentication_error" }, { "code": null, "condition": "مجموعة المعالجة الدفعية غير متاحة.", "http_status": 403, "recovery": "تحقق من صلاحية الوصول الممنوحة للمفتاح والمجموعة.", "type": "permission_error" }, { "code": null, "condition": "تستخدم المعالجة الدفعية الفوترة من الرصيد؛ ويُرفض إنشاؤها عبر الاشتراك.", "http_status": 422, "recovery": "استخدم المجموعة المصرّح بها التي تُخصم رسومها من الرصيد.", "type": "invalid_request_error" }, { "code": null, "condition": "لا يمكن تقديم تقدير تكلفة لمدخلات المعالجة الدفعية.", "http_status": 422, "recovery": "احتفظ بالاستجابة؛ واستخدم المدخلات الموثّقة لعائلة الواجهات.", "type": "price_unavailable" }, { "code": null, "condition": "حجز الرصيد للمعالجة الدفعية غير متاح.", "http_status": 402, "recovery": "عالج ما يمنع قبول الطلب قبل إرسال طلب جديد.", "type": "billing_error" }, { "code": null, "condition": "سعر طريقة المعالجة الدفعية أو تعرفاتها الأصلية غير متاحة.", "http_status": 503, "recovery": "احتفظ بالاستجابة؛ ولا تستبدل الأسعار.", "type": "price_unavailable" }, { "code": null, "condition": "مسار المورّد المحدد غير متاح.", "http_status": 503, "recovery": "احتفظ بالاستجابة لإصلاح المسار.", "type": "api_error" }, { "code": "result_pending_check", "condition": "النتيجة الأصلية تتطلب التحقق؛ X-Should-Retry:false.", "http_status": 503, "recovery": "احتفظ بقيمة operation_id/id الأصلية واقرأ حالتها؛ ولا تُكرر POST الأصلي مطلقًا.", "type": null }, { "code": "not_found", "condition": "عملية حالة المعالجة الدفعية غير موجودة أو مملوكة لهوية أخرى.", "http_status": 404, "recovery": "استخدم id الأصلي كما هو، والمستخدم والمفتاح والمجموعة نفسها.", "type": null } ], "example_body": { "endpoint": "/v1/chat/completions", "model": "google/gemini-3-flash-preview:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "input_constraints": [ "Use the exact shown :batch model ID.", "Each custom_id must be nonempty and unique within the batch.", "Keep requests last in the serialized body; duplicate JSON keys are rejected.", "Each body.model is omitted or equals the exact batch caller or its documented base ID.", "Per-item provider, service_tier and input_type are outside this batch profile.", "stream is omitted or false.", "Supply text messages for this Chat batch profile; image/audio/file/video objects, hosted tools and cache-control fields are outside this profile.", "If body.model is present, use only the exact caller or wire ID listed here; no suffix conversion is needed.", "For google/ wire IDs, all items use an identical response_format." ], "outputs": { "all_results": "احتفظ بمحتوى JSON الكامل للحالة الأصلية، وبكل نتيجة وcustom_id، وبجسم الاستجابة أو الخطأ كاملًا. احفظ results[] المكتملة بصيغة JSONL دون تصفية.", "enclosing_family": "batch", "family": "text", "fields": [ { "name": "results[].custom_id", "type": "string" }, { "name": "results[].response.body.choices[].message.content", "type": "string|null" }, { "name": "results[].error", "type": "object|null" }, { "name": "usage", "type": "object|null" }, { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "endpoint", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "request_counts", "type": "object" }, { "description": null, "name": "results[].id", "type": "string" }, { "description": null, "name": "results[].response.status_code", "type": "integer" }, { "description": null, "name": "results[].response.request_id", "type": "string" } ], "format": "محتوى JSON مضمّن في results[].response.body" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "/v1/chat/completions" ], "enum_known": true, "name": "endpoint", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-3-flash-preview:batch" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_items": 1, "name": "requests", "required": true, "type": "batch_item[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].custom_id", "required": true, "type": "string", "unique_within_batch": true }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "requests[].body.messages", "required": true, "type": "message[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "24h" ], "enum_known": true, "name": "completion_window", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "provider", "required": false, "type": "object|null" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/gemini-3-flash-preview:batch", "google/gemini-3-flash-preview" ], "enum_known": true, "name": "requests[].body.model", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ [ "google-vertex/global" ] ], "enum_known": true, "name": "provider.only", "required": false, "type": "string[]" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, null ], "enum_known": true, "name": "provider.allow_fallbacks", "required": false, "type": "boolean|null" } ], "provider_policy": { "allow_fallbacks": false, "configured_only": [ "google-vertex/global" ], "per_item_override": false, "when_omitted": "Current Source injects the exact persisted declaration before fresh submission." }, "request_schema": { "additionalProperties": false, "properties": { "completion_window": { "enum": [ "24h" ], "type": "string" }, "endpoint": { "enum": [ "/v1/chat/completions" ], "type": "string" }, "model": { "enum": [ "google/gemini-3-flash-preview:batch" ], "type": "string" }, "provider": { "additionalProperties": false, "properties": { "allow_fallbacks": { "enum": [ false, null ], "type": [ "boolean", "null" ] }, "only": { "enum": [ [ "google-vertex/global" ] ], "items": { "enum": [ "google-vertex/global" ], "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "type": [ "object", "null" ] }, "requests": { "items": { "additionalProperties": false, "properties": { "body": { "additionalProperties": true, "properties": { "max_tokens": { "minimum": 1, "type": "integer" }, "messages": { "items": { "properties": { "content": { "type": "string" }, "role": { "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "model": { "enum": [ "google/gemini-3-flash-preview:batch", "google/gemini-3-flash-preview" ], "type": "string" } }, "required": [ "messages" ], "type": "object" }, "custom_id": { "minLength": 1, "type": "string" } }, "required": [ "custom_id", "body" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "endpoint", "model", "requests" ], "type": "object" }, "schema_template": { "endpoint": "/v1/chat/completions", "model": "google/gemini-3-flash-preview:batch", "requests": [ { "body": { "max_tokens": 16, "messages": [ { "content": "Hello!", "role": "user" } ] }, "custom_id": "req-0001" } ] }, "unsupported": [ "Files/input_file_id batch upload workflow", "active cancel route", "public batch list/delete/result-download route", "model-name-derived capability or weights equivalence" ] }, "input": { "content_type": "application/json", "file_material": "يمكن للمستدعي قراءة محتوى JSONL الفعلي بترميز UTF-8 محليًا إلى requests[]. لا يُستخدم غرض للرفع ولا input_file_id ولا مرجع إلى ملف. إذا كانت مواد العميل مفقودة أو فارغة، يتوقف التحضير قبل POST.", "material_types": [ "text" ], "optional_controls": [ "provider.only", "provider.allow_fallbacks", "completion_window" ], "representation": "طلبات requests[] مضمّنة؛ يحتوي كل عنصر على custom_id وbody", "request_endpoint_profile": "/v1/chat/completions", "required": [ "endpoint", "model", "requests" ], "schema_scope": "أجسام طلبات Text Chat Completions ضمن غلاف Batch المضمّن الموثّق.", "serialization_order": [ "endpoint", "model", "provider (إذا تم توفيره)", "completion_window (إذا تم توفيره)", "requests في النهاية" ] }, "lifecycle": { "cancel": null, "create": { "accepted_status": 202, "http": "POST", "path": "/v1/batches" }, "delete": null, "file_upload": null, "mode": "asynchronous", "observed_status_values": [ "validating", "in_progress", "finalizing", "completed", "failed", "expired", "cancelling", "cancelled" ], "owned_results": { "behavior": "Completed results are saved as owned JSONL, read back byte-for-byte and registered in the existing media library before publication after settlement. Status returns inline results; no separate Batch download route is added.", "format": "application/x-ndjson", "public_url_field_in_status": null }, "status": { "http": "GET", "id_source": "قيمة response.id الفعلية من استجابة الإنشاء الأصلية؛ مع المستخدم والمفتاح والمجموعة نفسها", "path": "/v1/batches/{operation_id}" }, "terminal": [ "completed", "failed", "expired", "cancelled" ], "unknown": "احتفظ بمعرّف العملية الأصلي. تتضمن الاستجابة 503 result_pending_check الترويسة X-Should-Retry:false؛ لا تُعِد إرسال الدفعة الأصلية التي لا تُعرف نتيجتها مطلقًا." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/batches" }, "output": { "all_results": "Preserve the full original status JSON, every result/custom_id and complete response or error body. Save completed results[] as JSONL without filtering.", "family": "batch", "format": "JSON; completed results[] are returned inline and can be saved as JSONL." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "التعرفات الأساسية للرموز", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "الشريحة 1 لطول الطلب", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{\"endpoint\":\"/v1/chat/completions\",\"model\":\"google/gemini-3-flash-preview:batch\",\"requests\":[{\"custom_id\":\"req-0001\",\"body\":{\"messages\":[{\"role\":\"user\",\"content\":\"Hello!\"}],\"max_tokens\":16}}]}')\nPath(\"batch-request.json\").write_text(json.dumps(body,ensure_ascii=False),encoding=\"utf-8\")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\n", "label": "curl · retained fixture", "language": "bash" }, { "code": "import json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError(\"Customer JSONL file is missing\")\n items = [json.loads(line) for line in path.read_text(encoding=\"utf-8\").splitlines() if line.strip()]\n if not items: raise ValueError(\"Customer JSONL contains no requests\")\n ids = set()\n for item in items:\n if set(item) != {\"custom_id\", \"body\"}: raise ValueError(\"Each item needs custom_id and body\")\n cid = item[\"custom_id\"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError(\"custom_id must be nonempty and unique\")\n ids.add(cid)\n if not isinstance(item[\"body\"], dict) or not item[\"body\"].get(\"messages\"): raise ValueError(\"Supply actual text messages\")\n supplied_model = item[\"body\"].get(\"model\")\n if supplied_model is not None and supplied_model not in ['google/gemini-3-flash-preview:batch', 'google/gemini-3-flash-preview']: raise ValueError(\"body.model must be an exact documented caller or wire ID\")\n return {\"endpoint\":\"/v1/chat/completions\", \"model\":\"google/gemini-3-flash-preview:batch\", \"requests\":items}\n\nif __name__ == \"__main__\":\n material = os.environ.get(\"AILOOT_BATCH_REQUESTS_JSONL\", \"\")\n if not material: raise SystemExit(\"Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file\")\n body = prepare_requests(material)\n key = os.environ.get(\"AILOOT_API_KEY\", \"\")\n if not key: raise SystemExit(\"Set AILOOT_API_KEY\")\n request = Request(\"https://api.ailoot.ai/v1/batches\", data=json.dumps(body, ensure_ascii=False).encode(\"utf-8\"), headers={\"Authorization\":\"Bearer \" + key, \"Content-Type\":\"application/json\"}, method=\"POST\")\n with urlopen(request) as response:\n raw = response.read()\n Path(\"batch-create-response.json\").write_bytes(raw)\n print(raw.decode(\"utf-8\"))\n", "label": "Python HTTP · actual customer JSONL", "language": "python" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nBATCH_OPERATION_ID=\"$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path(\"batch-create-response.json\").read_text(encoding=\"utf-8\"))\noperation = response.get(\"id\")\nif not isinstance(operation, str) or not operation: raise SystemExit(\"No actual original operation ID; preserve the response and do not resubmit\")\nprint(quote(operation, safe=\"\"))\nPY_ID\n)\"\ncurl --fail-with-body --silent --show-error \"https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -o batch-status-response.json\n", "label": "curl · original operation status", "language": "bash" }, { "code": "import json\nfrom pathlib import Path\nraw = Path(\"batch-status-response.json\").read_bytes()\nresponse = json.loads(raw)\nif response.get(\"status\") != \"completed\":\n raise SystemExit(\"Keep the original operation; read its status without resubmitting\")\nresults = response.get(\"results\")\nif not isinstance(results, list) or not results:\n raise SystemExit(\"Preserve the original response; completed results are missing\")\nPath(\"batch-results.jsonl\").write_text(\"\".join(json.dumps(item, ensure_ascii=False) + \"\\n\" for item in results), encoding=\"utf-8\")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\n", "label": "Python · save every completed result", "language": "python" } ], "family": "batch", "fast_multiplier": null, "flex_multiplier": null, "fmt": "batches", "hints": [ "Read your actual request items before submission; inline requests are required.", "Keep the returned operation ID and every result. Never replay an unknown submission." ], "http": "POST", "in": 0.5, "input": [ "text" ], "label": "المعالجة الدفعية", "max_out": null, "max_reasoning_effort_multiplier": null, "out": 3, "output": [ "text" ], "path": "/v1/batches", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" }, { "label": "Explicit cache pricing", "value": "Not enabled", "when": "When explicit cache is requested" } ], "pricing": { "billing_mode": "token", "image_input_price": null, "image_output_price": null, "per_request_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "max_context_tokens_inclusive": null, "min_context_tokens_exclusive": 0 }, "label": "Request-length tier 1", "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "request_model_id": "google/gemini-3-flash-preview:batch", "route_label": "Ultra", "status_reads": [ "GET /v1/batches/{operation_id}" ], "tiers": [ { "cache_read": null, "cache_read_multiplier": null, "cache_write": null, "cache_write_1h": null, "cache_write_multiplier": null, "created_at": "0001-01-01T00:00:00Z", "in": 0.5, "input_multiplier": null, "max": null, "max_tokens": null, "min": 0, "min_tokens": 0, "out": 3, "output_multiplier": null, "per_request_price": null, "sort_order": 0, "tier_label": "", "updated_at": "0001-01-01T00:00:00Z" } ], "units": [ { "amount": "0.0005000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": "0.0000005", "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": "0.003000", "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": "0.000003", "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": true, "estimate_only": false, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": false, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] } ], "model_aliases": [ { "canonical_model_id": "google/gemini-3-flash-preview:batch", "request_model_id": "google/gemini-3-flash-preview:batch", "route_label": "Ultra" } ], "name": "Google: Gemini 3 Flash Preview (batch)", "price": { "in": 0.5, "in_label": null, "out": 3, "out_label": null, "scope_label": "Token rates", "sort_in": 0.5, "sort_out": 3, "varies": true }, "short": "يجمع Gemini 3 Flash Preview بين الفهم متعدد الوسائط والاستدلال مع مخرجات نصية. يدعم تحليل الشيفرة والمستندات والمواد المرئية والنتائج المنظَّمة ومسارات العمل المتمحورة حول الأدوات، مع أربعة مستويات تفكير موثقة لاختيار عمق التحليل." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "يجمع Gemini 3 Flash Preview بين الفهم متعدد الوسائط والاستدلال مع مخرجات نصية. يدعم تحليل الشيفرة والمستندات والمواد المرئية والنتائج المنظَّمة ومسارات العمل المتمحورة حول الأدوات، مع أربعة مستويات تفكير موثقة لاختيار عمق التحليل.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "4e3e6002187dd189dcfc205ba2d65b0a43093019c2253068cb2f49d00db60abc", "renderer_sha256": "081ee0fd5b6b1b60564b02c52d62547e01e922c8c0a16e91a0d055073e76a10e" }, "sourceRevision": "a0d26a14ba43d2366e9cf6d13e104124c3ebc9bd460e0c3b4a413af965ed3e9f" }