Struct ImageGenerationBuilder 

pub struct ImageGenerationBuilder { /* private fields */ }

Builder for image generation (/images/generations).

Implementations

impl ImageGenerationBuilder

pub fn new(prompt: impl Into<String>) -> Self

Create a new generation builder with the required prompt text.

pub fn model(self, model: impl Into<String>) -> Self

Override the model (gpt-image-1, dall-e-3, etc.).

pub fn n(self, n: i32) -> Self

Set how many images to generate (1-10).

pub fn quality(self, quality: Quality) -> Self

Select image quality.

pub fn response_format(self, format: ResponseFormat) -> Self

Select the response format for dall-e-* models.

pub fn output_format(self, format: OutputFormat) -> Self

Choose the binary output format (only supported for gpt-image-1).

pub fn output_compression(self, compression: i32) -> Self

Tune image compression (0-100). Only applies to JPEG/WEBP outputs.

pub fn stream(self, stream: bool) -> Self

Enable streaming responses.

pub fn partial_images(self, partial_images: Option<i32>) -> Self

Configure the number of partial images to emit when streaming (0-3).

pub fn size(self, size: Size) -> Self

Select the output size preset.

pub fn moderation(self, moderation: Moderation) -> Self

Control content moderation (auto/low).

pub fn background(self, background: Background) -> Self

Configure transparent/opaque backgrounds.

pub fn style(self, style: Style) -> Self

Select stylistic hints supported by dall-e-3.

pub fn user(self, user: impl Into<String>) -> Self

Attach an end-user identifier for abuse monitoring.

pub fn prompt(&self) -> &str

Borrow the configured prompt.

Trait Implementations

impl Builder<CreateImageRequest> for ImageGenerationBuilder

fn build(self) -> Result<CreateImageRequest>

Build the final request type.

impl Clone for ImageGenerationBuilder

fn clone(&self) -> ImageGenerationBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageGenerationBuilder

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

Formats the value using the given formatter.