assist-feedback.php
10 months ago
assistant.php
2 months ago
base.php
1 week ago
dropped-file.php
3 months ago
edit-image.php
3 months ago
embed.php
3 months ago
feedback.php
10 months ago
function.php
1 month ago
image.php
1 month ago
parameter.php
1 year ago
text.php
1 week ago
transcribe.php
8 months ago
image.php
213 lines
| 1 | <?php |
| 2 | |
| 3 | class Meow_MWAI_Query_Image extends Meow_MWAI_Query_Base { |
| 4 | public ?string $resolution = null; |
| 5 | public ?string $quality = null; |
| 6 | public ?string $style = null; |
| 7 | public ?string $localDownload = 'uploads'; |
| 8 | public ?string $localDownloadExpiry = 'uploads'; |
| 9 | public ?array $attachedFiles = null; |
| 10 | |
| 11 | #region Constructors, Serialization |
| 12 | |
| 13 | public function __construct( ?string $message = '', ?string $model = null ) { |
| 14 | parent::__construct( $message ); |
| 15 | $this->model = $model; |
| 16 | $this->feature = 'text-to-image'; // image-to-image, inpainting, etc |
| 17 | global $mwai_core; |
| 18 | $this->localDownload = $mwai_core->get_option( 'image_local_download' ); |
| 19 | $this->localDownloadExpiry = $mwai_core->get_option( 'image_expires_download' ); |
| 20 | } |
| 21 | |
| 22 | #[\ReturnTypeWillChange] |
| 23 | public function jsonSerialize(): array { |
| 24 | $json = [ |
| 25 | 'message' => $this->message, |
| 26 | |
| 27 | 'ai' => [ |
| 28 | 'model' => $this->model, |
| 29 | 'feature' => $this->feature, |
| 30 | 'resolution' => $this->resolution, |
| 31 | 'quality' => $this->quality |
| 32 | ], |
| 33 | |
| 34 | 'system' => [ |
| 35 | 'class' => get_class( $this ), |
| 36 | 'envId' => $this->envId, |
| 37 | 'scope' => $this->scope, |
| 38 | 'session' => $this->session, |
| 39 | 'customId' => $this->customId, |
| 40 | ] |
| 41 | ]; |
| 42 | |
| 43 | if ( !empty( $this->context ) ) { |
| 44 | $json['context']['content'] = $this->context; |
| 45 | } |
| 46 | |
| 47 | return $json; |
| 48 | } |
| 49 | |
| 50 | #endregion |
| 51 | |
| 52 | #region Parameters |
| 53 | |
| 54 | public function set_resolution( string $resolution ) { |
| 55 | $this->resolution = $resolution; |
| 56 | } |
| 57 | |
| 58 | public function set_quality( ?string $quality ) { |
| 59 | $this->quality = $quality !== null && $quality !== '' ? $quality : null; |
| 60 | } |
| 61 | |
| 62 | public function set_style( string $style ) { |
| 63 | $this->style = $style; |
| 64 | } |
| 65 | |
| 66 | /** |
| 67 | * Set how the image will be treated locally, if it will be downloaded or not, etc. |
| 68 | * @param string $localDownload The local download method. Could be 'uploads', 'library' or null. |
| 69 | */ |
| 70 | public function set_local_download( ?string $localDownload ) { |
| 71 | $this->localDownload = $localDownload; |
| 72 | } |
| 73 | |
| 74 | public function add_file( Meow_MWAI_Query_DroppedFile $file ): void { |
| 75 | if ( $this->attachedFiles === null ) { |
| 76 | $this->attachedFiles = []; |
| 77 | } |
| 78 | $this->attachedFiles[] = $file; |
| 79 | } |
| 80 | |
| 81 | public function set_files( array $files ): void { |
| 82 | $this->attachedFiles = $files; |
| 83 | } |
| 84 | |
| 85 | public function get_files(): ?array { |
| 86 | return $this->attachedFiles; |
| 87 | } |
| 88 | |
| 89 | public function getAttachments(): array { |
| 90 | return $this->attachedFiles ?? []; |
| 91 | } |
| 92 | |
| 93 | // Based on the params of the query, update the attributes |
| 94 | public function inject_params( array $params ): void { |
| 95 | parent::inject_params( $params ); |
| 96 | $params = $this->convert_keys( $params ); |
| 97 | |
| 98 | if ( !empty( $params['resolution'] ) ) { |
| 99 | $this->set_resolution( $params['resolution'] ); |
| 100 | } |
| 101 | if ( array_key_exists( 'quality', $params ) ) { |
| 102 | $this->set_quality( $params['quality'] ); |
| 103 | } |
| 104 | if ( !empty( $params['style'] ) ) { |
| 105 | $this->set_style( $params['style'] ); |
| 106 | } |
| 107 | // Check both camelCase and snake_case versions for compatibility |
| 108 | if ( array_key_exists( 'localDownload', $params ) ) { |
| 109 | $this->set_local_download( $params['localDownload'] ); |
| 110 | } |
| 111 | elseif ( array_key_exists( 'local_download', $params ) ) { |
| 112 | $this->set_local_download( $params['local_download'] ); |
| 113 | } |
| 114 | } |
| 115 | |
| 116 | #endregion |
| 117 | |
| 118 | #region Final Checks |
| 119 | |
| 120 | public function final_checks() { |
| 121 | parent::final_checks(); |
| 122 | |
| 123 | // Force a single image per request (matches the supported behavior of current image models). |
| 124 | $this->maxResults = 1; |
| 125 | |
| 126 | global $mwai_core; |
| 127 | |
| 128 | $engine = Meow_MWAI_Engines_Factory::get( $mwai_core, $this->envId ); |
| 129 | |
| 130 | // If model is empty, use the image-specific default model (not the general default) |
| 131 | if ( empty( $this->model ) ) { |
| 132 | $this->model = $mwai_core->get_option( 'ai_images_default_model' ); |
| 133 | if ( empty( $this->model ) ) { |
| 134 | // Fallback to general default if image-specific default is not set |
| 135 | $this->model = $mwai_core->get_option( 'ai_default_model' ); |
| 136 | } |
| 137 | } |
| 138 | |
| 139 | $modelInfo = $engine->retrieve_model_info( $this->model ); |
| 140 | if ( empty( $modelInfo ) ) { |
| 141 | Meow_MWAI_Logging::error( 'No model info found for model: ' . $this->model, '🖼️' ); |
| 142 | return; |
| 143 | } |
| 144 | |
| 145 | // Let's check for resolutions. |
| 146 | if ( !isset( $modelInfo['resolutions'] ) || empty( $modelInfo['resolutions'] ) ) { |
| 147 | // Skip warning for non-image models (e.g., when using image_generation as a tool) |
| 148 | return; |
| 149 | } |
| 150 | |
| 151 | // If we have no resolution set, we will use the first one |
| 152 | if ( empty( $this->resolution ) ) { |
| 153 | $this->resolution = $modelInfo['resolutions'][0]['name']; |
| 154 | } |
| 155 | |
| 156 | // If we have a resolutions array ([ name, label ]), let's ensure our current resolution (name) is supported |
| 157 | $resolutions = $modelInfo['resolutions']; |
| 158 | $found = false; |
| 159 | foreach ( $resolutions as $resolution ) { |
| 160 | if ( $resolution['name'] === $this->resolution ) { |
| 161 | $found = true; |
| 162 | break; |
| 163 | } |
| 164 | } |
| 165 | |
| 166 | // If we don't find the resolution, we will set it to the first one. |
| 167 | if ( !$found ) { |
| 168 | $supportedResolutions = []; |
| 169 | foreach ( $resolutions as $resolution ) { |
| 170 | $supportedResolutions[] = $resolution['name']; |
| 171 | } |
| 172 | $supportedResolutions = implode( ', ', $supportedResolutions ); |
| 173 | $error = sprintf( 'The model %s does not support the resolution %s (using %s instead). Supported resolutions are: %s.', $this->model, $this->resolution, $resolutions[0]['name'], $supportedResolutions ); |
| 174 | $this->resolution = $resolutions[0]['name']; |
| 175 | Meow_MWAI_Logging::error( $error, '🖼️' ); |
| 176 | } |
| 177 | |
| 178 | // Quality: only validate when the model declares supported qualities. Otherwise leave it as-is |
| 179 | // (null means "do not send the quality param to the API"; the provider picks its default). |
| 180 | if ( !empty( $modelInfo['qualities'] ) && empty( $this->quality ) ) { |
| 181 | // Fall back to the global default. If the saved default is not supported by the active |
| 182 | // model (e.g. user switched from GPT Image to a model with different vocabulary), the |
| 183 | // validation block below will silently reset it to the model's first declared quality. |
| 184 | $defaultQuality = $mwai_core->get_option( 'ai_images_default_quality' ); |
| 185 | if ( !empty( $defaultQuality ) ) { |
| 186 | $this->quality = $defaultQuality; |
| 187 | } |
| 188 | } |
| 189 | if ( !empty( $modelInfo['qualities'] ) && !empty( $this->quality ) ) { |
| 190 | $qualities = $modelInfo['qualities']; |
| 191 | $foundQuality = false; |
| 192 | foreach ( $qualities as $quality ) { |
| 193 | if ( $quality['name'] === $this->quality ) { |
| 194 | $foundQuality = true; |
| 195 | break; |
| 196 | } |
| 197 | } |
| 198 | if ( !$foundQuality ) { |
| 199 | $supportedQualities = []; |
| 200 | foreach ( $qualities as $quality ) { |
| 201 | $supportedQualities[] = $quality['name']; |
| 202 | } |
| 203 | $supportedQualities = implode( ', ', $supportedQualities ); |
| 204 | $error = sprintf( 'The model %s does not support the quality %s (using %s instead). Supported qualities are: %s.', $this->model, $this->quality, $qualities[0]['name'], $supportedQualities ); |
| 205 | $this->quality = $qualities[0]['name']; |
| 206 | Meow_MWAI_Logging::error( $error, '🖼️' ); |
| 207 | } |
| 208 | } |
| 209 | } |
| 210 | |
| 211 | #endregion |
| 212 | } |
| 213 |