mask_adjust

内容

targetは"subject"、"sky"、"people"、"background"のいずれかで、imagicはデスクトップのエディターと同じAI Maskingで、これを見つけます（このパソコン上で、写真一枚あたり一、二秒）。adjustmentsには、apply_adjustmentsと同じスライダー名を使います。たとえば、被写体に{"exposure": 15, "clarity": 10}、背景に{"exposure": -20, "saturation": -15}を指定すると、両者を切り離せます。フレーム全体のキー（crop、rotation、fx_preset）は拒否されるので、それらはapply_adjustmentsで設定してください。mode "relative"（デフォルト）は、Lightroomのマスクのように、写真の現在のルックの上に値を加えます。mode "isolated"は、元の写真からこれらの値だけでその領域を描画するため、あとからのグローバルな編集の影響を受けなくなります（エディターのレイヤーのデフォルト）。各レイヤーは、ターゲット名（またはname）を付けたエディターのマスクレイヤーとして保存され、エクスポートに含まれ、エディターで写真を開き直すと、そのレイヤーが専用のタブとして現れます。同じターゲットまたはnameで再度呼び出すと、別のレイヤーを重ねずにそのレイヤーが置き換わり、remove=trueで削除できます。一枚の写真にはphoto_id、複数にはphoto_idsを渡します（それぞれが専用のマスクを持ちます）。マスクの範囲（フレームに占める割合）と、写真のレイヤーの一覧を返します。get_photo_editsもレイヤーを一覧表示します。リモート接続では、長い一括処理はバックグラウンドのジョブとして実行されるため、返されたjob_idでget_job_statusを呼び出して確認してください。

パラメーター

頼み方

名前で呼ぶ必要はありません。やりたいことを伝えれば、エージェントがツールを選びます：

私の撮影分にimagicを向けて、何が見つかったか教えてください。

編集のほかのツール

実行される場所

お使いのパソコン上です。imagicのMCPサーバーは、AIクライアントが起動するローカルのプロセスで、写真がディスクの外に出ることはなく、何もアップロードされません。これは、このリファレンスにあるすべてのツールに当てはまり、このツールも同じです。

呼び出すには、imagicに接続されたMCPクライアントが必要です。Claude Code、Cursor、VS Code、Codex、Gemini CLIなど十のクライアントで、セットアップは三分ほどです。