Method: models.batchEmbedContents

تنشئ عدة عمليات تضمين من النموذج المحدد لنص الإدخال في استدعاء متزامن.

طلب HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:batchEmbedContents

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
model

string

مطلوبة. اسم مورد النموذج. ويكون هذا بمثابة معرِّف للنموذج.

يجب أن يتطابق هذا الاسم مع اسم الطراز الذي تعرضه طريقة models.list.

تنسيق الملف: models/{model}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
الحقول
requests[]

object (EmbedContentRequest)

مطلوبة. طلبات تضمين الدفعة. يجب أن يتطابق النموذج في كل من هذه الطلبات مع النموذج المحدّد في BatchEmbedContentsRequest.model.

نص الاستجابة

الردّ على BatchEmbedContentsRequest.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
الحقول
embeddings[]

object (ContentEmbedding)

النتائج فقط. عمليات التضمين لكل طلب، بالترتيب نفسه الوارد في الطلب المجمّع.

نطاقات التفويض

يتطلب استخدام أحد نطاقات 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 (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
الحقول
model

string

مطلوبة. اسم مورد النموذج. ويكون هذا بمثابة معرِّف للنموذج.

يجب أن يتطابق هذا الاسم مع اسم الطراز الذي تعرضه طريقة models.list.

تنسيق الملف: models/{model}
content

object (Content)

مطلوبة. المحتوى المراد تضمينه. لن يتم احتساب سوى الحقول parts.text.
taskType

enum (TaskType)

اختياريّ. نوع المهمة الاختياري الذي سيتم استخدام التضمينات له. لا يمكن ضبطها إلا على models/embedding-001.
title

string

اختياريّ. تمثّل هذه السمة عنوانًا اختياريًا للنص. لا ينطبق ذلك إلا عندما يكون نوع TaskType هو RETRIEVAL_DOCUMENT.

ملاحظة: يؤدي تحديد title لـ RETRIEVAL_DOCUMENT إلى توفير تضمينات ذات جودة أفضل لاستردادها.
outputDimensionality

integer

اختياريّ. بُعد اختياري مخفَّض من أجل تضمين الناتج. وفي حال ضبط هذه السياسة، يتم اقتطاع القيم الزائدة في تضمين الإخراج من النهاية. متوافق مع الطُرز الأحدث منذ 2024، ولا يمكن للطراز السابق (models/embedding-001) تحديد هذه القيمة.