Method: models.streamGenerateContent

GenerateContentRequest girişine sahip bir modelden akışlı yanıt oluşturur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
model

string

Zorunlu. Tamamlama oluşturmak için kullanılacak Model öğesinin adı.

Biçim: name=models/{model}.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
Alanlar
contents[]

object (Content)

Zorunlu. Modelle devam eden görüşmenin içeriği.

Tek dönüşlü sorgular için bu tek bir örnektir. Çok dönüşlü sorgularda bu, görüşme geçmişini ve en son isteği içeren tekrarlanan bir alandır.
safetySettings[]

object (SafetySetting)

İsteğe bağlı. Güvenli olmayan içerikleri engellemek için benzersiz SafetySetting örneklerinin listesi.

Bu, GenerateContentRequest.contents ve GenerateContentResponse.candidates'de zorunlu kılınacak. Her SafetyCategory türü için birden fazla ayar olmamalıdır. API, bu ayarlar tarafından belirlenen eşikleri karşılamayan içerikleri ve yanıtları engeller. Bu liste, SafetySettings'de belirtilen her bir SafetyCategory için varsayılan ayarları geçersiz kılar. Listede belirli bir SafetyCategory için SafetySetting yoksa API, bu kategorinin varsayılan güvenlik ayarını kullanır. Zarar kategorileri: HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT.
generationConfig

object (GenerationConfig)

İsteğe bağlı. Model oluşturma ve çıkışlar için yapılandırma seçenekleri.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, GenerateContentResponse örneğinden oluşan bir akış içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış bölümüne bakın.