Gemini API के ज़रिए इमेज, ऑडियो, कोड, टूल वगैरह का इस्तेमाल करके कॉन्टेंट जनरेट किया जा सकता है. इनमें से हर सुविधा के बारे में जानकारी पाने के लिए, टास्क को ध्यान में रखकर बनाए गए सैंपल कोड को पढ़ें और देखें. इसके अलावा, यहां दी गई गाइड पढ़ें.
- टेक्स्ट जनरेट करना
- विज़न
- ऑडियो
- ज़्यादा जानकारी
- कोड लागू करना
- JSON मोड
- फ़ंक्शन कॉलिंग
- सिस्टम के लिए निर्देश
तरीका: model.generateContent
दिए गए इनपुट GenerateContentRequest
के आधार पर, मॉडल रिस्पॉन्स जनरेट करता है. इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, टेक्स्ट जनरेट करने से जुड़ी गाइड देखें. इनपुट सुविधाएं, अलग-अलग मॉडल के लिए अलग-अलग होती हैं. इनमें ट्यून किए जाने वाले मॉडल भी शामिल हैं. ज़्यादा जानकारी के लिए, मॉडल गाइड और ट्यूनिंग गाइड देखें.
एंडपॉइंट
पोस्ट
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
पाथ पैरामीटर
model
string
ज़रूरी है. नतीजे जनरेट करने के लिए इस्तेमाल किए जाने वाले Model
का नाम.
फ़ॉर्मैट: name=models/{model}
. यह models/{model}
का रूप लेता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
contents[]
object (Content
)
ज़रूरी है. मॉडल के साथ हुई मौजूदा बातचीत का कॉन्टेंट.
सिंगल-टर्न वाली क्वेरी के लिए, यह एक इंस्टेंस होता है. चैट जैसी कई बार की जाने वाली क्वेरी के लिए, यह दोहराया गया फ़ील्ड होता है. इसमें बातचीत का इतिहास और नए अनुरोध की जानकारी होती है.
tools[]
object (Tool
)
ज़रूरी नहीं. Tools
की सूची, जिसका इस्तेमाल Model
अगला जवाब जनरेट करने के लिए कर सकता है.
Tool
, कोड का एक हिस्सा होता है. इसकी मदद से सिस्टम, बाहरी सिस्टम से इंटरैक्ट कर पाता है, ताकि वह कोई कार्रवाई या कुछ कार्रवाइयां कर सके. यह कार्रवाई Model
के दायरे में नहीं आती. समर्थित Tool
s Function
और codeExecution
हैं. ज़्यादा जानने के लिए, फ़ंक्शन कॉलिंग और कोड लागू करने की सुविधा से जुड़ी गाइड देखें.
toolConfig
object (ToolConfig
)
ज़रूरी नहीं. अनुरोध में बताए गए किसी भी Tool
के लिए टूल कॉन्फ़िगरेशन. इस्तेमाल के उदाहरण के लिए, फ़ंक्शन कॉलिंग की गाइड देखें.
safetySettings[]
object (SafetySetting
)
ज़रूरी नहीं. असुरक्षित कॉन्टेंट को ब्लॉक करने वाले यूनीक SafetySetting
इंस्टेंस की सूची.
यह GenerateContentRequest.contents
और GenerateContentResponse.candidates
पर लागू किया जाएगा. हर SafetyCategory
टाइप के लिए एक से ज़्यादा सेटिंग नहीं होनी चाहिए. यह एपीआई ऐसे कॉन्टेंट और रिस्पॉन्स को ब्लॉक कर देगा जो इन सेटिंग के लिए तय थ्रेशोल्ड को पूरा नहीं कर पाते हैं. यह सूची, SafetySettings में दिए गए हर SafetyCategory
के लिए डिफ़ॉल्ट सेटिंग को बदल देती है. अगर सूची में दिए गए किसी SafetyCategory
के लिए कोई SafetySetting
नहीं है, तो एपीआई उस कैटगरी के लिए डिफ़ॉल्ट सुरक्षा सेटिंग का इस्तेमाल करेगा. नुकसान की कैटगरी HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT वाली कैटगरी. उपलब्ध सुरक्षा सेटिंग के बारे में ज़्यादा जानकारी के लिए, गाइड देखें. साथ ही, अपने एआई ऐप्लिकेशन में, सुरक्षा से जुड़ी ज़रूरी बातों का ध्यान रखने का तरीका जानने के लिए, सुरक्षा से जुड़े दिशा-निर्देश देखें.
systemInstruction
object (Content
)
ज़रूरी नहीं. डेवलपर ने सिस्टम से जुड़े निर्देश सेट किए हैं. फ़िलहाल, सिर्फ़ टेक्स्ट.
generationConfig
object (GenerationConfig
)
ज़रूरी नहीं. मॉडल जनरेशन और आउटपुट के लिए कॉन्फ़िगरेशन के विकल्प.
cachedContent
string
ज़रूरी नहीं. सुझाव देने के लिए, कॉन्टेक्स्ट के तौर पर इस्तेमाल करने के लिए कैश मेमोरी में सेव किए गए कॉन्टेंट का नाम. फ़ॉर्मैट: cachedContents/{cachedContent}
अनुरोध का उदाहरण
टेक्स्ट
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
इमेज
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
ऑडियो
Python
Node.js
शेल
वीडियो
Python
Node.js
शुरू करें
शेल
Python
शेल
चैट करें
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
कैश
Python
Node.js
ट्यून किया गया मॉडल
Python
JSON मोड
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
कोड लागू करें
Python
Kotlin
Java
फ़ंक्शन कॉलिंग
Python
Node.js
शेल
Kotlin
Swift
Dart
Java
कॉन्फ़िगरेशन जनरेट करें
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
सुरक्षा सेटिंग
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
सिस्टम के लिए निर्देश
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में GenerateContentResponse
का एक इंस्टेंस शामिल किया जाता है.
तरीका: Model.streamGenerateContent
दिए गए इनपुट GenerateContentRequest
से, मॉडल से स्ट्रीम किया गया जवाब जनरेट करता है.
एंडपॉइंट
पोस्ट
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:streamGenerateContent
पाथ पैरामीटर
model
string
ज़रूरी है. नतीजे जनरेट करने के लिए इस्तेमाल किए जाने वाले Model
का नाम.
फ़ॉर्मैट: name=models/{model}
. यह models/{model}
का रूप लेता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
contents[]
object (Content
)
ज़रूरी है. मॉडल के साथ हुई मौजूदा बातचीत का कॉन्टेंट.
सिंगल-टर्न वाली क्वेरी के लिए, यह एक इंस्टेंस होता है. चैट जैसी कई बार की जाने वाली क्वेरी के लिए, यह दोहराया गया फ़ील्ड होता है. इसमें बातचीत का इतिहास और नए अनुरोध की जानकारी होती है.
tools[]
object (Tool
)
ज़रूरी नहीं. Tools
की सूची, जिसका इस्तेमाल Model
अगला जवाब जनरेट करने के लिए कर सकता है.
Tool
, कोड का एक हिस्सा होता है. इसकी मदद से सिस्टम, बाहरी सिस्टम से इंटरैक्ट कर पाता है, ताकि वह कोई कार्रवाई या कुछ कार्रवाइयां कर सके. यह कार्रवाई Model
के दायरे में नहीं आती. समर्थित Tool
s Function
और codeExecution
हैं. ज़्यादा जानने के लिए, फ़ंक्शन कॉलिंग और कोड लागू करने की सुविधा से जुड़ी गाइड देखें.
toolConfig
object (ToolConfig
)
ज़रूरी नहीं. अनुरोध में बताए गए किसी भी Tool
के लिए टूल कॉन्फ़िगरेशन. इस्तेमाल के उदाहरण के लिए, फ़ंक्शन कॉलिंग की गाइड देखें.
safetySettings[]
object (SafetySetting
)
ज़रूरी नहीं. असुरक्षित कॉन्टेंट को ब्लॉक करने वाले यूनीक SafetySetting
इंस्टेंस की सूची.
यह GenerateContentRequest.contents
और GenerateContentResponse.candidates
पर लागू किया जाएगा. हर SafetyCategory
टाइप के लिए एक से ज़्यादा सेटिंग नहीं होनी चाहिए. यह एपीआई ऐसे कॉन्टेंट और रिस्पॉन्स को ब्लॉक कर देगा जो इन सेटिंग के लिए तय थ्रेशोल्ड को पूरा नहीं कर पाते हैं. यह सूची, SafetySettings में दिए गए हर SafetyCategory
के लिए डिफ़ॉल्ट सेटिंग को बदल देती है. अगर सूची में दिए गए किसी SafetyCategory
के लिए कोई SafetySetting
नहीं है, तो एपीआई उस कैटगरी के लिए डिफ़ॉल्ट सुरक्षा सेटिंग का इस्तेमाल करेगा. नुकसान की कैटगरी HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT वाली कैटगरी. उपलब्ध सुरक्षा सेटिंग के बारे में ज़्यादा जानकारी के लिए, गाइड देखें. साथ ही, अपने एआई ऐप्लिकेशन में, सुरक्षा से जुड़ी ज़रूरी बातों का ध्यान रखने का तरीका जानने के लिए, सुरक्षा से जुड़े दिशा-निर्देश देखें.
systemInstruction
object (Content
)
ज़रूरी नहीं. डेवलपर ने सिस्टम से जुड़े निर्देश सेट किए हैं. फ़िलहाल, सिर्फ़ टेक्स्ट.
generationConfig
object (GenerationConfig
)
ज़रूरी नहीं. मॉडल जनरेशन और आउटपुट के लिए कॉन्फ़िगरेशन के विकल्प.
cachedContent
string
ज़रूरी नहीं. सुझाव देने के लिए, कॉन्टेक्स्ट के तौर पर इस्तेमाल करने के लिए कैश मेमोरी में सेव किए गए कॉन्टेंट का नाम. फ़ॉर्मैट: cachedContents/{cachedContent}
अनुरोध का उदाहरण
टेक्स्ट
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
इमेज
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
ऑडियो
Python
शेल
वीडियो
Python
Node.js
शुरू करें
शेल
Python
शेल
चैट करें
Python
Node.js
शुरू करें
शेल
Kotlin
Swift
Dart
Java
जवाब का मुख्य भाग
कामयाब होने पर, जवाब के मुख्य हिस्से में GenerateContentResponse
की स्ट्रीम शामिल की जाती हैं.
GenerateContentResponse
उम्मीदवार के कई जवाबों का समर्थन करने वाले मॉडल से मिला जवाब.
GenerateContentResponse.prompt_feedback
में प्रॉम्प्ट और finishReason
और safetyRatings
में हर उम्मीदवार के लिए, सुरक्षा रेटिंग और कॉन्टेंट को फ़िल्टर करने की रिपोर्ट दी जाती है. API: - सभी या तो अनुरोध किए गए सभी या कोई भी उम्मीदवार नहीं दिखाता है - प्रॉम्प्ट में कोई गड़बड़ी होने पर ही कोई उम्मीदवार नहीं दिखाता है (promptFeedback
देखें) - finishReason
और safetyRatings
में हर उम्मीदवार के बारे में सुझाव देता है.
candidates[]
object (Candidate
)
मॉडल से उम्मीदवार के जवाब.
promptFeedback
object (PromptFeedback
)
यह विकल्प कॉन्टेंट के लिए फ़िल्टर के बारे में प्रॉम्प्ट का जवाब देता है.
usageMetadata
object (UsageMetadata
)
सिर्फ़ आउटपुट के लिए. जनरेट करने के अनुरोधों का मेटाडेटा टोकन के इस्तेमाल की जानकारी देता है.
JSON के काेड में दिखाना |
---|
{ "candidates": [ { object ( |
PromptFeedback
सुझाव, शिकायत या राय के मेटाडेटा का सेट, जिसके बारे में GenerateContentRequest.content
में बताया गया है.
blockReason
enum (BlockReason
)
ज़रूरी नहीं. अगर नीति को सेट किया जाता है, तो प्रॉम्प्ट को ब्लॉक कर दिया जाता है और कोई भी सुझाव नहीं दिखता है. प्रॉम्प्ट को नए तरीके से लिखें.
safetyRatings[]
object (SafetyRating
)
प्रॉम्प्ट की सुरक्षा के लिए रेटिंग. हर कैटगरी के लिए ज़्यादा से ज़्यादा एक रेटिंग है.
JSON के काेड में दिखाना |
---|
{ "blockReason": enum ( |
BlockReason
प्रॉम्प्ट को ब्लॉक किए जाने की वजह बताता है.
Enums | |
---|---|
BLOCK_REASON_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
SAFETY |
सुरक्षा के लिहाज़ से, प्रॉम्प्ट को ब्लॉक कर दिया गया है. safetyRatings की जांच करें और पता लगाएं कि इसे किस सुरक्षा कैटगरी ने ब्लॉक किया है. |
OTHER |
अज्ञात वजहों से प्रॉम्प्ट को ब्लॉक कर दिया गया. |
BLOCKLIST |
प्रॉम्प्ट को ब्लॉक कर दिया गया, क्योंकि इसमें शब्दावली की ब्लॉकलिस्ट में शामिल शब्द शामिल थे. |
PROHIBITED_CONTENT |
पाबंदी वाले कॉन्टेंट की वजह से प्रॉम्प्ट को ब्लॉक किया गया. |
UsageMetadata
जनरेट करने के अनुरोध में टोकन के इस्तेमाल से जुड़ा मेटाडेटा.
promptTokenCount
integer
प्रॉम्प्ट में टोकन की संख्या. cachedContent
को सेट करने पर भी, यही प्रॉम्प्ट का कुल असरदार साइज़ होता है. इसका मतलब है कि इसमें कैश मेमोरी में सेव किए गए कॉन्टेंट में टोकन की संख्या भी शामिल होती है.
cachedContentTokenCount
integer
प्रॉम्प्ट के कैश किए गए हिस्से में टोकन की संख्या (कैश मेमोरी में सेव किया गया कॉन्टेंट)
candidatesTokenCount
integer
जनरेट किए गए सभी रिस्पॉन्स कैंडिडेट के टोकन की कुल संख्या.
totalTokenCount
integer
जनरेट करने के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + रिस्पॉन्स कैंडिडेट).
JSON के काेड में दिखाना |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
उम्मीदवार
- JSON काेड में दिखाना
- FinishReason
- GroundingAttribution
- AttributionSourceId
- GroundingPassageId
- SemanticRetrieverChunk
मॉडल से जनरेट किया गया रिस्पॉन्स कैंडिडेट.
content
object (Content
)
सिर्फ़ आउटपुट के लिए. एआई से जनरेट किया गया कॉन्टेंट, मॉडल से दिखाया गया.
finishReason
enum (FinishReason
)
ज़रूरी नहीं. सिर्फ़ आउटपुट के लिए. मॉडल ने टोकन जनरेट करना क्यों बंद किया.
अगर यह खाली है, तो इसका मतलब है कि मॉडल ने टोकन जनरेट करना बंद नहीं किया है.
safetyRatings[]
object (SafetyRating
)
जवाब देने वाले उम्मीदवार की सुरक्षा के लिए रेटिंग की सूची.
हर कैटगरी के लिए ज़्यादा से ज़्यादा एक रेटिंग है.
citationMetadata
object (CitationMetadata
)
सिर्फ़ आउटपुट के लिए. मॉडल जनरेट किए गए उम्मीदवार के लिए उद्धरण की जानकारी.
इस फ़ील्ड में, content
में शामिल किसी भी टेक्स्ट के लिए, बोलकर सुनाने की जानकारी अपने-आप भर सकती है. ये ऐसे पैसेज हैं जिन्हें "पढ़कर" सुना जाता है बुनियादी एलएलएम के ट्रेनिंग डेटा में कॉपीराइट वाले कॉन्टेंट का डेटा शामिल किया गया है.
tokenCount
integer
सिर्फ़ आउटपुट के लिए. इस उम्मीदवार के लिए टोकन की संख्या.
groundingAttributions[]
object (GroundingAttribution
)
सिर्फ़ आउटपुट के लिए. तथ्यों पर आधारित जवाब देने वाले सोर्स की एट्रिब्यूशन जानकारी.
इस फ़ील्ड में GenerateAnswer
कॉल के लिए डेटा अपने-आप भर जाता है.
index
integer
सिर्फ़ आउटपुट के लिए. जवाब के उम्मीदवारों की सूची में उम्मीदवार का इंडेक्स.
JSON के काेड में दिखाना |
---|
{ "content": { object ( |
FinishReason
मॉडल ने टोकन जनरेट करना क्यों बंद किया, इसकी वजह बताता है.
Enums | |
---|---|
FINISH_REASON_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
STOP |
मॉडल का नैचुरल स्टॉप पॉइंट या स्टॉप का क्रम. |
MAX_TOKENS |
अनुरोध में, टोकन की ज़्यादा से ज़्यादा संख्या बताई गई है. |
SAFETY |
जवाब में उम्मीदवार के कॉन्टेंट को सुरक्षा के लिहाज़ से फ़्लैग किया गया था. |
RECITATION |
जवाब में जवाब देने के लिए इस्तेमाल किए जाने वाले कॉन्टेंट को, बार-बार दोहराए जाने की वजह से फ़्लैग किया गया था. |
LANGUAGE |
जवाब में उम्मीदवार के ऐसे कॉन्टेंट को फ़्लैग किया गया था जिसमें काम न करने वाली भाषा का इस्तेमाल किया गया था. |
OTHER |
इसकी वजह पता नहीं है. |
BLOCKLIST |
कॉन्टेंट में पाबंदी वाले शब्द होने की वजह से, टोकन जनरेट होना बंद हो गया. |
PROHIBITED_CONTENT |
ऐसे कॉन्टेंट के लिए टोकन जनरेट होने से रोका गया जिसमें पाबंदी वाला कॉन्टेंट हो सकता है. |
SPII |
टोकन जनरेट होने की प्रोसेस रुक गई, क्योंकि कॉन्टेंट में संवेदनशील व्यक्तिगत पहचान से जुड़ी जानकारी (एसपीआईआई) मौजूद हो सकती है. |
MALFORMED_FUNCTION_CALL |
इस मॉडल से जनरेट किया गया फ़ंक्शन कॉल अमान्य है. |
GroundingAttribution
जवाब देने में योगदान देने वाले सोर्स का एट्रिब्यूशन.
sourceId
object (AttributionSourceId
)
सिर्फ़ आउटपुट के लिए. इस एट्रिब्यूशन में योगदान देने वाले सोर्स का आइडेंटिफ़ायर.
content
object (Content
)
इस एट्रिब्यूशन को बनाने वाले सोर्स कॉन्टेंट को तथ्यों के साथ दिखाना.
JSON के काेड में दिखाना |
---|
{ "sourceId": { object ( |
AttributionSourceId
इस एट्रिब्यूशन में योगदान देने वाले सोर्स का आइडेंटिफ़ायर.
यूनियन फ़ील्ड source
.
source
इनमें से सिर्फ़ एक हो सकता है:
groundingPassage
object (GroundingPassageId
)
इनलाइन पैसेज के लिए आइडेंटिफ़ायर.
semanticRetrieverChunk
object (SemanticRetrieverChunk
)
सिमैंटिक रिट्रीवर की मदद से मिले Chunk
के आइडेंटिफ़ायर.
JSON के काेड में दिखाना |
---|
{ // Union field |
GroundingPassageId
GroundingPassage
में मौजूद किसी हिस्से का आइडेंटिफ़ायर.
passageId
string
सिर्फ़ आउटपुट के लिए. GenerateAnswerRequest
के GroundingPassage.id
से मेल खाने वाले पैसेज का आईडी.
partIndex
integer
सिर्फ़ आउटपुट के लिए. GenerateAnswerRequest
के GroundingPassage.content
में मौजूद हिस्से का इंडेक्स.
JSON के काेड में दिखाना |
---|
{ "passageId": string, "partIndex": integer } |
SemanticRetrieverChunk
SemanticRetrieverConfig
का इस्तेमाल करके, GenerateAnswerRequest
में मौजूद सिमैंटिक रिट्रीवर की मदद से मिले Chunk
का आइडेंटिफ़ायर.
source
string
सिर्फ़ आउटपुट के लिए. अनुरोध के SemanticRetrieverConfig.source
से मेल खाने वाले सोर्स का नाम. उदाहरण: corpora/123
या corpora/123/documents/abc
chunk
string
सिर्फ़ आउटपुट के लिए. उस Chunk
का नाम जिसमें एट्रिब्यूट किया गया टेक्स्ट है. उदाहरण: corpora/123/documents/abc/chunks/xyz
JSON के काेड में दिखाना |
---|
{ "source": string, "chunk": string } |
CitationMetadata
कॉन्टेंट के किसी हिस्से के लिए सोर्स एट्रिब्यूशन का कलेक्शन.
citationSources[]
object (CitationSource
)
किसी खास जवाब के लिए सोर्स के उद्धरण.
JSON के काेड में दिखाना |
---|
{
"citationSources": [
{
object ( |
CitationSource
किसी खास जवाब के किसी हिस्से के लिए सोर्स के लिए उद्धरण.
startIndex
integer
ज़रूरी नहीं. इस सोर्स से मिले जवाब के सेगमेंट का शुरुआती हिस्सा.
इंडेक्स, सेगमेंट की शुरुआत की जानकारी देता है. इसे बाइट में मापा जाता है.
endIndex
integer
ज़रूरी नहीं. एट्रिब्यूट किए गए सेगमेंट का आखिरी हिस्सा, खास नहीं.
uri
string
ज़रूरी नहीं. वह यूआरआई जिसे टेक्स्ट के किसी हिस्से के सोर्स के तौर पर एट्रिब्यूट किया गया है.
license
string
ज़रूरी नहीं. GitHub प्रोजेक्ट का लाइसेंस, जिसे सेगमेंट के सोर्स के तौर पर एट्रिब्यूट किया गया है.
कोड का इस्तेमाल करने के लिए, लाइसेंस की जानकारी देना ज़रूरी है.
JSON के काेड में दिखाना |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
GenerationConfig
मॉडल जनरेशन और आउटपुट के लिए कॉन्फ़िगरेशन के विकल्प. सभी पैरामीटर को हर मॉडल के लिए कॉन्फ़िगर नहीं किया जा सकता.
stopSequences[]
string
ज़रूरी नहीं. वर्ण क्रम (ज़्यादा से ज़्यादा पांच) का सेट, जिसकी वजह से आउटपुट जनरेट होना बंद हो जाएगा. अगर बताया गया है, तो एपीआई stop_sequence
के पहली बार दिखने पर बंद हो जाएगा. रोकने के क्रम को जवाब के हिस्से के रूप में शामिल नहीं किया जाएगा.
responseMimeType
string
ज़रूरी नहीं. उम्मीदवार के जनरेट किए गए टेक्स्ट का MIME टाइप. इस्तेमाल किए जा सकने वाले MIME टाइप: text/plain
: (डिफ़ॉल्ट) टेक्स्ट आउटपुट. application/json
: रिस्पॉन्स कैंडिडेट में JSON रिस्पॉन्स. इस्तेमाल किए जा सकने वाले सभी टेक्स्ट MIME टाइप की सूची के लिए दस्तावेज़ देखें.
responseSchema
object (Schema
)
ज़रूरी नहीं. जनरेट किए गए कैंडिडेट टेक्स्ट का आउटपुट स्कीमा. स्कीमा, OpenAPI स्कीमा का सबसेट होना चाहिए. साथ ही, ये ऑब्जेक्ट, प्रिमिटिव या अरे हो सकते हैं.
अगर यह नीति सेट की जाती है, तो साथ काम करने वाला responseMimeType
भी सेट होना चाहिए. साथ काम करने वाले MIME टाइप: application/json
: JSON से मिले रिस्पॉन्स के लिए स्कीमा. ज़्यादा जानकारी के लिए, JSON टेक्स्ट जनरेट करने की गाइड देखें.
candidateCount
integer
ज़रूरी नहीं. दिए जाने वाले, जनरेट किए गए जवाबों की संख्या.
फ़िलहाल, यह वैल्यू सिर्फ़ एक पर सेट की जा सकती है. अगर यह नीति सेट नहीं है, तो इसकी डिफ़ॉल्ट वैल्यू 1 होगी.
maxOutputTokens
integer
ज़रूरी नहीं. रिस्पॉन्स कैंडिडेट में शामिल किए जाने वाले टोकन की ज़्यादा से ज़्यादा संख्या.
ध्यान दें: मॉडल के हिसाब से डिफ़ॉल्ट वैल्यू अलग-अलग होती है. getModel
फ़ंक्शन से मिले Model
के लिए Model.output_token_limit
एट्रिब्यूट देखें.
temperature
number
ज़रूरी नहीं. इससे आउटपुट की रैंडमनेस को कंट्रोल किया जाता है.
ध्यान दें: मॉडल के हिसाब से डिफ़ॉल्ट वैल्यू अलग-अलग होती है. getModel
फ़ंक्शन से मिले Model
के लिए Model.temperature
एट्रिब्यूट देखें.
वैल्यू [0.0, 2.0] के बीच हो सकती है.
topP
number
ज़रूरी नहीं. सैंपल बनाते समय, टोकन की कुल कितनी संभावना पर विचार किया जाना चाहिए.
यह मॉडल, टॉप-के और टॉप-पी (न्यूक्लियस) के सैंपल का इस्तेमाल करता है.
टोकन, असाइन की गई क्षमताओं के हिसाब से क्रम में लगाए जाते हैं, ताकि सबसे ज़्यादा संभावना वाले टोकन ही इस्तेमाल किए जा सकें. टॉप-के सैंपलिंग पर विचार करने के लिए, टोकन की ज़्यादा से ज़्यादा संख्या को सीधे तौर पर सीमित किया जाता है, जबकि न्यूक्लियस सैंपलिंग कुल प्रॉबबिलिटी के आधार पर टोकन की संख्या को सीमित करता है.
ध्यान दें: Model
के हिसाब से डिफ़ॉल्ट वैल्यू अलग-अलग होती है और getModel
फ़ंक्शन से मिली Model.top_p
एट्रिब्यूट से तय होती है. खाली topK
एट्रिब्यूट का मतलब है कि यह मॉडल, टॉप-के सैंपलिंग को लागू नहीं करता है. साथ ही, यह अनुरोधों के लिए topK
को सेट करने की अनुमति नहीं देता है.
topK
integer
ज़रूरी नहीं. सैंपल लेने के दौरान, शामिल किए जाने वाले टोकन की ज़्यादा से ज़्यादा संख्या.
Gemini मॉडल, टॉप-p (न्यूक्लियस) सैंपलिंग या टॉप-के और न्यूक्लियस सैंपलिंग के कॉम्बिनेशन का इस्तेमाल करते हैं. टॉप-K सैंपलिंग, topK
के सबसे संभावित टोकन के सेट के हिसाब से काम करती है. न्यूक्लियस सैंपलिंग के साथ चल रहे मॉडल, TopK सेटिंग की अनुमति नहीं देते.
ध्यान दें: Model
के हिसाब से डिफ़ॉल्ट वैल्यू अलग-अलग होती है और getModel
फ़ंक्शन से मिली Model.top_p
एट्रिब्यूट से तय होती है. खाली topK
एट्रिब्यूट का मतलब है कि यह मॉडल, टॉप-के सैंपलिंग को लागू नहीं करता है. साथ ही, यह अनुरोधों के लिए topK
को सेट करने की अनुमति नहीं देता है.
JSON के काेड में दिखाना |
---|
{
"stopSequences": [
string
],
"responseMimeType": string,
"responseSchema": {
object ( |
HarmCategory
रेटिंग की कैटगरी.
इन कैटगरी में, नुकसान पहुंचाने वाले कई तरह के नुकसान के बारे में बताया गया है. इन नुकसानों में, डेवलपर बदलाव कर सकते हैं.
Enums | |
---|---|
HARM_CATEGORY_UNSPECIFIED |
कैटगरी की जानकारी नहीं है. |
HARM_CATEGORY_DEROGATORY |
पहचान और/या सुरक्षित एट्रिब्यूट को टारगेट करने वाली नेगेटिव या नुकसान पहुंचाने वाली टिप्पणियां. |
HARM_CATEGORY_TOXICITY |
ऐसा कॉन्टेंट जिसमें असभ्य, अपमानजनक या अपशब्दों का इस्तेमाल किया गया हो. |
HARM_CATEGORY_VIOLENCE |
किसी व्यक्ति या ग्रुप के ख़िलाफ़ हिंसा दिखाने की स्थितियों या खून-खराबे को सामान्य तरीके से बताने वाले वीडियो के बारे में बताता है. |
HARM_CATEGORY_SEXUAL |
सेक्शुअल ऐक्ट या भद्दा कॉन्टेंट के रेफ़रंस शामिल हैं. |
HARM_CATEGORY_MEDICAL |
ऐसी मेडिकल सलाह को बढ़ावा देता है जिसकी जांच नहीं की जा सकती. |
HARM_CATEGORY_DANGEROUS |
खतरनाक गतिविधियों वाला ऐसा कॉन्टेंट जो नुकसान पहुंचाने वाली गतिविधियों का प्रमोशन करता हो, उन्हें लागू करना आसान बनाता हो या उन्हें बढ़ावा देता हो. |
HARM_CATEGORY_HARASSMENT |
उत्पीड़न से जुड़ा कॉन्टेंट. |
HARM_CATEGORY_HATE_SPEECH |
नफ़रत फैलाने वाली भाषा और कॉन्टेंट. |
HARM_CATEGORY_SEXUALLY_EXPLICIT |
साफ़ तौर पर सेक्शुअल ऐक्ट दिखाने वाला कॉन्टेंट. |
HARM_CATEGORY_DANGEROUS_CONTENT |
खतरनाक कॉन्टेंट. |
SafetyRating
कॉन्टेंट के किसी हिस्से के लिए सुरक्षा रेटिंग.
सुरक्षा रेटिंग में, कॉन्टेंट के किसी हिस्से के लिए, नुकसान की कैटगरी और नुकसान की संभावना का लेवल शामिल होता है. सुरक्षा के लिहाज़ से, कॉन्टेंट को नुकसान की कई कैटगरी में बांटा गया है. साथ ही, नुकसान की संभावना को यहां शामिल किया गया है.
category
enum (HarmCategory
)
ज़रूरी है. इस रेटिंग की कैटगरी.
probability
enum (HarmProbability
)
ज़रूरी है. इस कॉन्टेंट को नुकसान होने की कितनी संभावना है.
blocked
boolean
क्या इस रेटिंग की वजह से इस कॉन्टेंट को ब्लॉक किया गया?
JSON के काेड में दिखाना |
---|
{ "category": enum ( |
नुकसान की संभावना
इस बात की संभावना कि कॉन्टेंट का कोई हिस्सा नुकसान पहुंचा सकता है.
कॉन्टेंट की कैटगरी तय करने वाला सिस्टम, कॉन्टेंट के असुरक्षित होने की संभावना बताता है. हालांकि, इससे कॉन्टेंट के किसी हिस्से के लिए हुए नुकसान की गंभीरता का पता नहीं चलता है.
Enums | |
---|---|
HARM_PROBABILITY_UNSPECIFIED |
संभावना की जानकारी नहीं दी गई है. |
NEGLIGIBLE |
कॉन्टेंट के असुरक्षित होने की संभावना बहुत कम होती है. |
LOW |
कॉन्टेंट के असुरक्षित होने की संभावना कम होती है. |
MEDIUM |
कॉन्टेंट के असुरक्षित होने की सामान्य संभावना होती है. |
HIGH |
कॉन्टेंट के असुरक्षित होने की संभावना काफ़ी ज़्यादा होती है. |
SafetySetting
सुरक्षा सेटिंग, जिससे सुरक्षा पर रोक लगाने के व्यवहार पर असर पड़ता है.
किसी कैटगरी के लिए सुरक्षा सेटिंग पास करने पर, कॉन्टेंट के ब्लॉक होने की अनुमति मिल जाती है.
category
enum (HarmCategory
)
ज़रूरी है. इस सेटिंग की कैटगरी.
threshold
enum (HarmBlockThreshold
)
ज़रूरी है. इससे उस प्रॉबबिलिटी थ्रेशोल्ड को कंट्रोल किया जाता है जिस पर नुकसान को रोका गया हो.
JSON के काेड में दिखाना |
---|
{ "category": enum ( |
HarmBlockThreshold
नुकसान की संभावना के हिसाब से या उससे कहीं ज़्यादा ब्लॉक करें.
Enums | |
---|---|
HARM_BLOCK_THRESHOLD_UNSPECIFIED |
थ्रेशोल्ड की जानकारी नहीं दी गई है. |
BLOCK_LOW_AND_ABOVE |
छोटे अक्षरों में लिखा कॉन्टेंट दिखाने की अनुमति दी जाएगी. |
BLOCK_MEDIUM_AND_ABOVE |
नीगल और कम शब्दों वाली सामग्री को मंज़ूरी दी जाएगी. |
BLOCK_ONLY_HIGH |
नीगल, कम, और मध्यम आकार वाले कॉन्टेंट को अनुमति दी जाएगी. |
BLOCK_NONE |
हर तरह का कॉन्टेंट दिखाने की अनुमति होगी. |