Navigation
ELOWEN · Documentation

Last updated: October 27, 2026

Browse documentation · Set up image editing

Set up image editing

The image-edit plugin changes an existing picture from a text instruction and saves the result as a new file. The user side is Change a picture you already have.

Install the plugin

  1. Open Settings → Available plugins and install image-edit.
  2. The plugin needs Chetty 0.30.47 or later.

Configure an image provider

  1. Add an OpenAI-compatible provider, or connect a ChatGPT or OpenRouter account, in the AI settings section, which is named after the assistant (by default Chetty AI).
  2. Open Settings → Plugins and the image-edit card.
  3. Select the Provider. An OpenAI-compatible provider reuses its configured key and base URL; a connected account uses Chetty's own image service.
  4. Optionally select a Model from that provider's image models your accounts may use. Allow those models under Allowed models on the Users page.

Leave Model empty to use the provider's default. With the connected ChatGPT account the default is gpt-image-2.5-sunburst; with any other provider, an empty field falls back to gpt-image-1. Select an image model explicitly for OpenRouter and keep its vendor namespace, such as google/gemini-2.5-flash-image.

Until a usable provider is configured, the tool is not registered at all.

Who can use it

The plugin is not user-grantable, so every signed-in account can use its tool once a provider is configured. Account tool permissions still apply.

Operations

  • Enabling, disabling, saving the settings or uninstalling the plugin restarts Chetty. The screen says that the change was saved and that Chetty is restarting to load it; the restart follows once no other request has arrived for a few seconds.
  • A source picture must be a PNG or JPEG of at most 10 MB, either from the Project or from a public address. Fetching that address takes at most two minutes, follows at most five redirects and refuses an image over 10 MB. A private-network address is never used.
  • An explicit output path may name the source file. That replaces the original, and a different output format writes a different path, so keep a copy of anything you cannot lose.
  • Editing can take up to two minutes before it times out. A missing instruction is refused before the provider is called.
  • Requests run through Chetty, which keeps provider credentials out of the plugin.

Developer reference

Implementation reference describes the shared image runtime and the host contract.