Generative Language API

בעזרת Gemini API, מפתחים יכולים לפתח אפליקציות של בינה מלאכותית גנרטיבית באמצעות מודלים של Gemini. Gemini הוא המודל הכי משוכלל שלנו, תוכנן מהיסוד תוך התמקדות בריבוי מצבים. הכלי יכול לכלול מידע כללי, ולהבין אותו, לפעול בו ולשלב סוגים שונים של מידע, כולל שפה, תמונות, אודיו, וידאו וקוד. אתם יכולים להשתמש ב-Gemini API לתרחישים לדוגמה כמו הסקת מסקנות בטקסט ובתמונות, יצירת תוכן, סוכנים לדו-שיח, מערכות סיכום וסיווג ועוד.

שירות: generativelanguage.googleapis.com

כדי להתקשר לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, עליכם להשתמש במידע הבא בזמן שליחת בקשות ה-API.

מסמך Discovery

מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולשימוש של ממשקי API בארכיטקטורת REST. אפשר להשתמש בו כדי ליצור ספריות לקוח, יישומי פלאגין של סביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד עשוי לספק כמה מסמכי גילוי. השירות הזה מספק את מסמכי הגילוי הבאים:

נקודת קצה (endpoint) של שירות

נקודת קצה (endpoint) של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoint) של שירות. השירות הזה כולל את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI שבהמשך הם יחסיים לנקודת הקצה הזו של השירות:

  • https://generativelanguage.googleapis.com

משאב ב-REST: v1beta.cachedContents

