編集

crop_photo

写真を縦横比でクロップします。ピクセルの計算はimagicが行います。

内容

aspectは、"3:1"(パノラマの細長い形)、"16:9"、"4:5"、"1:1"、"9:16"(ストーリーズ)、"original"、またはboxと組み合わせる"free"のような比率です。クロップは、フレームに収まるその形で最大のもので、size(1.0 = 可能な限り大きく、0.5 = 幅が半分で、より引き締まったクロップ)で拡大縮小され、center_x / center_yを中心にします。これらはフレームに対する割合です(0 = 左/上、1 = 右/下で、内側に収まるよう調整されます)。中央にない水平線や被写体には、center_y / center_xをそちらへ寄せます。たとえば、水平線が中央のすぐ上ならcenter_y=0.45です。box = [x0, y0, x1, y1]の割合を指定すると、クロップを正確に決められます(aspect "free")。clear=trueでクロップを外します。エディターのクロップとして保存されるので、エクスポートもクロップされ、エディターにも同じフレームが表示されます。クロップの範囲を割合で、結果のサイズとともに返します。

パラメーター

名前型必須
aspect str 任意
photo_id int | None 任意
photo_ids list[int] | None 任意
center_x float 任意
center_y float 任意
size float 任意
box list[float] | None 任意
clear bool 任意

頼み方

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

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

編集のほかのツール

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

実行される場所

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

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

AIにパイプライン全体を任せる

crop_photoは、imagic Maxにある30個のツールの一つです。エクスポート500回の無料トライアルには、そのすべてが含まれます。