Gemini API
ממשק Gemini API מאפשר למפתחים ליצור אפליקציות מבוססות-AI גנרטיבי באמצעות מודלים של Gemini. Gemini הוא המודל הכי מתקדם שלנו, והוא מולטי-מודאלי מלידתו. הוא יכול להכליל ולהבין בצורה חלקה סוגים שונים של מידע, כולל שפה, תמונות, אודיו, וידאו וקוד, לפעול על פיהם ולשלב ביניהם. אפשר להשתמש ב-Gemini API לתרחישי שימוש כמו הסקת מסקנות על סמך טקסט ותמונות, יצירת תוכן, סוכני דיאלוג, מערכות סיכום וסיווג ועוד.
- משאב REST: v1beta.auth_tokens
- משאב REST: v1beta.batches
- משאב REST: v1beta.cachedContents
- משאב REST: v1beta.corpora
- משאב REST: v1beta.corpora.operations
- משאב REST: v1beta.corpora.permissions
- מקור REST: v1beta.dynamic
- מקור REST: v1beta.environments
- משאב REST: v1beta.environments.files.media
- מקור REST: v1beta.fileSearchStores
- מקור REST: v1beta.fileSearchStores.documents
- משאב REST: v1beta.fileSearchStores.operations
- משאב REST: v1beta.fileSearchStores.upload.operations
- משאב REST: v1beta.files
- משאב REST: v1beta.generatedFiles
- משאב REST: v1beta.generatedFiles.operations
- משאב REST: v1beta.media
- מקור REST: v1beta.models
- מקור REST: v1beta.models.operations
- REST Resource: v1beta.tunedModels
- מקור REST: v1beta.tunedModels.operations
- מקור REST: v1beta.tunedModels.permissions
שירות: generativelanguage.googleapis.com
כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.
נקודת קצה של שירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) והיא: כל כתובות ה-URI שבהמשך הן יחסיות לנקודת הקצה הזו של השירות:
https://generativelanguage.googleapis.com
משאב REST: v1beta.auth_tokens
| Methods | |
|---|---|
create |
POST /v1beta/auth_tokens יוצר אסימון שאפשר להשתמש בו כדי להגביל את ההתנהגות של סשן BidiGenerateContent. |
משאב REST: v1beta.batches
| Methods | |
|---|---|
cancel |
POST /v1beta/{name=batches/*}:cancel מתחילה ביטול אסינכרוני של פעולה ממושכת. |
delete |
DELETE /v1beta/{name=batches/*} מחיקת פעולה ממושכת. |
get |
GET /v1beta/{name=batches/*} אחזור המצב העדכני של פעולה ממושכת. |
list |
GET /v1beta/{name=batches} רשימת הפעולות שתואמות למסנן שצוין בבקשה. |
updateEmbedContentBatch |
PATCH /v1beta/{embedContentBatch.name=batches/*}:updateEmbedContentBatch מעדכן אצווה של בקשות EmbedContent לעיבוד באצווה. |
updateGenerateContentBatch |
PATCH /v1beta/{generateContentBatch.name=batches/*}:updateGenerateContentBatch מעדכן אצווה של בקשות GenerateContent לעיבוד באצווה. |
משאב REST: v1beta.cachedContents
| Methods | |
|---|---|
create |
POST /v1beta/cachedContents יוצר משאב CachedContent. |
delete |
DELETE /v1beta/{name=cachedContents/*} מחיקת משאב CachedContent. |
get |
GET /v1beta/{name=cachedContents/*} קורא את המשאב CachedContent. |
list |
GET /v1beta/cachedContents Lists CachedContents. |
patch |
PATCH /v1beta/{cachedContent.name=cachedContents/*} עדכון המשאב CachedContent (אפשר לעדכן רק את התוקף). |
משאב REST: v1beta.fileSearchStores
| Methods | |
|---|---|
create |
POST /v1beta/fileSearchStores יוצר FileSearchStore ריק. |
delete |
DELETE /v1beta/{name=fileSearchStores/*} מוחק FileSearchStore. |
get |
GET /v1beta/{name=fileSearchStores/*} מקבל מידע על FileSearchStore ספציפי. |
importFile |
POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:importFile מייבא File משירות הקבצים אל FileSearchStore. |
list |
GET /v1beta/fileSearchStores רשימה של כל FileSearchStores שבבעלות המשתמש. |
משאב REST: v1beta.fileSearchStores.documents
| Methods | |
|---|---|
delete |
DELETE /v1beta/{name=fileSearchStores/*/documents/*} מוחק Document. |
get |
GET /v1beta/{name=fileSearchStores/*/documents/*} מקבל מידע על Document ספציפי. |
list |
GET /v1beta/{parent=fileSearchStores/*}/documents מציג את כל Documents בCorpus. |
משאב REST: v1beta.fileSearchStores.operations
| Methods | |
|---|---|
get |
GET /v1beta/{name=fileSearchStores/*/operations/*} אחזור המצב העדכני של פעולה ממושכת. |
משאב REST: v1beta.fileSearchStores.upload.operations
| Methods | |
|---|---|
get |
GET /v1beta/{name=fileSearchStores/*/upload/operations/*} אחזור המצב העדכני של פעולה ממושכת. |
משאב REST: v1beta.files
| Methods | |
|---|---|
delete |
DELETE /v1beta/{name=files/*} מוחק את File. |
get |
GET /v1beta/{name=files/*} הפונקציה מחזירה את המטא-נתונים של File נתון. |
list |
GET /v1beta/files מציג את המטא-נתונים של Files שבבעלות הפרויקט ששלח את הבקשה. |
register |
POST /v1beta/files:register רושם קבצים ב-Google Cloud Storage באמצעות FileService. |
משאב REST: v1beta.media
| Methods | |
|---|---|
download |
GET /v1beta/{parent=environments/*}/files מאחזר מטא-נתונים של קובץ או תוכן של ספרייה מתמונת מצב של סביבה. |
upload |
POST /v1beta/files POST /upload/v1beta/files יוצר File. |
uploadToFileSearchStore |
POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore POST /upload/v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore מעלה נתונים ל-FileSearchStore, מבצע עיבוד מקדים ופיצול לפני האחסון ב-FileSearchStore Document. |
משאב REST: v1beta.models
| Methods | |
|---|---|
asyncBatchEmbedContent |
POST /v1beta/{batch.model=models/*}:asyncBatchEmbedContent הוספת אצווה של EmbedContent בקשות לעיבוד באצווה. |
batchEmbedContents |
POST /v1beta/{model=models/*}:batchEmbedContents יוצרת כמה וקטורים של הטמעה מהקלט Content שכולל אצווה של מחרוזות שמיוצגות כאובייקטים EmbedContentRequest. |
batchGenerateContent |
POST /v1beta/{batch.model=models/*}:batchGenerateContent הוספת אצווה של GenerateContent בקשות לעיבוד באצווה. |
countTokens |
POST /v1beta/{model=models/*}:countTokens מפעילה את טוקנייזר של מודל על קלט Content ומחזירה את כמות הטוקנים. |
embedContent |
POST /v1beta/{model=models/*}:embedContent יוצר וקטור הטמעת טקסט מהקלט Content באמצעות מודל ההטמעה של Gemini שצוין. |
generateContent |
POST /v1beta/{model=models/*}:generateContent יצירת תשובה של מודל בהינתן קלט GenerateContentRequest. |
get |
GET /v1beta/{name=models/*} קבלת מידע על Model ספציפי, כמו מספר הגרסה, מגבלות הטוקנים, פרמטרים ומטא-נתונים אחרים. |
list |
GET /v1beta/models רשימה של Models שזמינים דרך Gemini API. |
predict |
POST /v1beta/{model=models/*}:predict מבצע בקשת חיזוי. |
predictLongRunning |
POST /v1beta/{model=models/*}:predictLongRunning זהה ל-Predict אבל מחזיר LRO. |
streamGenerateContent |
POST /v1beta/{model=models/*}:streamGenerateContent יוצרת תשובה בסטרימינג מהמודל בהינתן קלט GenerateContentRequest. |
משאב REST: v1beta.interactions
| Methods | |
|---|---|
CreateCredential |
POST /v1beta/credentials יצירת פרטי כניסה. |
CreateInteraction |
POST /v1beta/interactions יוצר אינטראקציה חדשה. |
cancelInteractionById |
POST /v1beta/interactions/{id}/cancel ביטול אינטראקציה לפי מזהה. |
ListCredentials |
GET /v1beta/credentials מציג את פרטי הכניסה לפרויקט. |
GetCredential |
GET /v1beta/credentials/{id} קבלת מטא-נתונים של פרטי כניסה יחידים (ללא שדות סודיים). |
getInteractionById |
GET /v1beta/interactions/{id} אחזור הפרטים המלאים של אינטראקציה יחידה על סמך `Interaction.id`. |
UpdateCredential |
PATCH /v1beta/credentials/{id} מעדכן פרטי כניסה. |
DeleteCredential |
DELETE /v1beta/credentials/{id} מחיקת פרטי כניסה. |
deleteInteraction |
DELETE /v1beta/interactions/{id} מוחק את האינטראקציה לפי מזהה. |
משאב REST: v1beta.agents
| Methods | |
|---|---|
CreateAgent |
POST /v1beta/agents יוצר סוכן חדש (גרסה עם הקלדה ל-SDK). |
ListAgents |
GET /v1beta/agents מציג את כל הסוכנים. |
GetAgent |
GET /v1beta/agents/{id} אחזור של סוכן ספציפי. |
DeleteAgent |
DELETE /v1beta/agents/{id} מחיקת סוכן. |
משאב REST: v1beta.webhooks
| Methods | |
|---|---|
CreateWebhook |
POST /v1beta/webhooks יוצר תגובה חדשה לפעולה מאתר אחר (webhook). |
PingWebhook |
POST /v1beta/webhooks/{id}:ping שליחת אירוע פינג ל-Webhook. |
RotateSigningSecret |
POST /v1beta/webhooks/{id}:rotateSigningSecret יוצר סוד חתימה חדש עבור תגובה לפעולה מאתר אחר (webhook). |
ListWebhooks |
GET /v1beta/webhooks מציג את כל ה-Webhooks. |
GetWebhook |
GET /v1beta/webhooks/{id} קבלת webhook ספציפי. |
UpdateWebhook |
PATCH /v1beta/webhooks/{id} מעדכן webhook קיים. |
DeleteWebhook |
DELETE /v1beta/webhooks/{id} מחיקת webhook. |
משאב REST: v1beta.triggers
| Methods | |
|---|---|
CreateTrigger |
POST /v1beta/triggers יוצר טריגר חדש שיפעיל את הסוכן שצוין לפי לוח הזמנים של cron. |
RunTrigger |
POST /v1beta/triggers/{trigger_id}/executions מפעיל טריגר באופן מיידי. |
ListTriggers |
GET /v1beta/triggers מציג רשימה של טריגרים לפרויקט. |
GetTrigger |
GET /v1beta/triggers/{id} קבלת פרטים של טריגר יחיד. |
ListTriggerExecutions |
GET /v1beta/triggers/{trigger_id}/executions מציג רשימה של הפעלות של טריגר. |
UpdateTrigger |
PATCH /v1beta/triggers/{id} מעדכן טריגר. |
DeleteTrigger |
DELETE /v1beta/triggers/{id} מחיקת טריגר. |
משאב REST: v1beta.environments
| Methods | |
|---|---|
CreateEnvironment |
POST /v1beta/environments יצירת סביבה. |
ListEnvironments |
GET /v1beta/environments מציג את הסביבות. |
GetEnvironmentFiles |
GET /v1beta/environments/{environment}/files/{path} מאחזר מטא-נתונים של קובץ או תוכן של ספרייה מתמונת מצב של סביבה. |
GetEnvironment |
GET /v1beta/environments/{id} קבלת סביבה. |
StartEnvironmentFileUpload |
PUT /upload/v1beta/environments/{environment}/files/{path} מתחיל סשן העלאה שניתן להמשיך עבור קובץ בסביבת עבודה. |
DeleteEnvironment |
DELETE /v1beta/environments/{id} מחיקת סביבה. |