Method: models.generateContent

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

בקשת HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}: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

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