Yanıtları kontrol etmek için model yapılandırmasını kullanma

Bir modele yapılan her çağrıda, modelin nasıl yanıt oluşturacağını kontrol etmek için model yapılandırması gönderebilirsiniz. Her model, maxOutputTokens ayarını belirleme veya düşünme, yanıt biçimleri, resimler ya da konuşma için özel yapılandırmalar gibi farklı yapılandırma seçeneklerini destekler.

Gemini modeline erişirken çoğu kullanım alanında modeli GenerationConfig kullanarak yapılandırırsınız. Ancak Gemini Live API modeli yapılandırıyorsanız LiveGenerationConfig kullanırsınız.

Bu sayfada, Gemini modellerinin yapılandırmasının nasıl ayarlanacağı gösterilmekte ve her parametrenin açıklaması verilmektedir.

Gemini yapılandırmasına git Gemini Live API yapılandırmasına git

Gemini model için GenerationConfig

Bu sayfada sağlayıcıya özel içerikleri ve kodu görüntülemek için Gemini API sağlayıcınızı tıklayın.

Genel kullanım modelleri, görüntü üretme modelleri ("Nano Banana" modelleri) ve metin okuma (TTS) modelleri dahil olmak üzere Gemini modellerin çoğu için GenerationConfig belirleyin.

Yapılandırma, GenerativeModel örneği kullanım ömrü boyunca korunur. Farklı bir yapılandırma kullanmak istiyorsanız farklı bir yapılandırmaya sahip yeni bir örnek oluşturup kullanın.

Swift

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


import FirebaseAILogic

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
let config = GenerationConfig(
  maxOutputTokens: 200,
  stopSequences: ["red"]
)

// Initialize the Gemini Developer API backend service.
// Specify the config as part of creating the `GenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: config
)

// ...

Kotlin

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
val config = generationConfig {
    maxOutputTokens = 200
    stopSequences = listOf("red")
}

// Initialize the Gemini Developer API backend service.
// Specify the config as part of creating the `GenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
    modelName = "GEMINI_MODEL_NAME",
    generationConfig = config
)

// ...

Java

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
GenerationConfig.Builder configBuilder = new GenerationConfig.Builder();
configBuilder.maxOutputTokens = 200;
configBuilder.stopSequences = List.of("red");

GenerationConfig config = configBuilder.build();

// Specify the config as part of creating the `GenerativeModel` instance.
GenerativeModelFutures model = GenerativeModelFutures.from(
        FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel(
                    "GEMINI_MODEL_NAME",
                    config
                );
);

// ...

Web

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
const generationConfig = {
  maxOutputTokens: 200,
  stopSequences: ["red"],
};

// Specify the config as part of creating the `GenerativeModel` instance.
const model = getGenerativeModel(ai, { model: "GEMINI_MODEL_NAME",  generationConfig });

// ...

Dart

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
final generationConfig = GenerationConfig(
  maxOutputTokens: 200,
  stopSequences: ["red"],
);

// Initialize the Gemini Developer API backend service.
// Specify the config as part of creating the `GenerativeModel` instance.
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_MODEL_NAME',
  config: generationConfig,
);

// ...

Unity

GenerativeModel örneği oluşturma kapsamında GenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `GenerationConfig`.
// IMPORTANT: Example values shown here. Make sure to update for your use case.
// For the latest general-use Gemini models, the following parameters are now unsupported:
// temperature, top-K, top-P, frequency penalty, presence penalty, and candidate count
var generationConfig = new GenerationConfig(
  maxOutputTokens: 200,
  stopSequences: new string[] { "red" }
);

// Initialize the Gemini Developer API backend service.
// Specify the config as part of creating the `GenerativeModel` instance.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
var model = ai.GetGenerativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: generationConfig
);

Her parametrenin açıklamasını bu sayfanın sonraki bölümünde bulabilirsiniz.

Google AI Studio kullanarak istemler ve model yapılandırmalarıyla denemeler yapabilirsiniz.

