Struct GenerateImageRequest 

pub struct GenerateImageRequest {

    pub prompt: String,
    pub model: Option<String>,
    pub negative_prompt: Option<String>,
    pub width: Option<u32>,
    pub height: Option<u32>,
    pub steps: Option<u32>,
    pub guidance: Option<f32>,
    pub seed: Option<u64>,
    pub output_path: Option<String>,
    pub format: String,
    pub input_image_path: Option<String>,
    pub variant_count: Option<u32>,
    pub parent_image_path: Option<String>,
}

Request to generate an image from text.

Default is implemented manually (not derived) because format has a sensible non-empty default ("png") that String::default() would clobber to "". Callers can GenerateImageRequest { prompt: "...".into(), ..Default::default() } and get a usable shape. Mirrors the GenerateRequest ergonomic fix from #109.

Fields

prompt: String

model: Option<String>

negative_prompt: Option<String>

width: Option<u32>

height: Option<u32>

steps: Option<u32>

guidance: Option<f32>

seed: Option<u64>

output_path: Option<String>

format: String

input_image_path: Option<String>

Input image to transform (img2img). Backends that don’t support image conditioning return an InferenceError::UnsupportedMode if this is set.

variant_count: Option<u32>

Number of variants to generate in one call. None (or 1) produces a single image — matches the original generate_image contract. Backends that don’t support batching either loop internally or error if > 1. Honoured by crate::InferenceEngine::generate_image_batch; the scalar crate::InferenceEngine::generate_image forces it to 1.

parent_image_path: Option<String>

Anchor for cross-call continuity — instructs the model to generate variants in the visual neighbourhood of this image. Currently meaningful only on backends that natively support the concept (e.g. gpt-image-2). Other backends ignore the hint or return UnsupportedMode.

Trait Implementations

impl Clone for GenerateImageRequest

fn clone(&self) -> GenerateImageRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GenerateImageRequest

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

Formats the value using the given formatter.

impl Default for GenerateImageRequest

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GenerateImageRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GenerateImageRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.