google-genai/com.google.genai.types/GenerateContentConfig

GenerateContentConfig

public abstract class GenerateContentConfig extends JsonSerializable

Optional model configuration parameters.

For more information, see `Content generation parameters `_.

Constructors

public void GenerateContentConfig()

Types

Builder

public abstract class Builder

Builder for GenerateContentConfig.

Properties

MAX_READ_LENGTH_PROPERTY

public final static String MAX_READ_LENGTH_PROPERTY

System property to override the default max JSON string length (20MB) in read constraints.

Functions

audioTimestamp

public abstract Optional<Boolean> audioTimestamp()

If enabled, audio timestamp will be included in the request to the model.

automaticFunctionCalling

public abstract Optional<AutomaticFunctionCallingConfig> automaticFunctionCalling()

The configuration for automatic function calling.

builder

public static GenerateContentConfig.Builder builder()

Instantiates a builder for GenerateContentConfig.

cachedContent

public abstract Optional<String> cachedContent()

Resource name of a context cache that can be used in subsequent requests.

candidateCount

public abstract Optional<Integer> candidateCount()

Number of response variations to return.

enableEnhancedCivicAnswers

public abstract Optional<Boolean> enableEnhancedCivicAnswers()

Enables enhanced civic answers.

frequencyPenalty

public abstract Optional<Float> frequencyPenalty()

Positive values penalize tokens that repeatedly appear in the generated text, increasing the probability of generating more diverse content.

fromJson

public static GenerateContentConfig fromJson(String jsonString)

Deserializes a JSON string to a GenerateContentConfig object.

fromJsonNode

@InternalApi()

public static T fromJsonNode<T extends JsonSerializable>(JsonNode jsonNode, Class<T> clazz)

Deserializes a JsonNode to an object of the given type.

fromJsonString

@InternalApi()

public static T fromJsonString<T extends JsonSerializable>(String jsonString, Class<T> clazz)

Deserializes a Json string to an object of the given type.

httpOptions

public abstract Optional<HttpOptions> httpOptions()

Used to override HTTP request options.

imageConfig

public abstract Optional<ImageConfig> imageConfig()

The image generation configuration.

labels

public abstract Optional<Map<String, String>> labels()

Labels with user-defined metadata to break down billed charges.

logprobs

public abstract Optional<Integer> logprobs()

Number of top candidate tokens to return the log probabilities for at each generation step.

maxOutputTokens

public abstract Optional<Integer> maxOutputTokens()

Maximum number of tokens that can be generated in the response.

mediaResolution

public abstract Optional<MediaResolution> mediaResolution()

If specified, the media resolution specified will be used.

modelArmorConfig

public abstract Optional<ModelArmorConfig> modelArmorConfig()

Settings for prompt and response sanitization using the Model Armor service.

modelSelectionConfig

public abstract Optional<ModelSelectionConfig> modelSelectionConfig()

Configuration for model selection.

objectMapper

public static ObjectMapper objectMapper()

presencePenalty

public abstract Optional<Float> presencePenalty()

Positive values penalize tokens that already appear in the generated text, increasing the probability of generating more diverse content.

responseJsonSchema

public abstract Optional<Object> responseJsonSchema()

Optional.

responseLogprobs

public abstract Optional<Boolean> responseLogprobs()

Whether to return the log probabilities of the tokens that were chosen by the model at each step.

responseMimeType

public abstract Optional<String> responseMimeType()

Output response mimetype of the generated candidate text.

responseModalities

public abstract Optional<List<String>> responseModalities()

The requested modalities of the response.

responseSchema

public abstract Optional<Schema> responseSchema()

The `Schema` object allows the definition of input and output data types.

routingConfig

public abstract Optional<GenerationConfigRoutingConfig> routingConfig()

Configuration for model router requests.

safetySettings

public abstract Optional<List<SafetySetting>> safetySettings()

Safety settings in the request to block unsafe content in the response.

seed

public abstract Optional<Integer> seed()

When ``seed`` is fixed to a specific number, the model makes a best effort to provide the same response for repeated requests.

serviceTier

public abstract Optional<ServiceTier> serviceTier()

The service tier to use for the request.

setMaxReadLength

public static void setMaxReadLength(int maxReadLength)

Overrides the default maximum JSON string length (20MB) for the JSON parser.

shouldReturnHttpResponse

public abstract Optional<Boolean> shouldReturnHttpResponse()

If true, the raw HTTP response will be returned in the 'sdk_http_response' field.

speechConfig

public abstract Optional<SpeechConfig> speechConfig()

The speech generation configuration.

stopSequences

public abstract Optional<List<String>> stopSequences()

List of strings that tells the model to stop generating text if one of the strings is encountered in the response.

stringToJsonNode

public static JsonNode stringToJsonNode(String string)

Converts a Json string to a JsonNode.

systemInstruction

public abstract Optional<Content> systemInstruction()

Instructions for the model to steer it toward better performance.

temperature

public abstract Optional<Float> temperature()

Value that controls the degree of randomness in token selection.

thinkingConfig

public abstract Optional<ThinkingConfig> thinkingConfig()

The thinking features configuration.

toBuilder

public abstract GenerateContentConfig.Builder toBuilder()

Creates a builder with the same values as this instance.

toJson

public String toJson()

Serializes the instance to a Json string.

toJsonNode

public static JsonNode toJsonNode(Object object)

Serializes an object to a JsonNode.

toJsonString

public static String toJsonString(Object object)

Serializes an object to a Json string.

toolConfig

public abstract Optional<ToolConfig> toolConfig()

Associates model output to a specific function call.

tools

public abstract Optional<List<Tool>> tools()

Code that enables the system to interact with external systems to perform an action outside of the knowledge and scope of the model.

topK

public abstract Optional<Float> topK()

For each token selection step, the ``top_k`` tokens with the highest probabilities are sampled.

topP

public abstract Optional<Float> topP()

Tokens are selected from the most to least probable until the sum of their probabilities equals this value.