Edit an existing image message and send the variations
Edit an image from a previous message using the Mutiro image service, optionally applying a mask, and send the generated variations as a new message.
Examples:
Edit a previous image message using its ID
mutiro user message edit-image conv_123 "Add dramatic lighting and fog" --message-id msg_789
Edit a direct message by username, using the second image in the message
mutiro user message edit-image alice "Change background to sunset" --message-id msg_789 --image-index 1
Apply a mask to restrict editing
mutiro user message edit-image alice "Turn jacket red" --message-id msg_789 --mask-file mask.png --mask-strength 0.8
Output JSON response
mutiro user message edit-image alice "Convert to sketch" --message-id msg_789 --json
mutiro user message edit-image <username|conversation-id> <prompt> [flags]
Edit a previous image message using its ID
Edit a direct message by username, using the second image in the message
Apply a mask to restrict editing
Output JSON response
| Flag | Type | Description |
|---|---|---|
| --aspect-ratio | string | Aspect ratio (e.g., 3:2, 16:9) (default "3:2") |
| --caption | string | Caption for the edited images (defaults to prompt) |
| --count int | bool | Number of image variations to request (default 1) |
| -h, --help | bool | help for edit-image |
| --image-index int | bool | Index of the image within the message to edit (0-based) |
| --include-safety | bool | Request safety metadata in the response |
| --json | bool | Output result as JSON |
| --mask-file | string | Path to an optional mask image limiting edits |
| --mask-mime-type | string | Explicit MIME type for the mask file (auto-detected if omitted) |
| --mask-strength float | bool | Mask strength between 0 and 1 |
| --message-id | string | ID of the message containing the image to edit (required) |
| --mime-type | string | Preferred output MIME type (default "image/png") |
| --model | string | Model to use (defaults to server-side configuration) |
| --negative | string | Negative prompt describing what to avoid |
| --reply-to | string | Message ID to reply to |
| --request-id | string | Optional idempotency key for the generation request |
| --seed int | bool | Random seed for deterministic outputs |
| --watermark | bool | Request provider watermark on generated images |
| Flag | Type | Description |
|---|---|---|
| --config | string | config file (default is ./.mutiro.yaml in current directory) |
| --debug | bool | debug mode |
| -v, --verbose | bool | verbose output |