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 |
Zorunlu. Tamamlamanın oluşturulması için kullanılacak |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{ "prompt": { object ( |
Alanlar | |
---|---|
prompt |
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[] |
İsteğe bağlı. Güvenli olmayan içerikleri engellemek için benzersiz
|
stopSequences[] |
Çı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 |
İsteğe bağlı. Sonucun rastgeleliğini kontrol eder. Not: Varsayılan değer modele göre değişir. 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 |
İ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 |
İsteğe bağlı. Bir adaya dahil edilecek maksimum jeton sayısı. Politika ayarlanmazsa bu değer, |
topP |
İ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. |
topK |
İ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ı Not: Varsayılan değer modele göre değişir. |
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.