Gemini API, प्रॉम्प्ट इनपुट से अलग मीडिया फ़ाइलों को अपलोड करने की सुविधा देता है. इससे, आपके मीडिया का इस्तेमाल कई अनुरोधों और प्रॉम्प्ट में फिर से किया जा सकता है. ज़्यादा जानकारी के लिए, मीडिया की मदद से प्रॉम्प्ट देना गाइड देखें.
तरीका: media.upload
यह File
बनाता है.
एंडपॉइंट
- मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
- सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में यह डेटा होता है:
file
object (File
)
ज़रूरी नहीं. जिस फ़ाइल को बनाना है उसका मेटाडेटा.
अनुरोध का उदाहरण
इमेज
Python
Node.js
शुरू करें
शेल
ऑडियो
Python
Node.js
शुरू करें
शेल
टेक्स्ट
Python
Node.js
शुरू करें
शेल
वीडियो
Python
Node.js
शुरू करें
शेल
Python
तरीका: files.get
दिए गए File
के लिए मेटाडेटा लाता है.
एंडपॉइंट
get https://generativelanguage.googleapis.com/v1beta/{name=files/*}पाथ पैरामीटर
name
string
ज़रूरी है. जिस File
को पाने के लिए यह फ़ंक्शन इस्तेमाल करना है उसका नाम. उदाहरण: files/abc-123
यह files/{file}
के तौर पर दिखता है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
अनुरोध का उदाहरण
Python
Node.js
शुरू करें
शेल
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में File
का एक इंस्टेंस शामिल किया जाता है.
तरीका: files.list
अनुरोध करने वाले प्रोजेक्ट के मालिकाना हक वाले File
के मेटाडेटा की सूची दिखाता है.
एंडपॉइंट
get https://generativelanguage.googleapis.com/v1beta/filesक्वेरी पैरामीटर
pageSize
integer
ज़रूरी नहीं. प्रति पेज वापस देने के लिए File
की अधिकतम संख्या. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से 10 सेट हो जाती है. pageSize
की ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है.
pageToken
string
ज़रूरी नहीं. किसी पिछले files.list
कॉल से मिला पेज टोकन.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
अनुरोध का उदाहरण
Python
Node.js
शुरू करें
शेल
जवाब का मुख्य भाग
files.list
का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
files[]
object (File
)
File
की सूची.
nextPageToken
string
एक टोकन, जिसे अगले files.list
कॉल में pageToken
के तौर पर भेजा जा सकता है.
JSON के काेड में दिखाना |
---|
{
"files": [
{
object ( |
तरीका: files.delete
File
को मिटाता है.
एंडपॉइंट
delete https://generativelanguage.googleapis.com/v1beta/{name=files/*}पाथ पैरामीटर
name
string
ज़रूरी है. मिटाए जाने वाले File
का नाम. उदाहरण: files/abc-123
यह files/{file}
का रूप लेता है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
अनुरोध का उदाहरण
Python
Node.js
शुरू करें
शेल
जवाब का मुख्य भाग
जवाब सही होने पर, जवाब का मुख्य हिस्सा खाली होता है.
REST रिसॉर्स: files
रिसॉर्स: फ़ाइल
एपीआई पर अपलोड की गई फ़ाइल.
name
string
इम्यूटेबल. आइडेंटिफ़ायर. File
रिसॉर्स का नाम. आईडी ("फ़ाइलें/" प्रीफ़िक्स वाले नाम को छोड़कर) में 40 वर्ण हो सकते हैं. ये अंग्रेज़ी के छोटे अक्षर, अंक, और डैश (-) होते हैं. आईडी, डैश से शुरू या खत्म नहीं हो सकता. अगर खाता बनाते समय कोई नाम नहीं दिया जाता है, तो एक यूनीक नाम जनरेट किया जाएगा. उदाहरण: files/123-456
displayName
string
ज़रूरी नहीं. File
के लिए, ऐसा डिसप्ले नेम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. स्पेस के साथ डिसप्ले नेम की लंबाई 512 से ज़्यादा वर्ण नहीं होनी चाहिए. उदाहरण: "वेलकम इमेज"
mimeType
string
सिर्फ़ आउटपुट के लिए. फ़ाइल का MIME प्रकार.
sizeBytes
string (int64 format)
सिर्फ़ आउटपुट के लिए. फ़ाइल का साइज़ बाइट में.
createTime
string (Timestamp
format)
सिर्फ़ आउटपुट के लिए. File
बनाने का टाइमस्टैंप.
आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z"
और "2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
सिर्फ़ आउटपुट के लिए. उस टाइमस्टैंप का टाइमस्टैंप जब File
को आखिरी बार अपडेट किया गया था.
आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण के लिए: "2014-10-02T15:01:23Z"
और "2014-10-02T15:01:23.045123456Z"
.
expirationTime
string (Timestamp
format)
सिर्फ़ आउटपुट के लिए. File
को मिटाए जाने का टाइमस्टैंप. सिर्फ़ तब सेट करें, जब File
की समयसीमा खत्म होने वाली है.
आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z"
और "2014-10-02T15:01:23.045123456Z"
.
sha256Hash
string (bytes format)
सिर्फ़ आउटपुट के लिए. अपलोड किए गए बाइट का SHA-256 हैश.
base64 कोड में बदली गई स्ट्रिंग.
uri
string
सिर्फ़ आउटपुट के लिए. 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 } |
स्थिति
किसी फ़ाइल के लाइफ़साइकल की स्थितियां.
Enums | |
---|---|
STATE_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू. अगर स्थिति को छोड़ दिया जाता है, तो इस मान का इस्तेमाल किया जाता है. |
PROCESSING |
फ़ाइल प्रोसेस की जा रही है. फ़िलहाल, इसका इस्तेमाल अनुमान लगाने के लिए नहीं किया जा सकता. |
ACTIVE |
फ़ाइल को प्रोसेस कर दिया गया है और यह अनुमान लगाने के लिए उपलब्ध है. |
FAILED |
फ़ाइल प्रोसेस नहीं की जा सकी. |
स्थिति
Status
टाइप, लॉजिकल एरर मॉडल के बारे में बताता है, जो अलग-अलग प्रोग्रामिंग एनवायरमेंट के लिए सही होता है. इनमें REST API और RPC एपीआई शामिल हैं. इसका इस्तेमाल gRPC करता है. हर Status
मैसेज में तीन तरह का डेटा होता है: गड़बड़ी का कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.
आपको एपीआई डिज़ाइन गाइड में, गड़बड़ी वाले इस मॉडल और इसके साथ काम करने के तरीके के बारे में ज़्यादा जानकारी मिल सकती है.
code
integer
स्टेटस कोड, जो google.rpc.Code
की enum वैल्यू होनी चाहिए.
message
string
डेवलपर को भेजा जाने वाला गड़बड़ी का मैसेज, जो अंग्रेज़ी में होना चाहिए. उपयोगकर्ता को दिखने वाला गड़बड़ी का कोई भी मैसेज, स्थानीय भाषा में होना चाहिए और उसे google.rpc.Status.details
फ़ील्ड में भेजा जाना चाहिए. इसके अलावा, क्लाइंट भी उसे स्थानीय भाषा में बदल सकता है.
details[]
object
उन मैसेज की सूची जिनमें गड़बड़ी की जानकारी होती है. एपीआई के लिए, मैसेज टाइप का एक सामान्य सेट होता है.
ऐसा ऑब्जेक्ट जिसमें किसी भी तरह के फ़ील्ड शामिल हो सकते हैं. एक अन्य फ़ील्ड "@type"
में, टाइप की पहचान करने वाला यूआरआई होता है. उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }
.
JSON के काेड में दिखाना |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |