Google: Gemini 2.5 Flash (batch)
Gemini 2.5 Flash هو نموذج الاستدلال الهجين المستقر من Google للتحليل متعدد الوسائط ومهام الوكلاء. يمكن ضبط ميزانية تفكيره الديناميكية من 0 إلى 24,576 رمزًا، بما في ذلك وضع إيقاف التفكير. تتحول النصوص والصور والصوت والفيديو والمستندات إلى نص أو نتائج منظَّمة، مع حد إدخال موثق يبلغ 1,048,576 رمزًا.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Gemini 2.5 Flash هو إصدار الاستدلال الهجين المستقر من Google للعمل متعدد الوسائط المتوازن واستخدام الأدوات بواسطة الوكلاء. يوفر استجابات مع التفكير وأخرى من دونه لمهام متعددة الوسائط على نطاق واسع تحتاج إلى مستويات مختلفة من الاستدلال. تساهم النصوص والصور والصوت والفيديو في إجابة نصية. كما يصف إصدار Google السحابي الخاص بالنموذج إدخال المستندات. يمكن أن تكون النتيجة المفيدة مقارنة مستندات أو تفسير مخطط بياني أو تفريغًا نصيًا أو شيفرة أو سجلًا منظَّمًا.
يستخدم التحكم في الاستدلال لهذا الإصدار thinkingBudget. التفكير الديناميكي هو الافتراضي؛ ويتيح الإعداد -1 للنموذج تكييف استدلاله مع تعقيد المهمة. يمكن أن تتراوح الميزانية الصريحة من صفر إلى 24,576 رمزًا، ويؤدي الصفر إلى إيقاف التفكير. اختر ميزانية مناسبة للمشكلة الفعلية بدلًا من تخصيص الجهد نفسه لتصنيف بسيط وتحليل متعدد الشروط. يتعامل الدليل مع الميزانية بوصفها توجيهًا، وتشير البطاقة الأصلية إلى أن الالتزام بها قد لا يكون دقيقًا.
لمهمة مستندية أو مهمة بيانات، عرّف السؤال والحقول المطلوبة والأدلة التي ينبغي أن ترافق النتيجة. ولمقارنة متطلبات، قارن مواصفتين وأعد المتطلب المتغير ومقطعه المصدري وأثره في مسار عمل محدد. تفيد المخرجات المنظَّمة عندما تحتاج كل نتيجة إلى شكل السجل نفسه. وإذا أعطى المصدر عدة قيم محتملة أو ترك حقلًا مفتوحًا، فحافظ على هذا الغموض بدلًا من فرض إجابة واحدة معقولة ظاهريًا. راجع القيم المعادة بمقارنتها بالصفحات أو البيانات المقدمة.
للمادة المرئية أو الصوتية، حدّد العنصر أو التسمية أو الحدث أو المقطع في التسجيل ذي الصلة. اطلب نوع النص المطلوب: قيمًا ظاهرة في مخطط بياني أو وصف حدث أو تفريغًا نصيًا أو ملخصًا. هذه مواد مختلفة، وينبغي للتعليمات أن تحدد أيها يُنتَج. تتضمن بطاقة النموذج الأصلية المشتركة Flash Image وFlash Audio بوصفهما قدرتين مسماتين على نحو منفصل؛ ولا تدخل مخرجاتهما من الصور والكلام المولدين ضمن هذا الإصدار النصي المستقر.
يوثق الإصدار السحابي المحدد لدى Google مدخلات PDF والنص العادي بحدود خاصة بالواجهة: 50 MB لكل PDF مستورد عبر API، وما يصل إلى 3,000 صفحة لكل ملف، مع حد 7 MB لملف النص العادي. ويصف هذا الإصدار أيضًا نحو 45 دقيقة من الفيديو المصحوب بصوت أو ساعة واحدة دون صوت، ونحو 8.4 ساعة من الصوت ضمن حصة إدخال المليون رمز. هذه هي القيود المذكورة للواجهة السحابية، وهي منفصلة عن نافذة رموز النموذج العامة. جهّز القسم المعني وتنسيق المصدر بدلًا من افتراض أن لكل نوع ملف أو مسار رفع الحد نفسه.
يسرد جدول Gemini API المحدد استدعاء الدوال وتنفيذ الشيفرة والبحث في الملفات وإسناد الإجابات إلى البحث وإلى Maps وسياق URL والمخرجات المنظَّمة. عرّف دور كل دالة وشكل معاملاتها، وتابع انطلاقًا من النتيجة الفعلية المعادة. يستطيع النموذج طلب عملية، بينما ينفذها التطبيق المتصل. حافظ على سياق توقيعات التفكير اللازم عند متابعة مهمة استدلال في الواجهة عديمة الحالة. لا تثبت الإجابة المنظَّمة أو اقتراح الدالة بصورة مستقلة نجاح عملية خارجية.
تعطي بطاقة النموذج الأصلية سياقًا 1M ومخرجات نصية 64K، بينما يحدد جدول API الدقيق 1,048,576 رمز إدخال و65,536 رمز إخراج. يشمل حد الاستجابة رموز التفكير، لذا قد يترك حد صغير جدًا الإجابة النهائية مبتورة أو فارغة. اطلب مادة يتناسب حجمها مع حصة الإخراج، واستخدم ميزانية الاستدلال لتوجيه الجهد. التخزين المؤقت والمعالجة الدفعية وFlex وPriority موثقة لهذا الإصدار لدى الشركة المنتجة. احتفظ بمعرّفات العناصر عند إعداد عدة سجلات مستقلة.
يبقى الإصدار المستقر منفصلًا عن إصدارات Flash Preview ونماذج Gemini 3 اللاحقة. تسرد بطاقته احتمال الهلوسة وقيودًا في فهم السببية والاستدلال المنطقي المعقد أو المخالف للواقع، وحد معرفة في يناير 2025. قدّم أدلة حديثة عندما تعتمد المهمة على معلومات أحدث. افحص الحسابات والقيم المستخرجة والتفريغات النصية والشيفرة المقترحة بمقارنتها بالمصدر الفعلي أو نتيجة التنفيذ. يفيد التفكير الهجين عندما يدعم تلك النتيجة الملموسة، بدلًا من أن يصبح بديلًا عن مراجعتها.
Ailoot Ultra · المعالجة الدفعية POST /v1/batches google/gemini-2.5-flash:batch
google/gemini-2.5-flash:batchالبداية
Gemini 2.5 Flash هو نموذج الاستدلال الهجين المستقر من Google للتحليل متعدد الوسائط ومهام الوكلاء. يمكن ضبط ميزانية تفكيره الديناميكية من 0 إلى 24,576 رمزًا، بما في ذلك وضع إيقاف التفكير. تتحول النصوص والصور والصوت والفيديو والمستندات إلى نص أو نتائج منظَّمة، مع حد إدخال موثق يبلغ 1,048,576 رمزًا.
- المدخلات المقبولة
- النص
- النتائج
- النص
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · المعالجة الدفعية POST /v1/batches
- الإدخال
text- الإخراج
text- صيغة الإخراج
- محتوى JSON مضمّن في results[].response.body
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلendpoint | النوعstring | المتطلبمطلوب | القيم والحدود /v1/chat/completions | القيمة الافتراضية— |
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود google/gemini-2.5-flash:batch | القيمة الافتراضية— |
الحقلrequests | النوعbatch_item[] | المتطلبمطلوب | القيم والحدود الحد الأدنى للعناصر: 1 | القيمة الافتراضية— |
الحقلrequests[].custom_id | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلrequests[].body.messages | النوعmessage[] | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلcompletion_window | النوعstring | المتطلباختياري | القيم والحدود 24h | القيمة الافتراضية— |
الحقلprovider | النوعobject|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.0003 / 1K من الرموز الإخراج · رموز الإخراج $0.0025 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0.00006 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتالشريحة 1 لطول الطلب | جدول التعرفة— | رموز السياق، أكثر من0 | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.0003 / 1K من الرموز الإخراج · رموز الإخراج $0.0025 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0.00006 / 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-2.5-flash: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")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-2.5-flash: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"))
استلام النتائج وحفظها
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
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بكل نتيجة، ومتن كل استجابة أو خطأ، وكل خيار، وإجمالي الاستخدام.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بمعرّف العملية الأصلي. تتضمن الاستجابة 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 |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra google/gemini-2.5-flash:batch
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Google: Gemini 2.5 Flash (batch)
- ما المدخلات والنتائج المتاحة؟
POST /v1/batches·google/gemini-2.5-flash:batch:text→text- ما الحقول التي يستخدمها الطلب؟
POST /v1/batches·google/gemini-2.5-flash:batch:endpoint,model,requests,completion_window,provider- ما الحدود المطبقة؟
POST /v1/batches·google/gemini-2.5-flash:batch:requests.min_items:1