Method: tunedModels.generateContent

יוצרות תשובה מהמודל בהינתן קלט GenerateContentRequest.

יכולות הקלט שונות בין המודלים, כולל המודלים המכווננים. לפרטים יש לעיין במדריך למודלים ובמדריך הכוונון.

בקשת HTTP

POST https://generativelanguage.googleapis.com/v1/{model=tunedModels/*}:generateContent

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
model

string

חובה. השם של ה-Model שישמש ליצירת ההשלמה.

פורמט: name=models/{model}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
שדות
contents[]

object (Content)

חובה. תוכן השיחה הנוכחית עם המודל.

בשאילתות עם סיבוב אחד, מדובר במופע יחיד. בשאילתות שנשלחות במספר פניות, זהו שדה חוזר שמכיל את היסטוריית השיחות ואת הבקשה האחרונה.
safetySettings[]

object (SafetySetting)

זה שינוי אופציונלי. רשימה של מופעים ייחודיים של SafetySetting לחסימת תוכן לא בטוח.

ההגדרה הזו תיאכף בGenerateContentRequest.contents ובGenerateContentResponse.candidates. אסור שתהיה יותר מהגדרה אחת לכל סוג של SafetyCategory. ה-API יחסום תכנים ותגובות שלא עומדים בדרישות הסף שהוגדרו בהגדרות האלה. הרשימה הזו מבטלת את הגדרות ברירת המחדל לכל SafetyCategory שצוין בהגדרות הבטיחות. אם לא צוין SafetySetting ל-SafetyCategory מסוים ברשימה, ה-API ישתמש בהגדרת האבטחה שהוגדרה כברירת מחדל לקטגוריה הזו. יש תמיכה בקטגוריות הפגיעה HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT.
generationConfig

object (GenerationConfig)

זה שינוי אופציונלי. אפשרויות תצורה ליצירה ולפלט של מודלים.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של GenerateContentResponse.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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

מידע נוסף זמין בסקירה הכללית על אימות.