Support

Documentation

7.4.aitiny:image:edit

7.4.aitiny:image:edit

Edits an existing image using an AI prompt. Requires an image service that supports image-to-image editing (such as OpenAI's GPT Image models, Gemini, or Flux).

Usage

php cli/joomla.php aitiny:image:edit <inputFile> <prompt> [options]

Arguments

inputFile

Required. The input image to edit. This can be a file path, a Joomla Media URI (e.g. local-images:aitiny/myimage.png), or a URL.

prompt

Required. A description of the changes you want to make to the image.

Options

-i, --in-place

Edit the image in-place, replacing the original file. Cannot be used together with --output.

-m, --format

The output image format: png, jpg, or webp. Defaults to png.

-o, --output

The output type: none, mediauri, url, imagebase64, or image. Defaults to none. Cannot be used together with --in-place.

-s, --style

A style preset to apply.

-z, --size

The image size: small, medium, or large.

-a, --aspect

The aspect ratio.

Examples

# Edit an image in-placephp cli/joomla.php aitiny:image:edit local-images:aitiny/photo.png "Make it look like a watercolour painting" -i# Edit and save as a new image, getting the media URIphp cli/joomla.php aitiny:image:edit /path/to/image.jpg "Add a sunset sky" -o mediauri