Struct ImageGenerateParams 

pub struct ImageGenerateParams {
    pub prompt: String,
    pub negative_prompt: Option<String>,
    pub model: String,
    pub aspect_ratio: String,
    pub number_of_images: u8,
    pub seed: Option<i64>,
    pub output_file: Option<String>,
    pub output_uri: Option<String>,
}

Text-to-image generation parameters.

These parameters control the image generation process via the Vertex AI Imagen API.

Fields

prompt: String

Text prompt describing the image to generate. Maximum length depends on the model (480 chars for Imagen 3, 2000 for Imagen 4).

negative_prompt: Option<String>

Negative prompt - what to avoid in the generated image.

model: String

Model to use for generation. Defaults to “imagen-4.0-generate-preview-05-20”.

aspect_ratio: String

Aspect ratio for the generated image. Valid values: “1:1”, “3:4”, “4:3”, “9:16”, “16:9”.

number_of_images: u8

Number of images to generate (1-4).

seed: Option<i64>

Random seed for reproducible generation.

output_file: Option<String>

Output file path for saving the image locally. If not specified and output_uri is not specified, returns base64-encoded data.

output_uri: Option<String>

Output storage URI (e.g., gs://bucket/path). If specified, uploads the image to the storage backend.

Implementations

impl ImageGenerateParams

pub fn validate(&self) -> Result<(), Vec<ValidationError>>

Validate the parameters against the model constraints.

Returns

• Ok(()) if all parameters are valid
• Err(Vec<ValidationError>) with all validation errors

pub fn get_model(&self) -> Option<&'static ImagenModel>

Get the resolved model definition.

Trait Implementations

impl Clone for ImageGenerateParams

fn clone(&self) -> ImageGenerateParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ImageGenerateParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ImageGenerateParams

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ImageGenerateToolParams> for ImageGenerateParams

fn from(params: ImageGenerateToolParams) -> Self

Converts to this type from the input type.

impl JsonSchema for ImageGenerateParams

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for ImageGenerateParams

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.