Method: models.generateMessage

MessagePrompt girişine sahip modelden bir yanıt oluşturur.

HTTP isteği

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateMessage

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

Yol parametreleri

Parametreler
model

string

Zorunlu. Kullanılacak modelin 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 
{
  "prompt": {
    object (MessagePrompt)
  },
  "temperature": number,
  "candidateCount": integer,
  "topP": number,
  "topK": integer
}
Alanlar
prompt

object (MessagePrompt)

Zorunlu. Modele istem olarak verilen yapılandırılmış metin girişi.

Model, istem verildiğinde tartışmadaki bir sonraki mesaj olduğunu tahmin ettiği şeyi döndürür.
temperature

number

İsteğe bağlı. Sonucun rastgeleliğini kontrol eder.

Değerler [0.0,1.0] aralığında olabilir (bu değerler dahil). 1.0 değerine yakın bir değer daha çeşitli yanıtlar üretirken 0.0 değerine yakın bir değer genellikle modelden daha az şaşırtıcı yanıt verilmesini sağlar.
candidateCount

integer

İsteğe bağlı. Döndürülecek oluşturulan yanıt mesajlarının sayısı.

Bu değer, [1, 8] (bu değerler dahil) arasında olmalıdır. Politika ayarlanmazsa bu politika varsayılan olarak 1 olur.
topP

number

İsteğe bağlı. Örnekleme sırasında dikkate alınacak jetonların maksimum kümülatif olasılığı.

Modelde, Top-k ve çekirdek örneklemesi birlikte kullanılır.

Çekirdek örneklemesi, olasılık toplamı en az topP olan en küçük jeton grubunu dikkate alır.
topK

integer

İsteğe bağlı. Örnekleme sırasında dikkate alınacak maksimum jeton sayısı.

Modelde, Top-k ve çekirdek örneklemesi birlikte kullanılır.

Top-k örneklemesi, en olası topK jeton grubunu dikkate alır.

Yanıt gövdesi

Modelden gelen yanıt.

Aday mesajları ve kronolojik olarak sıralanmış mesajlar biçimindeki görüşme geçmişi de buna dahildir.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "candidates": [
    {
      object (Message)
    }
  ],
  "messages": [
    {
      object (Message)
    }
  ],
  "filters": [
    {
      object (ContentFilter)
    }
  ]
}
Alanlar
candidates[]

object (Message)

Modelden alınan aday yanıt mesajları.
messages[]

object (Message)

Model tarafından kullanılan görüşme geçmişi.
filters[]

object (ContentFilter)

İstem ve yanıt metni için bir içerik filtreleme meta verileri grubu.

Bu metrik; bu yanıtta bir adayın hangi SafetyCategory tarafından engellendiğini, engellemeyi tetikleyen en düşük HarmProbability değerini ve ilgili kategorideki Zarar Eşik ayarını belirtir.

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.