Method: models.batchEmbedText

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

طلب HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:batchEmbedText

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

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

المَعلمات
model

string

مطلوبة. اسم Model المطلوب استخدامه لإنشاء تضمين. أمثلة: النماذج/embedding-gecko-001

نص الطلب

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

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

string

اختياريّ. تمثّل هذه السمة نصوص الإدخال الحرة التي سيحوّلها النموذج إلى محتوى مضمَّن. الحد الحالي هو 100 نص، وسيظهر خطأ عند تجاوزها.
requests[]

object (EmbedTextRequest)

اختياريّ. طلبات تضمين الدفعة. ويمكن ضبط سمة واحدة فقط من texts أو requests.

نص الاستجابة

الرد على embedTextRequest.

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

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

object (Embedding)

النتائج فقط. التضمينات التي تم إنشاؤها من النص المُدخَل.

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

يتطلب استخدام أحد نطاقات 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

لمزيد من المعلومات، راجع نظرة عامة على المصادقة.

EmbedTextRequest

طلب الحصول على نص مضمَّن من النموذج.

تمثيل JSON 
{
  "model": string,
  "text": string
}
الحقول
model

string

مطلوبة. اسم النموذج المطلوب استخدامه مع التنسيق model=models/{model}.
text

string

اختياريّ. نص الإدخال الحر الذي سيحوله النموذج إلى تضمين.