Configuration options for generating images with Imagen.
See the documentation for more details.
Signature:
export interface ImagenGenerationConfig
Properties
| Property | Type | Description |
|---|---|---|
| addWatermark | boolean | Whether to add an invisible watermark to generated images.If set to true, an invisible SynthID watermark is embedded in generated images to indicate that they are AI generated. If set to false, watermarking will be disabled.For Imagen 3 models, the default value is true; see the addWatermark documentation for more details.When using the Gemini Developer API (GoogleAIBackend), this will default to true, and cannot be turned off. |
| aspectRatio | ImagenAspectRatio | The aspect ratio of the generated images. The default value is square 1:1. Supported aspect ratios depend on the Imagen model, see ImagenAspectRatio for more details. |
| imageFormat | ImagenImageFormat | The image format of the generated images. The default is PNG.See ImagenImageFormat for more details. |
| negativePrompt | string | A description of what should be omitted from the generated images.Support for negative prompts depends on the Imagen model.See the documentation for more details.This is no longer supported in the Gemini Developer API (GoogleAIBackend) in versions greater than imagen-3.0-generate-002. |
| numberOfImages | number | The number of images to generate. The default value is 1.The number of sample images that may be generated in each request depends on the model (typically up to 4); see the sampleCount documentation for more details. |
ImagenGenerationConfig.addWatermark
Whether to add an invisible watermark to generated images.
If set to true, an invisible SynthID watermark is embedded in generated images to indicate that they are AI generated. If set to false, watermarking will be disabled.
For Imagen 3 models, the default value is true; see the addWatermark documentation for more details.
When using the Gemini Developer API (GoogleAIBackend), this will default to true, and cannot be turned off.
Signature:
addWatermark?: boolean;
ImagenGenerationConfig.aspectRatio
The aspect ratio of the generated images. The default value is square 1:1. Supported aspect ratios depend on the Imagen model, see ImagenAspectRatio for more details.
Signature:
aspectRatio?: ImagenAspectRatio;
ImagenGenerationConfig.imageFormat
The image format of the generated images. The default is PNG.
See ImagenImageFormat for more details.
Signature:
imageFormat?: ImagenImageFormat;
ImagenGenerationConfig.negativePrompt
A description of what should be omitted from the generated images.
Support for negative prompts depends on the Imagen model.
See the documentation for more details.
This is no longer supported in the Gemini Developer API (GoogleAIBackend) in versions greater than imagen-3.0-generate-002.
Signature:
negativePrompt?: string;
ImagenGenerationConfig.numberOfImages
The number of images to generate. The default value is 1.
The number of sample images that may be generated in each request depends on the model (typically up to 4); see the sampleCount documentation for more details.
Signature:
numberOfImages?: number;