Gemini API के ज़रिए, प्रॉम्प्ट इनपुट से अलग मीडिया फ़ाइलों को अलग से अपलोड किया जा सकता है. इससे आपके मीडिया को एक से ज़्यादा अनुरोधों और प्रॉम्प्ट में फिर से इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, मीडिया की मदद से प्रॉम्प्ट देना गाइड देखें.
तरीका: media.upload
यह File
बनाता है.
एंडपॉइंट
- मीडिया अपलोड करने के अनुरोधों के लिए, यूआरआई अपलोड करें:
https://generativelanguage.googleapis.com/upload/v1beta/files
- सिर्फ़ मेटाडेटा वाले अनुरोधों के लिए, मेटाडेटा यूआरआई:
https://generativelanguage.googleapis.com/v1beta/files
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
file
object (File
)
ज़रूरी नहीं. फ़ाइल बनाने के लिए मेटाडेटा.
अनुरोध का उदाहरण
इमेज
Python
Node.js
शुरू करें
शेल
ऑडियो
Python
Node.js
शुरू करें
शेल
टेक्स्ट
Python
Node.js
शुरू करें
शेल
वीडियो
Python
Node.js
शुरू करें
शेल
Python
तरीका: files.get
दिए गए File
के लिए मेटाडेटा लेता है.
एंडपॉइंट
पाएं
https://generativelanguage.googleapis.com/v1beta/{name=files/*}
पाथ पैरामीटर
name
string
ज़रूरी है. पाने के लिए File
का नाम. उदाहरण: files/abc-123
यह files/{file}
का रूप लेता है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
अनुरोध का उदाहरण
Python
Node.js
शुरू करें
शेल
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में File
का एक इंस्टेंस शामिल किया जाता है.
तरीका: files.list
यह अनुरोध करने वाले प्रोजेक्ट के मालिकाना हक वाले File
के मेटाडेटा की सूची बनाता है.
एंडपॉइंट
पाएं
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
को मिटाता है.
एंडपॉइंट
मिटाएं
https://generativelanguage.googleapis.com/v1beta/{name=files/*}
पाथ पैरामीटर
name
string
ज़रूरी है. मिटाए जाने वाले File
का नाम. उदाहरण: files/abc-123
यह files/{file}
का रूप लेता है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
अनुरोध का उदाहरण
Python
Node.js
शुरू करें
शेल
जवाब का मुख्य भाग
जवाब सही होने पर, जवाब का मुख्य हिस्सा खाली होता है.
REST रिसॉर्स: फ़ाइलें
संसाधन: फ़ाइल
एपीआई पर अपलोड की गई फ़ाइल.
name
string
इम्यूटेबल. आइडेंटिफ़ायर. File
संसाधन का नाम. आईडी ("फ़ाइलें/" प्रीफ़िक्स वाले नाम को छोड़कर) में ज़्यादा से ज़्यादा 40 वर्ण हो सकते हैं. ये अंग्रेज़ी के छोटे अक्षर, अंक, और डैश (-) होते हैं. आईडी, डैश से शुरू या खत्म नहीं हो सकता. अगर नाम बनाते समय कोई फ़ील्ड खाली है, तो एक यूनीक नाम जनरेट किया जाएगा. उदाहरण: files/123-456
displayName
string
ज़रूरी नहीं. File
का डिसप्ले नेम, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. डिसप्ले नेम में स्पेस के साथ-साथ 512 से ज़्यादा वर्ण नहीं होने चाहिए. उदाहरण: "वेलकम इमेज"
mimeType
string
सिर्फ़ आउटपुट के लिए. फ़ाइल का MIME प्रकार.
sizeBytes
string (int64 format)
सिर्फ़ आउटपुट के लिए. फ़ाइल का साइज़ बाइट में.
createTime
string (Timestamp
format)
सिर्फ़ आउटपुट के लिए. File
बनाए जाने के समय का टाइमस्टैंप.
आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों वाला फ़ॉर्मैट. उदाहरण: "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 यूटीसी "ज़ुलु" में टाइमस्टैंप और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों वाला फ़ॉर्मैट. उदाहरण: "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: ..., ... } ] } |