Method: tunedModels.generateContent

GenerateContentRequest girişi verilen modelden bir yanıt oluşturur.

HTTP isteği

POST https://generativelanguage.googleapis.com/v1beta/{model=tunedModels/*}:generateContent

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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

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

object (Content)

Zorunlu. Modelle yapılan geçerli 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 son isteği içeren tekrarlanan bir alandır.

tools[]

object (Tool)

İsteğe bağlı. Modelin bir sonraki yanıtı oluşturmak için kullanabileceği Tools listesi.

Tool, sistemin bilgi ve modelin kapsamı dışında bir işlem veya işlem kümesi gerçekleştirmek için harici sistemlerle etkileşim kurmasını sağlayan bir kod parçasıdır. Şu anda desteklenen tek araç Function.

toolConfig

object (ToolConfig)

İsteğe bağlı. İstekte belirtilen herhangi bir Tool için araç yapılandırması.

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'da 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 tüm 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 sağlanmamışsa API, söz konusu 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.

systemInstruction

object (Content)

İsteğe bağlı. Geliştirici tarafından belirlenen sistem talimatı. Şu anda yalnızca metin kullanılabilir.

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ıysa yanıt metni, GenerateContentResponse öğesinin bir örneğini 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ış sayfasına göz atın.