Method: models.generateText

Giriş mesajı verilen modelden bir yanıt oluşturur.

HTTP isteği

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

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

Yol parametreleri

Parametreler
model

string

Zorunlu. Tamamlamanın oluşturulması için kullanılacak Model veya TunedModel adı. Örnekler: modeller/metin-bison-001 requiredModels/cümle-Çevirmen-u3b7m

İstek içeriği

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

JSON gösterimi
{
  "prompt": {
    object (TextPrompt)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "stopSequences": [
    string
  ],
  "temperature": number,
  "candidateCount": integer,
  "maxOutputTokens": integer,
  "topP": number,
  "topK": integer
}
Alanlar
prompt

object (TextPrompt)

Zorunlu. Modele istem olarak verilen serbest biçimli giriş metni.

Model, istem verildiğinde giriş metni tamamlandığında tahmin ettiği bir Metin Tamamlama yanıtı oluşturur.

safetySettings[]

object (SafetySetting)

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

GenerateTextRequest.prompt ve GenerateTextResponse.candidates üzerinde 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 istemleri 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. Kısa mesaj hizmetinde HARM_CATEGORY_DEROGATORY, HARM_CATEGORY_TOXICITY, HARM_CATEGORY_VIOLENCE, HARM_CATEGORY_SEXUAL, HARM_CATEGORY_MEDICAL, HARM_CATEGORY_DANGEROUS zarar kategorileri desteklenir.

stopSequences[]

string

Çıkış oluşturmayı durduracak karakter dizisi grubu (en fazla 5). Bu parametre belirtilirse API, bir durdurma sırasının ilk görünümünde durur. Durma sırası yanıtın parçası olarak dahil edilmez.

temperature

number

İsteğe bağlı. Sonucun rastgeleliğini kontrol eder. Not: Varsayılan değer modele göre değişir. getModel işlevini döndüren Model Model.temperature özelliğine bakın.

Değerler [0,0,1,0] aralığında olabilir (bu değerler dahil). 1,0'a yakın bir değer daha çeşitli ve yaratıcı yanıtlar üretirken 0,0'a yakın bir değer genellikle modelden daha doğrudan yanıtlar verir.

candidateCount

integer

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

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

maxOutputTokens

integer

İsteğe bağlı. Bir adaya dahil edilecek maksimum jeton sayısı.

Politika ayarlanmazsa bu değer, Model spesifikasyonunda belirtilen çıkışTokenLimit değerini varsayılan olarak ayarlar.

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.

Jetonlar, atanma olasılıklarına göre sıralanır. Böylece yalnızca en olası jetonlar dikkate alınır. Top-k örneklemesi, dikkate alınacak maksimum jeton sayısını doğrudan sınırlarken Nucleus örneklemesi, jeton sayısını kümülatif olasılığa göre sınırlar.

Not: Varsayılan değer modele göre değişir. getModel işlevini döndüren Model Model.top_p özelliğine bakın.

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. Varsayılan olarak 40 değerine ayarlanır.

Not: Varsayılan değer modele göre değişir. getModel işlevini döndüren Model Model.top_k özelliğine bakın.

Yanıt gövdesi

Başarılıysa yanıt metni, GenerateTextResponse öğ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ış bölümüne bakın.