image-studio

Use the media_generate_image tool via skill_execute to create or edit images.

Modes

• generate (default): Create a new image from a text prompt.
• edit: Modify an existing image. Requires one or more source images via source_paths.

Models

Do not pass the model parameter unless you need a specific tier. Omitting it uses the configured default, which is correct for most requests.

When you do need to choose, use an alias, not a concrete model ID. Aliases always resolve to the current model for that tier:

• fast: quickest, good quality (default tier)
• quality: higher fidelity, slower
• openai: OpenAI's model; most permissive on photo edits

Pass a concrete model ID only if the user names one explicitly. If the tool rejects an unknown model ID, the error lists the currently available models and aliases.

Example calls

Generate (no model parameter, default is correct):

{ "tool": "media_generate_image", "input": { "prompt": "A sunset over the ocean, golden hour, soft haze, 35mm photo style", "variants": 2 } }

Edit:

{ "tool": "media_generate_image", "input": { "prompt": "Remove the watermark text from the background. Keep the subject, framing, lighting, and colors exactly identical. Change nothing else.", "mode": "edit", "source_paths": ["conversations/<conv-id>/attachments/photo.jpeg"], "model": "openai" } }

source_paths is a flat array of file path strings. Do NOT pass objects:

• Wrong: "source_paths": [{ "path": "img.jpeg" }] → schema validation error
• Right: "source_paths": ["img.jpeg"]

Source images for edit mode

• Paths resolve inside the workspace. Conversation attachments live under conversations/<conversation-id>/attachments/; prefer that path for images the user attached.
• Host paths (e.g. ~/Desktop/photo.jpg) only work if the file arrived as an attachment; the tool falls back to the stored workspace copy. If the user references a host file that was never attached, pull it into the workspace first, then pass the workspace path.