編輯

mask_adjust

對照片的一部分做 AI 遮色,並只調整那一部分(局部調整)。

功能

target 是 "subject"、"sky"、"people" 或 "background":imagic 用桌面編輯器所使用的同一套 AI 遮色來找出它(在這台電腦上,每張照片一兩秒)。adjustments 使用與 apply_adjustments 相同的滑桿名稱,例如主體用 {"exposure": 15, "clarity": 10},背景用 {"exposure": -20, "saturation": -15},把兩者區隔開來。畫面層級的鍵(crop、rotation、fx_preset)會被拒絕;那些請用 apply_adjustments 設定。mode "relative"(預設)會把這些值疊加在照片目前的風格之上,就像 Lightroom 的遮色片。mode "isolated" 則只用這些值,從原始檔渲染該區域,所以之後的全域編輯不再影響它(編輯器圖層的預設行為)。每個圖層都會儲存成一個以 target(或 name)命名的編輯器遮色片圖層:匯出會包含它,而照片在編輯器中重新開啟時,圖層會以自己的分頁出現。以相同的 target 或 name 再次呼叫,會取代那個圖層,而不是再疊上另一個;remove=true 則會刪除它。對單張照片傳 photo_id,對多張照片傳 photo_ids(每張各有自己的遮色片)。回傳遮色片的涵蓋範圍(佔畫面的比例)與照片的圖層清單;get_photo_edits 也會列出圖層。在遠端連線上,長時間的批次會以背景工作執行:請用回傳的 job_id 輪詢 get_job_status。

參數

名稱類型必填
target str 必填
adjustments dict | None 選填
photo_id int | None 選填
photo_ids list[int] | None 選填
mode str 選填
name str | None 選填
remove bool 選填

如何要求

你不需要指名呼叫它。你說出想要的,代理會挑選工具:

把 imagic 指向我的這場拍攝,告訴我你發現了什麼。

其餘的 編輯 工具

list_presets apply_preset list_luts apply_lut apply_auto_color harmonize_series preview_mosaic apply_adjustments crop_photo save_preset export_photos get_photo_edits

在哪裡執行

在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序;照片絕不會離開你的磁碟,也不會上傳任何東西。參考文件中的每個工具都是如此,包括這一個。

要呼叫它,你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。

把整條流程交給你的 AI

mask_adjust 是 imagic Max 中 30 個工具之一。500 次匯出的免費試用包含全部工具。