Gemini Live API model için LiveGenerationConfig

Bu sayfada sağlayıcıya özel içerikleri ve kodu görüntülemek için Gemini API sağlayıcınızı tıklayın.

LiveGenerationConfig yalnızca Gemini Live API modelleri kullanılırken ayarlayın.

Yapılandırma, LiveModel örneği kullanım ömrü boyunca korunur. Farklı bir yapılandırma kullanmak istiyorsanız farklı bir yapılandırmaya sahip yeni bir örnek oluşturup kullanın.

Swift

LiveModel örneği başlatılırken liveGenerationConfig içindeki parametrelerin değerlerini ayarlayın:


// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
let config = LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: [.audio],
  speech: SpeechConfig(voiceName: "Fenrir"),
)

// Specify the config as part of creating the `liveModel` instance.
let liveModel = FirebaseAI.firebaseAI(backend: .googleAI()).liveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  generationConfig: config
)

// ...

Kotlin

LiveModel örneği oluşturma kapsamında LiveGenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
val config = liveGenerationConfig {
    maxOutputTokens = 200
    responseModality = ResponseModality.AUDIO
    speechConfig = SpeechConfig(voice = Voice("FENRIR"))
}

// Specify the config as part of creating the `LiveModel` instance.
val liveModel = Firebase.ai(backend = GenerativeBackend.agentPlatform()).liveModel(
    modelName = "GEMINI_LIVE_MODEL_NAME",
    generationConfig = config
)

// ...

Java

LiveModel örneği oluşturma kapsamında LiveGenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
LiveGenerationConfig.Builder configBuilder = new LiveGenerationConfig.Builder();
configBuilder.setMaxOutputTokens(200);
configBuilder.setResponseModality(ResponseModality.AUDIO);

configBuilder.setSpeechConfig(new SpeechConfig(new Voice("FENRIR")));

LiveGenerationConfig config = configBuilder.build();

// Specify the config as part of creating the `LiveModel` instance.
LiveGenerativeModel lm = FirebaseAI.getInstance(GenerativeBackend.googleAI()).liveModel(
          "GEMINI_LIVE_MODEL_NAME",
          config
);

// ...

Web

LiveGenerativeModel örneği başlatılırken LiveGenerationConfig içindeki parametrelerin değerlerini ayarlayın:


// ...

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
const liveGenerationConfig = {
  maxOutputTokens: 200,
  responseModalities: [ResponseModality.AUDIO],
  speechConfig: {
    voiceConfig: {
      prebuiltVoiceConfig: { voiceName: "Fenrir" },
    },
  },
};

// Specify the config as part of creating the `LiveGenerativeModel` instance.
const liveModel = getLiveGenerativeModel(ai, {
  model: "GEMINI_LIVE_MODEL_NAME",
  liveGenerationConfig,
});

// ...

Dart

LiveGenerativeModel örneği oluşturma kapsamında LiveGenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
final config = LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: [ResponseModalities.audio],
  speechConfig: SpeechConfig(voiceName: 'Fenrir'),
);

// Specify the config as part of creating the `liveGenerativeModel` instance.
final liveModel = FirebaseAI.googleAI().liveGenerativeModel(
  model: 'GEMINI_LIVE_MODEL_NAME',
  liveGenerationConfig: config,
);

// ...

Unity

LiveModel örneği oluşturma kapsamında LiveGenerationConfig içindeki parametrelerin değerlerini ayarlayın.


// ...

// Set parameter values in a `LiveGenerationConfig` (example values shown here).
var config = new LiveGenerationConfig(
  maxOutputTokens: 200,
  responseModalities: new[] { ResponseModality.Audio },
  speechConfig: SpeechConfig.UsePrebuiltVoice("Fenrir")
);

// Specify the config as part of creating the `LiveModel` instance.
var liveModel = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetLiveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  liveGenerationConfig: config
);

// ...

