Google: Gemini Embedding 2 (batch)
يرسل Gemini Embedding 2 Batch مجموعات من طلبات التمثيلات المتجهية للنص بوصفها دفعة واحدة في Ailoot. تتبّع كل عنصر عبر custom_id واسترجع النتائج الكاملة للعملية الأصلية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يستخدم Gemini Embedding 2 Batch المسار /v1/batches مع معرّف النموذج google/gemini-embedding-2:batch بالضبط. اضبط endpoint على /v1/embeddings وقدّم requests؛ ويحتوي كل عنصر على custom_id وعلى body يتضمن input كسلسلة نصية أو مصفوفة سلاسل. أبقِ المعرّفات ثابتة حتى يستطيع تطبيقك مطابقة النتائج مع مجموعة مستندات معدّة مسبقًا.
الدفعة غير متزامنة. احتفظ بمعرّف العملية الأصلي المعاد، واستخدم GET /v1/batches/{operation_id} لمتابعة العملية نفسها بهوية المستدعي نفسها. يمكن أن تحتوي مجموعة النتائج المكتملة على response أو error لكل custom_id؛ لذا افحص نتائج العناصر إلى جانب الحالة الإجمالية.
احفظ جميع النتائج المكتملة بصيغة JSONL، مع الحفاظ على كل custom_id واستجابته أو خطئه كاملًا. اربط المتجهات الناجحة بمعرّفات المستندات المرسلة قبل تحديث الفهرس. احتفظ بسجلات العملية الأصلية والعناصر معًا، حتى يمكن فحص عنصر غير مكتمل أو فاشل دون فقدان النتائج المعادة بالفعل.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchالبداية
يرسل Gemini Embedding 2 Batch مجموعات من طلبات التمثيلات المتجهية للنص بوصفها دفعة واحدة في Ailoot. تتبّع كل عنصر عبر custom_id واسترجع النتائج الكاملة للعملية الأصلية.
- المدخلات المقبولة
- النص
- النتائج
- embedding
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · Batch POST /v1/batches
- الإدخال
text- الإخراج
embedding
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود google/gemini-embedding-2:batch الشروط: استخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا. | القيمة الافتراضية— |
الحقلendpoint | النوعstring | المتطلبمطلوب | القيم والحدود /v1/embeddings الشروط: | القيمة الافتراضية— |
الحقلrequests | النوعarray | المتطلبمطلوب | القيم والحدود الشروط: | القيمة الافتراضية— |
معلمات الطريقة ودورة حياتها
| المعلمة | المواصفات |
|---|---|
المعلمةcontent_type | المواصفاتapplication/json |
المعلمةrequired | المواصفاتmodel, endpoint, requests |
المعلمةoptional | المواصفات |
المعلمةmaterial_types | المواصفاتtext |
المعلمةconditions | المواصفاتاستخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا. |
دورة الحياة: asynchronous
GET /v1/batches/{operation_id} · القيمة الأصلية الفعلية لـ response.id، مع مُقدِّم الطلب والمفتاح والمجموعة نفسها
الباقات
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
- الوضع السريع
- غير محدد عند اختيار الوضع السريع
- الوضع المرن
- غير محدد عند اختيار وضع flex
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
- تسعير التخزين المؤقت الصريح
- غير مفعّل عند طلب التخزين المؤقت الصريح
تعرفات Ailoot
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | رموز السياق، أكثر من | رموز السياق، حتى القيمة شاملةً | الرسوم |
|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | رموز السياق، أكثر من— | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.0002 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتالشريحة 1 لطول الطلب | جدول التعرفة— | رموز السياق، أكثر من0 | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.0002 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"endpoint": "/v1/embeddings", "model": "google/gemini-embedding-2:batch", "requests": [{"custom_id": "embedding-1", "body": {"input": "The quick brown fox jumps over the lazy dog"}}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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 @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_BATCH'
import json,os,subprocess
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path("result.json").read_text()); operation=r["id"]
subprocess.run(["curl","--fail-with-body","--silent","--show-error","https://api.ailoot.ai/v1/batches/"+quote(operation,safe=""),"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
s=json.loads(Path("status.json").read_text())
if s.get("status")=="completed": Path("results.jsonl").write_text("".join(json.dumps(x,ensure_ascii=False)+"\n" for x in s.get("results",[])))
# Repeat only this same original GET while pending; never repeat creation.
PY_BATCH
استلام النتائج وحفظها
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
الاحتفاظ بكل النتائج المكتملة
احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.
احتفظ بالحالة الأصلية، وكل custom_id، والاستجابة أو الخطأ كاملًا. احفظ جميع نتائج results[] المكتملة بصيغة JSONL؛ ولا تفترض وجود مسار لرفع الملفات أو تنزيلها عبر Files.
عند الحاجة إلى التحقق من الاستجابة الأصلية
احتفظ بمعرّف العملية الأصلي واقرأ تلك الدفعة الأصلية فقط. انتهاء المهلة أو وقوع خطأ أو وجود حالة مجهولة لا يجيز إنشاء دفعة أخرى.
حقول الاستجابة
| الحقل | النوع |
|---|---|
الحقلresults[] | النوعarray |
الحقلresults[].custom_id | النوعstring |
الحقلresults[].response | النوعobject |
الحقلresults[].error | النوعobject |
الأخطاء والخطوات التالية
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطأحد الحقول المطلوبة أو مُحدِّد النموذج أو النوع أو تمثيل الإدخال غير صالح. | الخطوة التاليةافحص تفاصيل التحقق المُعادة قبل إعداد طلب مستقل. |
الاستجابة | الشرطالطلب الأصلي أو نتيجته مجهولان أو يحتاجان إلى تحقق. | الخطوة التاليةاحتفظ بالمعرّفات والترويسات الأصلية؛ واقرأ فقط سجلات الحالة أو المكتبة المدعومة. لا ترسل طلب الإنشاء مجددًا. |
الأسماء البديلة
الأسماء البديلة للنموذج
Ailoot Ultra google/gemini-embedding-2:batch
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Google: Gemini Embedding 2 (batch)
- ما المدخلات والنتائج المتاحة؟
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- ما الحقول التي يستخدمها الطلب؟
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests