יוצרות מספר הטמעות מהמודל של טקסט הקלט הנתון בהפעלה סינכרונית.
בקשת HTTP
POST https://generativelanguage.googleapis.com/v1/{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, והמודל הקודם ( |