apply_adjustments

内容

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と同じです。ハイライトのマイナスは明るい部分を回復し、exposure +50は一段分です。imagicの従来のエンジンで編集された写真は、ルックを保ったまま先に現在のエンジンへ移されるため、これらの値はどの写真でも同じ意味になります。

パラメーター

頼み方

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

このフォルダーのすべての採用写真に、暖かいフィルム調のルックを適用して、品質92でJPEGをエクスポートしてください。

編集のほかのツール

このツールを使うワークフロー

• AIエージェントでRAWファイルを一括編集する — AIでRAWファイルを一括編集

実行される場所

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

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