功能
請剛好傳入 photo_id（單張照片，回傳 {"photo_id", "adjustments"}）或 photo_ids（清單，會把相同的調整分別獨立套用到每一張，並回傳 {"results": [...], "applied", "failed"}，每張照片一筆，所以清單中有一個錯誤的 id 不會讓整批的其餘部分跟著遺失）其中之一。adjustments 把滑桿名稱對應到數字，例如 {"exposure": 20, "contrast": 10, "temperature": 5}。滑桿範圍除非另外註明，一律為 -100..100，0 表示沒有變化：light: exposure, contrast, highlights, shadows, whites, blacks colour: temperature, tint, vibrance, saturation，以及針對每個顏色 c（red、orange、yellow、green、aqua、blue、purple、magenta）的 hsl_hue_<c>、hsl_sat_<c>、hsl_lum_<c> presence: texture, clarity, dehaze detail: sharp_amount (0..150), sharp_radius (10..200), nr_luminance (0..100), nr_color (0..100) split toning: split_shadow_hue, split_highlight_hue (0..360), split_shadow_sat, split_highlight_sat (0..100), split_balance effects: vignette_amount, vignette_midpoint (10..90), grain_amount (0..100, 底片顆粒) looks: 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 檔 — 批次編輯 RAW 檔 AI
在哪裡執行
在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序；照片絕不會離開你的磁碟，也不會上傳任何東西。參考文件中的每個工具都是如此，包括這一個。
要呼叫它，你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。