What it does
The photographer edits a few photos from a shoot; call this to apply that same look to the rest of the shoot. Different from apply_my_style: this matches THESE examples, not the saved profile. By default every edited photo in scope is an example and every unedited photo in scope is a target; pass example_photo_ids or target_photo_ids to control either side, and directory to scope the match to one shoot folder. Needs at least 2 edited examples. The match is session local and never changes the saved style profile unless save_to_profile is true, which also feeds the examples into the profile. Returns example and target counts plus the scenarios the examples covered.
Parameters
| Name | Type | Required |
|---|---|---|
example_photo_ids |
list[int] | None |
optional |
target_photo_ids |
list[int] | None |
optional |
directory |
str | None |
optional |
save_to_profile |
bool |
optional |
Asking for it
You do not call this by name. You say what you want, and the agent picks the tool:
Learn my style from the photos I have already edited, then apply it to the rest of this shoot.
The rest of the style tools
Workflows that use it
- Teach an AI your editing style — AI photo editing in your own style
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
match_style_from_examples is one of 18 tools in imagic Max. The free 7-day trial includes all of them.