ב-Gemini API יש תמיכה בהעלאה של קובצי מדיה בנפרד מהקלט של ההנחיה, כך שיהיה אפשר לעשות שימוש חוזר במדיה בתגובה לכמה בקשות ולכמה הנחיות. פרטים נוספים זמינים במדריך הצגת הנחיות באמצעות מדיה.
שיטה: media.upload
יצירת File
.
נקודת קצה
- URI של העלאה, לבקשות להעלאת מדיה:
- URI של מטא-נתונים, לבקשות למטא-נתונים בלבד:
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
file
object (File
)
זה שינוי אופציונלי. המטא-נתונים של הקובץ שייווצר.
בקשה לדוגמה
תמונה
Python
Node.js
Go
קונכייה
אודיו
Python
Node.js
Go
קונכייה
טקסט
Python
Node.js
Go
קונכייה
וידאו
Python
Node.js
Go
קונכייה
Python
שיטה: files.get
הפונקציה מקבלת את המטא-נתונים של File
הנתון.
נקודת קצה
הורדה https://generativelanguage.googleapis.com/v1beta/{name=files/*}פרמטרים של נתיב
name
string
חובה. השם של ה-File
שרוצים לקבל. לדוגמה: files/abc-123
היא מופיעה בצורה files/{file}
.
גוף הבקשה
גוף הבקשה חייב להיות ריק.
דוגמה לבקשה
Python
Node.js
Go
קונכייה
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של File
.
שיטה: files.list
רשימה של המטא-נתונים של File
בבעלות הפרויקט המבקש.
נקודת קצה
הורדה https://generativelanguage.googleapis.com/v1beta/filesפרמטרים של שאילתה
pageSize
integer
זה שינוי אופציונלי. המספר המקסימלי של File
s שיוחזר בכל דף. אם לא צוין ערך, ברירת המחדל תהיה 10. המספר המקסימלי של pageSize
הוא 100.
pageToken
string
זה שינוי אופציונלי. אסימון דף מקריאה קודמת של files.list
.
גוף הבקשה
גוף הבקשה חייב להיות ריק.
דוגמה לבקשה
Python
Node.js
Go
קונכייה
השיטה: files.delete
מחיקה של File
.
נקודת קצה
מחיקת https://generativelanguage.googleapis.com/v1beta/{name=files/*}פרמטרים של נתיב
name
string
חובה. השם של ה-File
שרוצים למחוק. דוגמה: files/abc-123
הוא בפורמט files/{file}
.
גוף הבקשה
גוף הבקשה חייב להיות ריק.
דוגמה לבקשה
Python
Node.js
Go
קונכייה
גוף התשובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
Resource REST: קבצים
משאב: קובץ
קובץ שהועלה ל-API.
name
string
קבוע. מזהה. שם המשאב File
. המזהה (השם, לא כולל הקידומת 'files/') יכול להכיל עד 40 תווים אלפאנומריים באותיות קטנות או מקפים (-). המזהה לא יכול להתחיל או להסתיים במקף. אם השם יהיה ריק בזמן היצירה, המערכת תיצור שם ייחודי. לדוגמה: files/123-456
displayName
string
זה שינוי אופציונלי. השם המוצג של ה-File
, שקריא לבני אדם. אורך השם לתצוגה חייב להיות עד 512 תווים, כולל רווחים. דוגמה: 'תמונה של קבלת פנים'
mimeType
string
פלט בלבד. סוג ה-MIME של הקובץ.
sizeBytes
string (int64 format)
פלט בלבד. גודל הקובץ בבייטים.
createTime
string (Timestamp
format)
פלט בלבד. חותמת הזמן של מועד היצירה של File
.
חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z"
ו-"2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של File
.
חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z"
ו-"2014-10-02T15:01:23.045123456Z"
.
expirationTime
string (Timestamp
format)
פלט בלבד. חותמת הזמן של המועד שבו File
יימחק. מוגדר רק אם התוקף של File
עומד לפוג.
חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z"
ו-"2014-10-02T15:01:23.045123456Z"
.
sha256Hash
string (bytes format)
פלט בלבד. גיבוב SHA-256 של הבייטים שהועלו.
מחרוזת בקידוד base64.
uri
string
פלט בלבד. ה-URI של File
.
state
enum (State
)
פלט בלבד. סטטוס העיבוד של הקובץ.
error
object (Status
)
פלט בלבד. סטטוס השגיאה אם עיבוד הקובץ נכשל.
metadata
. מטא-נתונים של הקובץ. הערך של metadata
יכול להיות רק אחת מהאפשרויות הבאות:
videoMetadata
object (VideoMetadata
)
פלט בלבד. מטא-נתונים של סרטון.
ייצוג ב-JSON |
---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "state": enum ( |
VideoMetadata
מטא-נתונים של סרטון File
.
videoDuration
string (Duration
format)
משך הסרטון.
משך זמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s
'. דוגמה: "3.5s"
.
ייצוג JSON |
---|
{ "videoDuration": string } |
מדינה
מצבים במחזור החיים של קובץ.
טיפוסים בני מנייה (enum) | |
---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. המערכת משתמשת בערך הזה אם לא מציינים את המצב. |
PROCESSING |
הקובץ בתהליך עיבוד ואי אפשר עדיין להשתמש בו לצורך הסקת מסקנות. |
ACTIVE |
הקובץ מעובד וזמין להסקת מסקנות. |
FAILED |
עיבוד הקובץ נכשל. |
סטטוס
הסוג Status
מגדיר מודל שגיאות לוגי שמתאים לסביבות תכנות שונות, כולל ממשקי API ל-REST וממשקי API ל-RPC. הוא משמש את gRPC. כל הודעת Status
מכילה שלושה נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.
מידע נוסף על מודל השגיאות הזה ועל אופן העבודה איתו זמין במדריך לעיצוב API.
code
integer
קוד הסטטוס, שצריך להיות ערך enum של google.rpc.Code
.
message
string
הודעת שגיאה למפתחים, שצריכה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמשים צריכה להיות מותאמת לשוק המקומי ולשלוח אותה בשדה google.rpc.Status.details
או להתאים אותה לשוק המקומי.
details[]
object
רשימה של הודעות שמכילות את פרטי השגיאה. יש קבוצה משותפת של סוגי הודעות שאפשר להשתמש בהם בממשקי API.
אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type"
מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }
.
ייצוג JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |