作用
photo_id（单张照片，返回 {"photo_id", "adjustments"}）和 photo_ids（一个列表，对每张照片独立应用相同的调整，并返回 {"results": [...], "applied", "failed"}，每张照片一条记录，所以列表中有一个错误的 id，不会让批量中的其余照片丢失）这两者，请只传一个。adjustments 把滑块名称映射到数值，例如 {"exposure": 20, "contrast": 10, "temperature": 5}。这些滑块的范围都是 -100..100，除非另外给出范围，否则 0 表示没有变化：光线：exposure、contrast、highlights、shadows、whites、blacks；色彩：temperature、tint、vibrance、saturation，以及每种颜色的 hsl_hue_<c>、hsl_sat_<c>、hsl_lum_<c>，其中 c 取 red、orange、yellow、green、aqua、blue、purple、magenta；质感：texture、clarity、dehaze；细节：sharp_amount (0..150)、sharp_radius (10..200)、nr_luminance (0..100)、nr_color (0..100)；分离色调：split_shadow_hue、split_highlight_hue (0..360)、split_shadow_sat、split_highlight_sat (0..100)、split_balance；效果：vignette_amount、vignette_midpoint (10..90)、grain_amount (0..100，胶片颗粒)；风格：color_grade（list_presets 里的一个调色键名）、color_grade_intensity (0..100)、fx_preset（list_presets 里的一个实验性预设键名，或 "none"）、fx_amount (0..100)、auto_color (0..100，Auto Color 的强度；见 apply_auto_color)、auto_color_mode（"color" 或 "contrast"）、lut_name（list_luts 里的一个 LUT，或 "none"）、lut_strength (0..100)；tone_curve_<luminance|red|green|blue>：0..1 范围内的 [x, y] 点列表；crop_x、crop_y、crop_w、crop_h（像素）。如果想按宽高比裁剪而不用算像素，请使用 crop_photo；如果只想改变画面的一部分，请使用 mask_adjust。这些值是滑块的绝对位置，不是增量，而且一张分析过但没人编辑过的照片，已经处在它的场景预设的数值上：对于相对的要求（“亮一档”相当于 exposure +50，“稍微暖一点”），请用 get_photo_edits 读取当前值，再在上面叠加。数值会被限制在范围内，未知的名称会被拒绝，并附上有效名称的列表。新值会按滑块覆盖旧值；其他滑块保持原有设置。这些滑块按 Lightroom 的方式运行：负的 highlights 会找回明亮的区域，exposure +50 是一档。在 imagic 旧版引擎上编辑的照片，会先被迁移到当前引擎，并保留它的风格，所以这些数值在每张照片上的含义都是一样的。
参数
| 名称 | 类型 | 必填 |
|---|---|---|
photo_id |
int | None |
可选 |
adjustments |
dict | None |
可选 |
photo_ids |
list[int] | None |
可选 |
如何提出要求
你不需要按名字调用它。你只需说出想要什么，由智能体选择工具：
把暖色胶片风格应用到这个文件夹里的每一张留用照片上，并以质量 92 导出 JPEG。
编辑 其余的工具
用到它的工作流程
- 用 AI 智能体批量编辑 RAW 文件 — AI 批量编辑 RAW 文件
它在哪里运行
在你的电脑上。imagic 的 MCP 服务器是由你的 AI 客户端启动的本地进程；照片不会离开你的磁盘，也不会上传任何内容。参考中的每个工具都是如此，包括这一个。
要调用它，你需要一个连接到 imagic 的 MCP 客户端。对于 Claude Code、Cursor、VS Code、Codex、Gemini CLI 以及其他十个客户端，设置大约需要三分钟。