تنشئ عدة عمليات تضمين من النموذج المحدد لنص الإدخال في استدعاء متزامن.
طلب HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:batchEmbedContents
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
model |
مطلوبة. اسم مورد النموذج. ويكون هذا بمثابة معرِّف للنموذج. يجب أن يتطابق هذا الاسم مع اسم الطراز الذي تعرضه طريقة تنسيق الملف: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"requests": [
{
object ( |
الحقول | |
---|---|
requests[] |
مطلوبة. طلبات تضمين الدفعة. يجب أن يتطابق النموذج في كل من هذه الطلبات مع النموذج المحدّد في |
نص الاستجابة
الردّ على BatchEmbedContentsRequest
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"embeddings": [
{
object ( |
الحقول | |
---|---|
embeddings[] |
النتائج فقط. عمليات التضمين لكل طلب، بالترتيب نفسه الوارد في الطلب المجمّع. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.
EmbedContentRequest
طلب يحتوي على Content
لكي يتم تضمينه في النموذج.
تمثيل JSON |
---|
{ "model": string, "content": { object ( |
الحقول | |
---|---|
model |
مطلوبة. اسم مورد النموذج. ويكون هذا بمثابة معرِّف للنموذج. يجب أن يتطابق هذا الاسم مع اسم الطراز الذي تعرضه طريقة تنسيق الملف: |
content |
مطلوبة. المحتوى المراد تضمينه. لن يتم احتساب سوى الحقول |
taskType |
اختياريّ. نوع المهمة الاختياري الذي سيتم استخدام التضمينات له. لا يمكن ضبطها إلا على |
title |
اختياريّ. تمثّل هذه السمة عنوانًا اختياريًا للنص. لا ينطبق ذلك إلا عندما يكون نوع TaskType هو ملاحظة: يؤدي تحديد |
outputDimensionality |
اختياريّ. بُعد اختياري مخفَّض من أجل تضمين الناتج. وفي حال ضبط هذه السياسة، يتم اقتطاع القيم الزائدة في تضمين الإخراج من النهاية. متوافق مع الطُرز الأحدث منذ 2024، ولا يمكن للطراز السابق ( |