Her parametrenin açıklamasını bu sayfanın sonraki bölümünde bulabilirsiniz.

Google AI Studio kullanarak istemler ve model yapılandırmalarıyla denemeler yapabilirsiniz.


Parametrelerin açıklaması

Aşağıdaki tabloda, kullanılabilen parametrelerle ilgili genel bir bakış sunulmaktadır. Bazı parametreler yalnızca belirli modeller için geçerlidir.

Parametre Açıklama Sınırlamalar Varsayılan değer
Ses zaman damgası
audioTimestamp 		Yalnızca ses içeren giriş dosyalarında zaman damgası anlaşılmasını sağlar.

Boole

Yalnızca GenerativeModel yapılandırması kullanılırken ve giriş türü yalnızca ses içeren bir dosyayken geçerlidir.

false
Maksimum çıkış jetonu sayısı
maxOutputTokens 		Yanıt oluşturulurken kullanılabilecek maksimum jeton sayısını belirtir. --- ---
Durdurma dizileri
stopSequences 		Modelin, yanıtta bu dizelerden biriyle karşılaşması durumunda içerik oluşturmayı durdurmasını sağlayan bir dizeler listesi belirtir.

Yalnızca GenerativeModel yapılandırması kullanılırken geçerlidir.

Görüntü modelleri ("Nano Banana") veya TTS modelleri için geçerli değildir.

---
Özel yapılandırmalar
Düşünme
thinkingConfig

Modeller yanıt oluştururken "düşünme sürecini" kontrol eder.

  • Düşünme seviyesi (Gemini 3.x ve sonraki modeller) kullanarak modelin yapabileceği düşünme miktarını kontrol edin.
  • Düşünce özetlerinin dahil edilip edilmeyeceğini kontrol edin.

Desteklenen değerler: Düşünme dokümanlarına bakın.

TTS modelleri için geçerli değildir.

Firebase AI Logic, Live API modelleri için thinkingConfig ayarlanmasını henüz desteklememektedir.

Modele bağlıdır
Yanıt biçimleri
responseModalities 		Çıkış türünü (ör. metin, ses veya resim) belirtir. Yalnızca Gemini görüntü modelleri ("Nano Banana" modelleri), TTS modelleri ve Live API modelleri kullanılırken geçerlidir (ve zorunludur). ---
Resim özellikleri
imageConfig 		Oluşturulan resimlerin en-boy oranını ve çözünürlüğünü belirtir.

Desteklenen değerler: Resim oluşturmayı yapılandırma başlıklı makaleyi inceleyin.

Yalnızca Gemini görüntü modelleri ("Nano Banana" modelleri) kullanılırken geçerlidir.

1:1 en boy oranı (kare)
1.024x1.024 çözünürlük
Konuşma (ses)
speechConfig 		Ses çıkışı için kullanılan sesi belirtir. Yalnızca TTS modelleri ve Live API modelleri kullanılırken geçerlidir.

TTS modelleri için gereklidir. 		Puck


İçerik oluşturmayı kontrol etme ile ilgili diğer seçenekler

  • İstem tasarımı hakkında daha fazla bilgi edinin. Böylece modeli, ihtiyaçlarınıza özel çıkışlar oluşturması için etkileyebilirsiniz.
  • Nefret söylemi ve müstehcen içerik de dahil olmak üzere zararlı olarak kabul edilebilecek yanıtlar alma olasılığını ayarlamak için güvenlik ayarlarını kullanın.
  • Modelin davranışını yönlendirmek için sistem talimatları ayarlayın. Bu özellik, model son kullanıcıdan başka talimatlar almadan önce eklediğiniz bir giriş gibidir.
  • Belirli bir çıkış şeması belirtmek için istemle birlikte bir yanıt şeması iletin. Bu özellik en çok JSON çıkışı oluştururken kullanılır ancak sınıflandırma görevleri için de kullanılabilir (ör. modelin belirli etiketler veya tag'ler kullanmasını istediğinizde).