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 Ultra · المعالجة الدفعية POST /v1/batches google/gemini-3-flash-preview:batch
google/gemini-3-flash-preview:batch
google/gemini-3-flash-preview:batchالبداية
يجمع Gemini 3 Flash Preview بين الفهم متعدد الوسائط والاستدلال مع مخرجات نصية. يدعم تحليل الشيفرة والمستندات والمواد المرئية والنتائج المنظَّمة ومسارات العمل المتمحورة حول الأدوات، مع أربعة مستويات تفكير موثقة لاختيار عمق التحليل.
- المدخلات المقبولة
- النص
- النتائج
- النص
متاح في 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=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}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen
def prepare_requests(customer_path):
path = Path(customer_path)
if not path.is_file(): raise ValueError("Customer JSONL file is missing")
items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
if not items: raise ValueError("Customer JSONL contains no requests")
ids = set()
for item in items:
if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
cid = item["custom_id"]
if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
ids.add(cid)
if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
supplied_model = item["body"].get("model")
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")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3-flash-preview:batch", "requests":items}
if __name__ == "__main__":
material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
body = prepare_requests(material)
key = os.environ.get("AILOOT_API_KEY", "")
if not key: raise SystemExit("Set AILOOT_API_KEY")
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")
with urlopen(request) as response:
raw = response.read()
Path("batch-create-response.json").write_bytes(raw)
print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.
استلام النتائج وحفظها
Ailoot Ultra · المعالجة الدفعية
محتوى JSON مضمّن في results[].response.body
GET /v1/batches/{operation_id}
التحقق من حالة المهمة
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بمحتوى 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
FAQ · Google: Gemini 3 Flash Preview (batch)
- ما المدخلات والنتائج المتاحة؟
POST /v1/batches·google/gemini-3-flash-preview:batch:text→text- ما الحقول التي يستخدمها الطلب؟
POST /v1/batches·google/gemini-3-flash-preview:batch:endpoint,model,requests,completion_window,provider- ما الحدود المطبقة؟
POST /v1/batches·google/gemini-3-flash-preview:batch:requests.min_items:1