MacでFLUX.2 Kleinの参照画像編集を行う

写真のマグカップの色だけを変え、影と背景の葉は残したい場面を考えます。新しい場面を描くtext-to-imageとは異なり、編集では元画像を入力する必要があります。promptだけでは既存画像のどの部分を保持すべきかモデルに伝わりません。

例のフォルダーに、正面写真`mug-front.png`、同じマグカップの側面写真`mug-side.png`、希望する濃い青色の見本`blue-swatch.png`を置きます。promptでは、それぞれ編集対象、形状参照、色参照であることを明記します。変更する色と、残す取っ手・テーブル・影を分けて指示すると、結果でどの条件が抜けたか判断しやすくなります。

MFLUXはApple Silicon MacでMLXを使うコミュニティプロジェクトです。MLX Metal³経路の現行要件はmacOS 14以降のため、Intel Macや古いmacOSでも同じ構成が動くとは限りません。BFLの公式FLUX.2 repositoryはモデル系列とライセンスの確認先であり、以下の`mflux-generate-flux2-edit`はMFLUXのCLI⁴です。両者は別のプロジェクトです。

MFLUXのFLUX.2文書では、編集用Klein 4Bと9B、および参照画像編集向けの9B-KV variantが案内されています。ダウンロード容量だけなら4Bが始めやすいものの、モデルファイルのサイズは生成中に必要な総メモリではありません。Macで開いているアプリ、入力画像の枚数と解像度、runtimeの作業領域も容量を使います。unified memory⁵やディスクの空きが少ない場合は、ダウンロード前に確認してください。

名前にKleinとあるからといって、ライセンスを一括りにしないでください。BFLの公式repositoryではKlein 4BはApache-2.0、9B系列は非商用条件と区別されています。商用利用では、選択したモデルrepositoryのlicenseとBFLの最新利用条件を確認してください。技術的に読み込めることと、目的に沿って利用できることは別の確認です。

例ではまず`flux2-klein-4b`を使います。9Bまたは9B-KVを試す場合はmodel optionだけを変更し、同じ元画像と編集指示を使います。9B-KVのcache機能は参照画像を入力する編集経路に関するものであり、テキストのみの通常生成にも適用されるとは説明しないでください。

MFLUX公式READMEでは、`uv`を使ったtool installが案内されています。Homebrew導入済みのApple Silicon Macでは、まず`brew install uv`を実行し、`uv --version`で確認します。Homebrewを使わない場合はuvの公式インストールガイドからmacOS向けの方法を選んでください。続いて`uv tool install --upgrade mflux`でMFLUXを入れ、`uv tool list`と`mflux-generate-flux2-edit --help`でCLIと編集オプションを確認します。モデルは初回実行時に自動ダウンロードされるため、ネットワークとディスク容量を確保します。以下の3画像ファイルはコマンドを実行するフォルダーに置いてください。

コマンド終了後、ターミナルで出力先を確認するか、画像が保存されたことを確かめ、Previewでマグカップと周囲の影を元画像と比較します。結果が生成されても細部がすべて保持されたとは限らないため、縁と取っ手の位置も個別に確認してください。実写真の画素を完全に保った編集が保証されるわけではありません。

マグカップだけが変わらなかった場合は、まず入力パスとpromptが認識されたか確認します。影や葉も変わった場合は、保持する要素をpromptでもっと具体的に指定し、同じseedと元画像で再実行します。最初からsteps、モデルサイズ、seed、参照画像数をすべて変えると、何が結果に影響したか切り分けられません。

同じ元画像とseedで、変更範囲を絞ったpromptの結果を保存し、必要な場合だけ9Bモデルを検討します。大きいモデルファイルはより多くのストレージとメモリを必要とし、どの入力でも品質が自動的に向上する保証はありません。細かな柄や正確な文字が重要なら、出力をそのまま使わず、元画像と照合するか別途編集してください。

Apple Silicon対応でも、すべてのMacのメモリ構成で動くわけではありません。プロセスが終了する、またはメモリ不足になる場合は、まず他の画像生成アプリやブラウザを閉じ、同じ4B設定で再試行します。それでも失敗するならMFLUXのインストール文書でmacOS・Python・モデルの現行要件を確認し、エラーログを調べます。メモリ不足への最初の対処として9Bに切り替えるべきではありません。

マグカップの写真に戻ると、青色がきれいに変わったかだけが判断基準ではありません。元画像と結果を並べ、輪郭・取っ手・影・葉が保たれているか確認します。元写真を使った編集でも画素単位の保持は保証されないため、製品色の正確さが必要な場合は出力の検査と別途デザイン編集が必要になることがあります。

編集を繰り返し測定する場合は、同じMac、MFLUX version、model revision、元ファイル、解像度、promptを記録し、ウォームアップ後に複数回の生成時間を測ります。画像生成時間はテキストLLM⁶のtoken⁷速度とは別の指標です。このガイドでは生成時間を実測しておらず、公式ブログや別のMacの時間をこの構成のbenchmarkとして流用していません。

4Bファイルがメモリとライセンスの条件に合うなら、まずその構成で編集を試します。同じマグカップ写真で繰り返し試しても保持条件を満たさず、Macに読み込む余裕がある場合に限り、大きいモデルやKV variantを比較してください。新しい画像の生成と、渡された写真の一要素だけを変える編集の違いに合わせてモデルと入力経路を選びます。

インストールと対応条件は以下の公式資料で確認しました。再現する際は使用したモデルとランタイムのバージョンも記録してください。