Method: models.streamGenerateContent

GenerateContentRequest इनपुट दिए गए मॉडल से स्ट्रीम किया गया रिस्पॉन्स जनरेट करता है.

एचटीटीपी अनुरोध

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:streamGenerateContent

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
model

string

ज़रूरी है. पूरा होने की प्रोसेस जनरेट करने के लिए, Model का नाम.

फ़ॉर्मैट: name=models/{model}.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
फ़ील्ड
contents[]

object (Content)

ज़रूरी है. मॉडल के साथ मौजूदा बातचीत का कॉन्टेंट.

एक टर्न वाली क्वेरी के लिए, यह सिर्फ़ एक इंस्टेंस है. एक से ज़्यादा मोड़ वाली क्वेरी के लिए, यह दोहराया गया फ़ील्ड होता है, जिसमें बातचीत का इतिहास और नया अनुरोध होता है.
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 काम करती हैं.
generationConfig

object (GenerationConfig)

ज़रूरी नहीं. मॉडल जनरेट करने और आउटपुट के लिए कॉन्फ़िगरेशन के विकल्प.

जवाब का मुख्य भाग

कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में GenerateContentResponse इंस्टेंस की स्ट्रीम शामिल होती है.

अनुमति देने के दायरे

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.