שיטות
create POST /v1beta/cachedContents
יצירת משאב של CachedContent.
delete DELETE /v1beta/{name=cachedContents/*}
מחיקת המשאב CachedContent.
get GET /v1beta/{name=cachedContents/*}
קריאת המשאב CachedContent.
list GET /v1beta/cachedContents
מפרטת את קובצי CachedContent.
patch PATCH /v1beta/{cachedContent.name=cachedContents/*}
מעדכן את המשאב CachedContent (אפשר לעדכן רק את התפוגה).

משאב REST: v1beta.corpora

שיטות
create POST /v1beta/corpora
הפונקציה יוצרת Corpus ריק.
delete DELETE /v1beta/{name=corpora/*}
נמחק Corpus.
get GET /v1beta/{name=corpora/*}
קבלת מידע על Corpus ספציפי.
list GET /v1beta/corpora
רשימה של כל Corpora שבבעלות המשתמש.
patch PATCH /v1beta/{corpus.name=corpora/*}
עדכון של Corpus.
query POST /v1beta/{name=corpora/*}:query
מבצעת חיפוש סמנטי בCorpus.

משאב REST: v1beta.corpora.documents

שיטות
create POST /v1beta/{parent=corpora/*}/documents
הפונקציה יוצרת Document ריק.
delete DELETE /v1beta/{name=corpora/*/documents/*}
נמחק Document.
get GET /v1beta/{name=corpora/*/documents/*}
קבלת מידע על Document ספציפי.
list GET /v1beta/{parent=corpora/*}/documents
רשימה של כל Document הפריטים בCorpus.
patch PATCH /v1beta/{document.name=corpora/*/documents/*}
עדכון של Document.
query POST /v1beta/{name=corpora/*/documents/*}:query
מבצעת חיפוש סמנטי בDocument.

משאב REST: v1beta.corpora.documents.chunks

שיטות
batchCreate POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchCreate
יצירת אצווה של Chunks.
batchDelete POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete
מחיקה בכמות גדולה של Chunk שניות.
batchUpdate POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchUpdate
חבילת עדכונים Chunks.
create POST /v1beta/{parent=corpora/*/documents/*}/chunks
הפונקציה יוצרת Chunk.
delete DELETE /v1beta/{name=corpora/*/documents/*/chunks/*}
נמחק Chunk.
get GET /v1beta/{name=corpora/*/documents/*/chunks/*}
קבלת מידע על Chunk ספציפי.
list GET /v1beta/{parent=corpora/*/documents/*}/chunks
רשימה של כל Chunk הפריטים בDocument.
patch PATCH /v1beta/{chunk.name=corpora/*/documents/*/chunks/*}
עדכון של Chunk.

משאב REST: v1beta.corpora.permissions

שיטות
create POST /v1beta/{parent=corpora/*}/permissions
יוצרים הרשאה למשאב ספציפי.
delete DELETE /v1beta/{name=corpora/*/permissions/*}
ההרשאה תימחק.
get GET /v1beta/{name=corpora/*/permissions/*}
קבלת מידע על הרשאה ספציפית.
list GET /v1beta/{parent=corpora/*}/permissions
פירוט ההרשאות למשאב הספציפי.
patch PATCH /v1beta/{permission.name=corpora/*/permissions/*}
עדכון ההרשאה.

משאב REST: v1beta.files

שיטות
delete DELETE /v1beta/{name=files/*}
מוחק את File.
get GET /v1beta/{name=files/*}
קבלת המטא-נתונים של File הנתון.
list GET /v1beta/files
פירוט המטא-נתונים של File בבעלות הפרויקט שממנו נשלחה הבקשה.

משאב REST: v1beta.media

שיטות
upload POST /v1beta/files
POST /upload/v1beta/files
נוצר File.

משאב REST: v1beta.models

שיטות
batchEmbedContents POST /v1beta/{model=models/*}:batchEmbedContents
יוצרת הטמעות מרובות מהמודל בהינתן טקסט קלט בקריאה סנכרונית.
batchEmbedText POST /v1beta/{model=models/*}:batchEmbedText
יוצרת הטמעות מרובות מהמודל בהינתן טקסט קלט בקריאה סנכרונית.
countMessageTokens POST /v1beta/{model=models/*}:countMessageTokens
מריצה את כלי ההמרה לאסימונים של מודל על מחרוזת ומחזירה את מספר האסימונים.
countTextTokens POST /v1beta/{model=models/*}:countTextTokens
מריצה את כלי ההמרה לאסימונים של מודל על טקסט, ומחזירה את מספר האסימונים.
countTokens POST /v1beta/{model=models/*}:countTokens
מריצה את ההמרה לאסימונים של מודל בתוכן הקלט, ומחזירה את מספר האסימונים.
embedContent POST /v1beta/{model=models/*}:embedContent
יוצרת הטמעה מהמודל בהינתן קלט Content.
embedText POST /v1beta/{model=models/*}:embedText
יוצרת הטמעה מהמודל כשמוצגת הודעת קלט.
generateAnswer POST /v1beta/{model=models/*}:generateAnswer
נוצרת תשובה בסיסית מהמודל בהינתן הקלט GenerateAnswerRequest.
generateContent POST /v1beta/{model=models/*}:generateContent
יוצרת תשובה מהמודל בהינתן קלט GenerateContentRequest.
generateMessage POST /v1beta/{model=models/*}:generateMessage
יוצרת תשובה מהמודל בהינתן קלט MessagePrompt.
generateText POST /v1beta/{model=models/*}:generateText
יוצרת תשובה מהמודל כשמזינים הודעת קלט.
get GET /v1beta/{name=models/*}
קבלת מידע על דגם ספציפי.
list GET /v1beta/models
בתיבת הדו-שיח הזו מפורטים מודלים שזמינים דרך ה-API.
streamGenerateContent POST /v1beta/{model=models/*}:streamGenerateContent
יוצרת תשובה בסטרימינג מהמודל בהינתן קלט GenerateContentRequest.

משאב ב-REST: v1beta.tunedModels

שיטות
create POST /v1beta/tunedModels
יצירת מודל מכוונן.
delete DELETE /v1beta/{name=tunedModels/*}
מחיקת מודל מכוונן.
generateContent POST /v1beta/{model=tunedModels/*}:generateContent
יוצרת תשובה מהמודל בהינתן קלט GenerateContentRequest.
generateText POST /v1beta/{model=tunedModels/*}:generateText
יוצרת תשובה מהמודל כשמזינים הודעת קלט.
get GET /v1beta/{name=tunedModels/*}
קבלת מידע על דגם ספציפי של כוונון.
list GET /v1beta/tunedModels
רשימת המודלים המכווננים שבבעלות המשתמש.
patch PATCH /v1beta/{tunedModel.name=tunedModels/*}
עדכון מודל מכוונן.
transferOwnership POST /v1beta/{name=tunedModels/*}:transferOwnership
העברת הבעלות על המודל המכוונן.

משאב ב-REST: v1beta.tunedModels.permissions

שיטות
create POST /v1beta/{parent=tunedModels/*}/permissions
יוצרים הרשאה למשאב ספציפי.
delete DELETE /v1beta/{name=tunedModels/*/permissions/*}
ההרשאה תימחק.
get GET /v1beta/{name=tunedModels/*/permissions/*}
קבלת מידע על הרשאה ספציפית.
list GET /v1beta/{parent=tunedModels/*}/permissions
פירוט ההרשאות למשאב הספציפי.
patch PATCH /v1beta/{permission.name=tunedModels/*/permissions/*}
עדכון ההרשאה.

משאב REST: v1.models

שיטות
batchEmbedContents POST /v1/{model=models/*}:batchEmbedContents
יוצרת הטמעות מרובות מהמודל בהינתן טקסט קלט בקריאה סנכרונית.
countTokens POST /v1/{model=models/*}:countTokens
מריצה את ההמרה לאסימונים של מודל בתוכן הקלט, ומחזירה את מספר האסימונים.
embedContent POST /v1/{model=models/*}:embedContent
יוצרת הטמעה מהמודל בהינתן קלט Content.
generateContent POST /v1/{model=models/*}:generateContent
יוצרת תשובה מהמודל בהינתן קלט GenerateContentRequest.
get GET /v1/{name=models/*}
קבלת מידע על דגם ספציפי.
list GET /v1/models
בתיבת הדו-שיח הזו מפורטים מודלים שזמינים דרך ה-API.
streamGenerateContent POST /v1/{model=models/*}:streamGenerateContent
יוצרת תשובה בסטרימינג מהמודל בהינתן קלט GenerateContentRequest.

משאב REST: v1.operations

שיטות
delete DELETE /v1/{name=operations/**}
מחיקת פעולה ממושכת.
list GET /v1/{name}
בתיבת הדו-שיח הזו מפורטים פעולות שתואמות למסנן שצוין בבקשה.

משאב REST: v1.tunedModels

שיטות
generateContent POST /v1/{model=tunedModels/*}:generateContent
יוצרת תשובה מהמודל בהינתן קלט GenerateContentRequest.

משאב REST: v1.tunedModels.operations

שיטות
cancel POST /v1/{name=tunedModels/*/operations/*}:cancel
התחלת ביטול אסינכרוני בפעולה ממושכת.
get GET /v1/{name=tunedModels/*/operations/*}
מקבלים את המצב העדכני של פעולה ממושכת.
list GET /v1/{name=tunedModels/*}/operations
בתיבת הדו-שיח הזו מפורטים פעולות שתואמות למסנן שצוין בבקשה.