What it does
preset_name must be a key from list_presets, or the name of one of the user's my_presets (case does not matter). A saved preset sets every slider it holds, like loading it in the editor; the photo's own crop and mask layers stay. The look is stored the same way the desktop editor stores edits, so exports render exactly what the editor would show. Applying a second preset merges scene preset offsets and replaces the color grade; an experimental preset replaces the previous experimental preset and keeps the grade. A key listed both as a color grade and as an experimental preset (bleach_bypass) applies the experimental preset; for the grade, use apply_adjustments {"color_grade": "bleach_bypass"}.
Parameters
| Name | Type | Required |
|---|---|---|
photo_ids |
list[int] |
required |
preset_name |
str |
required |
Asking for it
You do not call this by name. You say what you want, and the agent picks the tool:
Apply the warm film look to every keeper in this folder and export JPEGs at quality 92.
The rest of the editing tools
Workflows that use it
- Batch edit RAW files with an AI agent — batch edit RAW files AI
Where it runs
On your machine. imagic's MCP server is a local process that your AI client starts; the photos never leave your disk and nothing is uploaded. That is true of every tool in the reference, including this one.
To call it you need an MCP client connected to imagic. Setup takes about three minutes for Claude Code, Cursor, VS Code, Codex, Gemini CLI and ten others.
Give your AI the whole pipeline
apply_preset is one of 30 tools in imagic Max. The free 500-export trial includes all of them.