יוצרת תשובה מהמודל בהינתן קלט GenerateContentRequest
.
יכולות הקלט משתנות בין מודלים שונים, כולל מודלים מכווננים. פרטים נוספים זמינים במדריך המודלים ובמדריך הכוונון.
בקשת HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
model |
חובה. השם של פורמט: |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "contents": [ { object ( |
שדות | |
---|---|
contents[] |
חובה. תוכן השיחה הנוכחית עם המודל. בשאילתות עם סיבוב אחד, מדובר באירוע יחיד. בשאילתות עם מספר פניות, זהו שדה חוזר שמכיל את היסטוריית השיחות + הבקשה האחרונה. |
tools[] |
זה שינוי אופציונלי. רשימה של
|
toolConfig |
זה שינוי אופציונלי. הגדרת הכלי לכל |
safetySettings[] |
זה שינוי אופציונלי. רשימה של מופעים ייחודיים של המדיניות הזו תיאכף ב |
systemInstruction |
זה שינוי אופציונלי. הוראת מערכת למפתחים. כרגע אפשר להשתמש רק בטקסט. |
generationConfig |
זה שינוי אופציונלי. אפשרויות תצורה ליצירת מודל ולפלט שלו. |
cachedContent |
זה שינוי אופציונלי. שם התוכן שנשמר במטמון שמשמש כהקשר להצגת החיזוי. הערה: משמש רק בשמירה מפורשת במטמון, שבה המשתמשים יכולים לשלוט בשמירה במטמון (למשל איזה תוכן לשמור במטמון) וליהנות מחיסכון מובטח בעלויות. פורמט: |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של 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
למידע נוסף, ראו סקירה כללית על אימות.