mistralrs_server_core/
image_generation.rs

1//! ## Image generation functionality and route handler.
2
3use std::{error::Error, sync::Arc};
4
5use anyhow::Result;
6use axum::{
7    extract::{Json, State},
8    http::{self},
9    response::IntoResponse,
10};
11use mistralrs_core::{
12    Constraint, DiffusionGenerationParams, ImageGenerationResponse, MistralRs, NormalRequest,
13    Request, RequestMessage, Response, SamplingParams,
14};
15use tokio::sync::mpsc::{Receiver, Sender};
16
17use crate::{
18    handler_core::{
19        base_process_non_streaming_response, create_response_channel, send_request,
20        ErrorToResponse, JsonError,
21    },
22    openai::ImageGenerationRequest,
23    types::{ExtractedMistralRsState, SharedMistralRsState},
24    util::{sanitize_error_message, validate_model_name},
25};
26
27/// Represents different types of image generation responses.
28pub enum ImageGenerationResponder {
29    Json(ImageGenerationResponse),
30    InternalError(Box<dyn Error>),
31    ValidationError(Box<dyn Error>),
32}
33
34impl IntoResponse for ImageGenerationResponder {
35    /// Converts the image generation responder into an HTTP response.
36    fn into_response(self) -> axum::response::Response {
37        match self {
38            ImageGenerationResponder::Json(s) => Json(s).into_response(),
39            ImageGenerationResponder::InternalError(e) => {
40                JsonError::new(sanitize_error_message(e.as_ref()))
41                    .to_response(http::StatusCode::INTERNAL_SERVER_ERROR)
42            }
43            ImageGenerationResponder::ValidationError(e) => {
44                JsonError::new(sanitize_error_message(e.as_ref()))
45                    .to_response(http::StatusCode::UNPROCESSABLE_ENTITY)
46            }
47        }
48    }
49}
50
51/// Parses and validates a image generation request.
52///
53/// This function transforms a image generation request into the
54/// request format used by mistral.rs.
55pub fn parse_request(
56    oairequest: ImageGenerationRequest,
57    state: Arc<MistralRs>,
58    tx: Sender<Response>,
59) -> Result<Request> {
60    let repr = serde_json::to_string(&oairequest).expect("Serialization of request failed.");
61    MistralRs::maybe_log_request(state.clone(), repr);
62
63    // Validate that the requested model matches the loaded model
64    validate_model_name(&oairequest.model, state.clone())?;
65
66    Ok(Request::Normal(Box::new(NormalRequest {
67        id: state.next_request_id(),
68        messages: RequestMessage::ImageGeneration {
69            prompt: oairequest.prompt,
70            format: oairequest.response_format,
71            generation_params: DiffusionGenerationParams {
72                height: oairequest.height,
73                width: oairequest.width,
74            },
75        },
76        sampling_params: SamplingParams::deterministic(),
77        response: tx,
78        return_logprobs: false,
79        is_streaming: false,
80        suffix: None,
81        constraint: Constraint::None,
82        tool_choice: None,
83        tools: None,
84        logits_processors: None,
85        return_raw_logits: false,
86        web_search_options: None,
87        model_id: if oairequest.model == "default" {
88            None
89        } else {
90            Some(oairequest.model.clone())
91        },
92    })))
93}
94
95/// Image generation endpoint handler.
96#[utoipa::path(
97    post,
98    tag = "Mistral.rs",
99    path = "/v1/images/generations",
100    request_body = ImageGenerationRequest,
101    responses((status = 200, description = "Image generation"))
102)]
103pub async fn image_generation(
104    State(state): ExtractedMistralRsState,
105    Json(oairequest): Json<ImageGenerationRequest>,
106) -> ImageGenerationResponder {
107    let (tx, mut rx) = create_response_channel(None);
108
109    let request = match parse_request(oairequest, state.clone(), tx) {
110        Ok(x) => x,
111        Err(e) => return handle_error(state, e.into()),
112    };
113
114    if let Err(e) = send_request(&state, request).await {
115        return handle_error(state, e.into());
116    }
117
118    process_non_streaming_response(&mut rx, state).await
119}
120
121/// Helper function to handle image generation errors and logging them.
122pub fn handle_error(
123    state: SharedMistralRsState,
124    e: Box<dyn std::error::Error + Send + Sync + 'static>,
125) -> ImageGenerationResponder {
126    let sanitized_msg = sanitize_error_message(&*e);
127    let e = anyhow::Error::msg(sanitized_msg);
128    MistralRs::maybe_log_error(state, &*e);
129    ImageGenerationResponder::InternalError(e.into())
130}
131
132/// Process non-streaming image generation responses.
133pub async fn process_non_streaming_response(
134    rx: &mut Receiver<Response>,
135    state: SharedMistralRsState,
136) -> ImageGenerationResponder {
137    base_process_non_streaming_response(rx, state, match_responses, handle_error).await
138}
139
140/// Matches and processes different types of model responses into appropriate image generation responses.
141pub fn match_responses(
142    state: SharedMistralRsState,
143    response: Response,
144) -> ImageGenerationResponder {
145    match response {
146        Response::InternalError(e) => {
147            MistralRs::maybe_log_error(state, &*e);
148            ImageGenerationResponder::InternalError(e)
149        }
150        Response::ValidationError(e) => ImageGenerationResponder::ValidationError(e),
151        Response::ImageGeneration(response) => {
152            MistralRs::maybe_log_response(state, &response);
153            ImageGenerationResponder::Json(response)
154        }
155        Response::CompletionModelError(m, _) => {
156            let e = anyhow::Error::msg(m.to_string());
157            MistralRs::maybe_log_error(state, &*e);
158            ImageGenerationResponder::InternalError(e.into())
159        }
160        Response::CompletionDone(_) => unreachable!(),
161        Response::CompletionChunk(_) => unreachable!(),
162        Response::Chunk(_) => unreachable!(),
163        Response::Done(_) => unreachable!(),
164        Response::ModelError(_, _) => unreachable!(),
165        Response::Speech { .. } => unreachable!(),
166        Response::Raw { .. } => unreachable!(),
167    }
168}
mistralrs_server_core/image_generation.rs

mistralrs_server_core/
image_generation.rs
