update docs and format

Signed-off-by: Alexandros Pappas <[email protected]>

Author: apappascs

models/spring-ai-openai/src/main/java/org/springframework/ai/openai/OpenAiImageModel.java

@@ -253,20 +253,11 @@ public Flux<ImageResponse> stream(ImagePrompt imagePrompt) {
 
 		// Convert streaming events to ImageResponse
 		return eventStream.map(event -> {
-			// Create an Image from the event
 			Image image = new Image(null, event.b64Json());
-
-			// Create metadata
 			OpenAiImageGenerationMetadata metadata = new OpenAiImageGenerationMetadata(null);
-
-			// Create ImageGeneration
 			ImageGeneration generation = new ImageGeneration(image, metadata);
-
-			// Create ImageResponseMetadata with created timestamp and usage info
 			ImageResponseMetadata responseMetadata = event.createdAt() != null
 					? new ImageResponseMetadata(event.createdAt()) : new ImageResponseMetadata(null);
-
-			// Return ImageResponse with single generation
 			return new ImageResponse(List.of(generation), responseMetadata);
 		});
 	}

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/image/openai-image.adoc

@@ -134,7 +134,7 @@ The prefix `spring.ai.openai.image` is the property prefix that lets you configu
 | spring.ai.openai.image.organization-id | Optionally you can specify which organization  used for an API request. |  -
 | spring.ai.openai.image.project-id      | Optionally, you can specify which project is used for an API request. |  -
 | spring.ai.openai.image.options.n            | The number of images to generate. Must be between 1 and 10. For dall-e-3 and gpt-image models, only n=1 is supported.  | -
-| spring.ai.openai.image.options.model        | The model to use for image generation. Available models: `gpt-image-1-mini` (default), `gpt-image-1`, `dall-e-3`, `dall-e-2`.  | gpt-image-1-mini
+| spring.ai.openai.image.options.model        | The model to use for image generation. Available models: `dall-e-3` (default), `dall-e-2`, `gpt-image-1`, `gpt-image-1-mini`.  | dall-e-3
 | spring.ai.openai.image.options.quality      | The quality of the image. For gpt-image-1: `high`, `medium`, `low`, or `auto` (default). For dall-e-3: `hd` or `standard`. | -
 | spring.ai.openai.image.options.response_format | The format in which the generated images are returned. Must be one of `url` or `b64_json`. Only supported for dall-e-2 and dall-e-3. GPT-Image models always return base64-encoded images. | -
 | `spring.ai.openai.image.options.size`       | The size of the generated images. For gpt-image-1: `1024x1024`, `1536x1024`, `1024x1536`, or `auto` (default). For dall-e-2: `256x256`, `512x512`, or `1024x1024`. For dall-e-3: `1024x1024`, `1792x1024`, or `1024x1792`. | -

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/imageclient.adoc

@@ -28,6 +28,23 @@ public interface ImageModel extends Model<ImagePrompt, ImageResponse> {
 }
 ----
 
+=== Streaming Image Model
+
+For models that support streaming image generation, Spring AI provides the link:https://github.com/spring-projects/spring-ai/blob/main/spring-ai-model/src/main/java/org/springframework/ai/image/StreamingImageModel.java[StreamingImageModel] interface:
+
+[source,java]
+----
+public interface StreamingImageModel extends StreamingModel<ImagePrompt, ImageResponse> {
+
+	Flux<ImageResponse> stream(ImagePrompt prompt);
+
+}
+----
+
+The `StreamingImageModel` interface allows AI models to generate images progressively, emitting partial images as they are being created. This provides a better user experience by showing incremental progress rather than waiting for the final image.
+
+NOTE: Streaming image generation is currently only supported by certain models like OpenAI's GPT-Image models (gpt-image-1 and gpt-image-1-mini). Traditional models like DALL-E do not support streaming.
+
 === ImagePrompt
 
 The https://github.com/spring-projects/spring-ai/blob/main/spring-ai-model/src/main/java/org/springframework/ai/image/ImagePrompt.java[ImagePrompt] is a `ModelRequest` that encapsulates a list of https://github.com/spring-projects/spring-ai/blob/main/spring-ai-model/src/main/java/org/springframework/ai/image/ImageMessage.java[ImageMessage] objects and optional model request options.