使用するタイミング
ユーザーがテキスト説明からカバー画像、サムネイル、バナー、ポスター、ヘッダーを生成するよう依頼した場合に使用します。トリガーとなるリクエスト例:「カバーを生成して」「サムネイルを作成して」「バナーを作って」「設計封面」「生成封面図」など、指定寸法で画像を生成するよう求めるもの全般。
このスキルは2段階のパイプラインを使用します:
- mflux(FLUX.2 4ビット、Apple MLX)が AI 背景画像を生成
- HTML/CSS + Playwright Chromium が上にシャープなテキストをレンダリング
テキストオーバーレイのない一般的な画像生成、画像編集、アップスケーリング、カバー以外の用途には使用しないでください。
要件
- macOS かつ Apple Silicon(M1+)
- 16 GB 以上の RAM 推奨(8 GB でも解像度を下げれば動作する場合あり)
- mflux:
brew install uv && uv tool install mflux - Playwright:
pip install playwright && playwright install chromium - 初回実行時に FLUX.2 モデル(約2~4 GB)をダウンロード。その後は完全オフライン
手順
- 前提条件の確認:
python3 cover_generator.py --detect— mflux と Playwright+Chromium の両方に ✓ が表示されることを確認 - 寸法の決定:プリセットまたは正確な W×H を指定:
youtube-thumbnail(1280×720)、twitter-header(1500×500)、blog-cover(1200×630)instagram-post(1080×1080)、facebook-cover(1640×624)、linkedin-banner(1584×396)podcast-cover(3000×3000)、github-social(1280×640)、story(1080×1920)
- レイアウトの選択:
--layout bottom(デフォルト)、centered、hero、top - グラデーションの選択:
--gradient dark(デフォルト)、subtle、light、none - 生成:
python3 cover_generator.py -p "説明文" --preset blog-cover - プロンプトの最適化:
--prompt(AI背景)には英語を使用し、--title(表示テキスト)には元の言語をそのまま使用 - 確認:出力ファイルが存在し、寸法が正しいことを確認
落とし穴
- mflux は Apple Silicon(M1+)必須 — Intel Mac では実行不可
- Playwright は Chromium を別途インストール(約300 MB のダウンロード)
- 初回の mflux 実行で FLUX.2 モデル(約2~4 GB)をダウンロード。以降はオフライン
- AI プロンプトに中国語テキストを使用すると背景品質が低下する可能性あり —
--promptには英語を使用し、--titleに表示する中国語テキストを指定 - 非常に大きな寸法(3840 px 超)は処理が遅くなる可能性あり。A4 印刷(3508 px)の場合、レンダリングに3~5秒を見込む
- プロンプトの質が背景に大きく影響:スタイルを具体的に指定する(例:「ミニマルな水彩画」「ダークシネマティック」「クリーンな抽象グラデーション」)
- mflux は寸法を64の倍数に丸めるため、背景画像は要求よりわずかに小さくなる場合あり。最終的なオーバーレイ処理で正確な寸法に補正
確認
python3 cover_generator.py --detect— mflux ✓、Playwright+Chromium ✓- パイプライン全体のテスト:
python3 cover_generator.py -p 'A serene mountain lake at dawn' -o test.png - 出力寸法が入力と一致することを確認
- 生モードテスト:
python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png