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

אפשרות. טקסט הקלט בפריסה גמישה שהמודל יהפוך להטמעה.