Method: models.embedText

تنشئ تضمينًا من النموذج الذي يتلقى رسالة إدخال.

طلب HTTP

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

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

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

المَعلمات
model

string

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

نص الطلب

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

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

string

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

نص الاستجابة

الرد على embedTextRequest.

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

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

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

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