fal-text-to-image

fal.ai 画像生成・編集スキル

FLUX、Recraft V3、Imagen4 など、fal.ai の最先端モデルを使用した、プロフェッショナル向けの AI 画像ワークフローです。

3 つの操作モード

1. テキストから画像生成（fal-text-to-image）

テキストプロンプトを使って、画像をゼロから生成します

2. 画像のリミックス（fal-image-remix）

構図を維持しながら、既存の画像を変換します

3. 画像編集（fal-image-edit）

インペインティングやマスクを使った編集を行います

このスキルを使用する場面

次のようなユーザーのリクエストがあった場合に使用します。

• テキストの説明から画像を生成したい
• AI を使って既存の画像を変換またはリミックスしたい
• 画像の特定の領域を編集したい（インペインティング）
• 特定のスタイル（ベクター、リアル、タイポグラフィ）の画像を作成したい
• 高解像度のプロフェッショナルな画像が必要（最大 2K）
• スタイル変換に参照画像を使いたい
• FLUX、Recraft、Imagen などの特定のモデルに言及している
• ロゴ、ポスター、ブランドスタイルの画像生成を依頼している
• オブジェクトの削除や、対象を絞った変更が必要

クイックスタート

テキストから画像生成：ゼロから生成

# Basic generation
uv run python fal-text-to-image "A cyberpunk city at sunset with neon lights"

# With specific model
uv run python fal-text-to-image -m flux-pro/v1.1-ultra "Professional headshot"

# With style reference
uv run python fal-text-to-image -i reference.jpg "Mountain landscape" -m flux-2/lora/edit

画像のリミックス：既存の画像を変換

# Transform style while preserving composition
uv run python fal-image-remix input.jpg "Transform into oil painting"

# With strength control (0.0=original, 1.0=full transformation)
uv run python fal-image-remix photo.jpg "Anime style character" --strength 0.6

# Premium quality remix
uv run python fal-image-remix -m flux-1.1-pro image.jpg "Professional portrait"

画像編集：対象を絞った変更

# Edit with mask image (white=edit area, black=preserve)
uv run python fal-image-edit input.jpg mask.png "Replace with flowers"

# Auto-generate mask from text
uv run python fal-image-edit input.jpg --mask-prompt "sky" "Make it sunset"

# Remove objects
uv run python fal-image-edit photo.jpg mask.png "Remove object" --strength 1.0

# General editing (no mask)
uv run python fal-image-edit photo.jpg "Enhance lighting and colors"

モデル選択ガイド

スクリプトは、タスクのコンテキストに基づいて最適なモデルをインテリジェントに選択します。

flux-pro/v1.1-ultra（高解像度向けデフォルト）

• 最適な用途：プロフェッショナルな写真、高解像度の出力（最大 2K）
• 強み：写真のリアルさ、プロフェッショナルな品質
• 使用する場面：ユーザーが出版に使える画像を必要としている場合
• エンドポイント：fal-ai/flux-pro/v1.1-ultra

recraft/v3/text-to-image（最高水準の品質）

• 最適な用途：タイポグラフィ、ベクターアート、ブランドスタイルの画像、長いテキスト
• 強み：業界トップクラスのベンチマークスコア、正確なテキスト描画
• 使用する場面：ロゴ、ポスター、テキスト主体のデザインを作成する場合
• エンドポイント：fal-ai/recraft/v3/text-to-image

flux-2（最適なバランス）

• 最適な用途：汎用的な画像生成
• 強み：リアルさの向上、鮮明なテキスト、ネイティブ編集
• 使用する場面：標準的な画像生成が必要な場合
• エンドポイント：fal-ai/flux-2

flux-2/lora（カスタムスタイル）

• 最適な用途：特定分野のスタイル、ファインチューニングされたバリエーション
• 強み：カスタムスタイルへの適応
• 使用する場面：ユーザーが特定のアートスタイルを希望している場合
• エンドポイント：fal-ai/flux-2/lora

flux-2/lora/edit（スタイル変換）

• 最適な用途：スタイル参照を使った画像から画像への編集
• 強み：スタイル変換に特化
• 使用する場面：ユーザーが -i フラグで参照画像を指定している場合
• エンドポイント：fal-ai/flux-2/lora/edit

imagen4/preview（Google 品質）

• 最適な用途：高品質な汎用画像
• 強み：Google の最高品質モデル
• 使用する場面：ユーザーが Imagen または Google のモデルを明示的に希望している場合
• エンドポイント：fal-ai/imagen4/preview

stable-diffusion-v35-large（タイポグラフィとスタイル）

• 最適な用途：複雑なプロンプト、タイポグラフィ、スタイルの制御
• 強み：高度なプロンプト理解、リソース効率
• 使用する場面：複数の要素を含む複雑な構図の場合
• エンドポイント：fal-ai/stable-diffusion-v35-large

ideogram/v2（タイポグラフィ特化）

• 最適な用途：ポスター、ロゴ、テキスト主体のデザイン
• 強み：優れたタイポグラフィ、リアルな出力
• 使用する場面：テキストの正確さが重要な場合
• エンドポイント：fal-ai/ideogram/v2

bria/text-to-image/3.2（商用利用に適したモデル）

• 最適な用途：ライセンス済みのトレーニングデータが必要な商用プロジェクト
• 強み：商用利用に適しており、優れたテキスト描画
• 使用する場面：法務やライセンスに関する懸念が重要な場合
• エンドポイント：fal-ai/bria/text-to-image/3.2

コマンドラインインターフェース

uv run python fal-text-to-image [OPTIONS] PROMPT

Arguments:
  PROMPT                    Text description of the image to generate

Options:
  -m, --model TEXT         Model to use (see model list above)
  -i, --image TEXT         Path or URL to reference image for style transfer
  -o, --output TEXT        Output filename (default: generated_image.png)
  -s, --size TEXT          Image size (e.g., "1024x1024", "landscape_16_9")
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps (model-dependent)
  --guidance FLOAT         Guidance scale (higher = more prompt adherence)
  --help                   Show this message and exit

認証の設定

初回使用の前に、fal.ai API キーを設定してください。

export FAL_KEY="your-api-key-here"

または、スキルディレクトリに .env ファイルを作成します。

FAL_KEY=your-api-key-here

API キーは次の場所から取得してください：https://fal.ai/dashboard/keys

高度な使用例

高解像度のプロフェッショナル写真

uv run python fal-text-to-image \
  -m flux-pro/v1.1-ultra \
  "Professional headshot of a business executive in modern office" \
  -s 2048x2048

ロゴ・タイポグラフィのデザイン

uv run python fal-text-to-image \
  -m recraft/v3/text-to-image \
  "Modern tech startup logo with text 'AI Labs' in minimalist style"

参照画像からのスタイル変換

uv run python fal-text-to-image \
  -m flux-2/lora/edit \
  -i artistic_style.jpg \
  "Portrait of a woman in a garden"

再現可能な生成

uv run python fal-text-to-image \
  -m flux-2 \
  --seed 42 \
  "Futuristic cityscape with flying cars"

モデル選択ロジック

-m が指定されていない場合、スクリプトは最適なモデルを自動的に選択します。

1. -i が指定されている場合：スタイル転送には flux-2/lora/edit を使用します
2. プロンプトにタイポグラフィ関連のキーワード（logo、text、poster、sign）が含まれる場合：recraft/v3/text-to-image を使用します
3. プロンプトから高解像度が必要と判断される場合（professional、portrait、headshot）：flux-pro/v1.1-ultra を使用します
4. プロンプトに vector/brand が含まれる場合：recraft/v3/text-to-image を使用します
5. デフォルト：汎用モデルとして flux-2 を使用します

出力形式

生成された画像は、メタデータとともに保存されます。

• ファイル名にはタイムスタンプとモデル名が含まれます
• EXIF データにはプロンプト、モデル、パラメーターが保存されます
• コンソールには生成時間と推定コストが表示されます

トラブルシューティング

問題	解決策
FAL_KEY not set	FAL_KEY 環境変数をエクスポートするか、.env ファイルを作成してください
Model not found	モデル名がサポート対象の一覧に含まれているか確認してください
Image reference fails	画像のパスまたは URL にアクセスできることを確認してください
Generation timeout	モデルによっては時間がかかります。待つか、より高速なモデルをお試しください
Rate limit error	fal.ai ダッシュボードで使用制限を確認してください

コストの最適化

• 無料枠：FLUX.2 では無料リクエストを 100 回利用できます（有効期限：2025 年 12 月 25 日）
• 従量課金：FLUX Pro はメガピクセル単位で課金されます
• 低コストの選択肢：汎用用途には flux-2 または stable-diffusion-v35-large を使用してください
• プレミアム：高解像度が必要な場合に限り flux-pro/v1.1-ultra を使用してください

画像のリミックス：モデル選択ガイド

画像から画像へのリミックスに利用できるモデル：

flux-2/dev（デフォルト、無料）

• 最適な用途：一般的なリミックス、スタイル転送、高速な反復
• 強み：品質と速度のバランス、無料リクエスト 100 回
• 使用する場面：標準的なリミックスが必要な場合
• エンドポイント：fal-ai/flux/dev/image-to-image

flux-pro（プレミアム品質）

• 最適な用途：プロ品質のリミックス、高品質な出力
• 強み：優れた品質、リアルな変換
• 使用する場面：プロ品質または公開可能な仕上がりのリミックスが必要な場合
• エンドポイント：fal-ai/flux-pro

flux-1.1-pro（ウルトラプレミアム）

• 最適な用途：最大限のディテールを備えた最高品質のリミックス
• 強み：非常に高い品質、ディテールの優れた保持
• 使用する場面：可能な限り最高の出力が求められるプレミアムプロジェクト
• エンドポイント：fal-ai/flux-pro/v1.1

recraft/v3（ベクター／イラスト）

• 最適な用途：ベクタースタイル、ブランド画像、イラストのリミックス
• 強み：クリーンなベクター出力、ブランドスタイルへの変換
• 使用する場面：イラストまたはベクタースタイルに変換する場合
• エンドポイント：fal-ai/recraft/v3/text-to-image

stable-diffusion-v35（アーティスティック）

• 最適な用途：アーティスティックなスタイル、絵画効果、クリエイティブなリミックス
• 強み：アーティスティックなスタイルを強く反映
• 使用する場面：アーティスティックまたはスタイライズされた変換
• エンドポイント：fal-ai/stable-diffusion-v35-large

画像のリミックス：コマンドラインインターフェース

uv run python fal-image-remix [OPTIONS] INPUT_IMAGE PROMPT

Arguments:
  INPUT_IMAGE               Path or URL to source image
  PROMPT                    How to transform the image

Options:
  -m, --model TEXT         Model to use (auto-selected if not specified)
  -o, --output TEXT        Output filename (default: remixed_TIMESTAMP.png)
  -s, --strength FLOAT     Transformation strength 0.0-1.0 (default: 0.75)
                           0.0 = preserve original, 1.0 = full transformation
  --guidance FLOAT         Guidance scale (default: 7.5)
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps
  --help                   Show help

リミックスの強度ガイド

--strength パラメーターで変換の強度を調整します。

強度	効果	使用例
0.3-0.5	わずかな変化	軽微な色調整、照明の微調整
0.5-0.7	中程度の変化	ディテールを保ちながらスタイルのヒントを加える
0.7-0.85	大きな変化	明確なスタイル転送、大幅な変換
0.85-1.0	最大限の変化	スタイルを全面的に刷新、劇的な変換

リミックスの例

# Subtle artistic style (low strength)
uv run python fal-image-remix photo.jpg "Oil painting style" --strength 0.4

# Balanced transformation (default)
uv run python fal-image-remix input.jpg "Cyberpunk neon aesthetic"

# Strong transformation (high strength)
uv run python fal-image-remix portrait.jpg "Anime character" --strength 0.9

# Vector conversion
uv run python fal-image-remix -m recraft/v3 logo.png "Clean vector illustration"

# Premium quality remix
uv run python fal-image-remix -m flux-1.1-pro photo.jpg "Professional studio portrait"

画像編集：モデル選択ガイド

対象を絞った編集とインペインティングに利用できるモデル：

flux-2/redux（一般的な編集）

• 最適な用途：マスクを使わない一般的な画像編集
• 強み：高速でバランスがよく、全体的な調整に適しています
• 使用する場面：特定の領域を指定する必要がない場合
• エンドポイント：fal-ai/flux-2/redux

flux-2/fill（インペインティング、デフォルト）

• 最適な用途：マスク領域の編集、オブジェクトの削除、領域の補完
• 強み：シームレスなインペインティング、自然ななじみ
• 使用する場面：特定のマスク領域を編集する場合
• エンドポイント：fal-ai/flux-2/fill

flux-pro-v11/fill（プレミアムなインペインティング）

• 最適な用途：最高品質のプロフェッショナルなインペインティング
• 強み：優れた品質、プロフェッショナルな仕上がり
• 使用する場面：プレミアム品質のインペインティングが必要な場合
• エンドポイント：fal-ai/flux-pro-v11/fill

stable-diffusion-v35/inpainting（アーティスティックなインペインティング）

• 最適な用途：アーティスティックな編集、クリエイティブなインペインティング
• 強み：優れた芸術的制御、詳細な生成
• 使用する場面：アーティスティックまたは様式化された編集
• エンドポイント：fal-ai/stable-diffusion-v35-large/inpainting

ideogram/v2/edit（リアルな編集）

• 最適な用途：リアルな修正、精密な編集
• 強み：高いリアリティ、精密な制御
• 使用する場面：リアルな編集が必要な場合
• エンドポイント：fal-ai/ideogram/v2/edit

recraft/v3/svg（ベクター編集）

• 最適な用途：ベクタースタイルの編集、すっきりとしたイラスト
• 強み：すっきりとしたベクター出力、イラストスタイル
• 使用する場面：ベクターまたはイラストの編集
• エンドポイント：fal-ai/recraft/v3/svg

画像編集：コマンドラインインターフェース

uv run python fal-image-edit [OPTIONS] INPUT_IMAGE [MASK_IMAGE] PROMPT

Arguments:
  INPUT_IMAGE               Path or URL to source image
  MASK_IMAGE                Path or URL to mask (white=edit, black=preserve) [optional]
  PROMPT                    How to edit the masked region

Options:
  -m, --model TEXT         Model to use (auto-selected if not specified)
  -o, --output TEXT        Output filename (default: edited_TIMESTAMP.png)
  --mask-prompt TEXT       Generate mask from text (no mask image needed)
  -s, --strength FLOAT     Edit strength 0.0-1.0 (default: 0.95)
  --guidance FLOAT         Guidance scale (default: 7.5)
  --seed INTEGER           Random seed for reproducibility
  --steps INTEGER          Number of inference steps
  --help                   Show help

編集強度のガイド

--strength パラメーターは編集の強度を制御します。

強度	効果	用途
0.5-0.7	控えめな編集	細かな修正、色調整
0.7-0.9	中程度の編集	自然になじませながら、はっきりと変更
0.9-1.0	強い編集	完全な置き換え、オブジェクトの削除

マスク画像の作成

マスク画像は編集範囲を指定します。

• 白（255）：編集・変更する領域
• 黒（0）：変更せずに保持する領域
• グレー：部分的なブレンド（明るさに比例）

マスクは次の方法で作成できます。

• 画像編集ソフト（GIMP、Photoshop、Krita）
• ペイントツール（領域を選択し、白または黒で塗りつぶす）
• テキストベースのプロンプト（--mask-prompt フラグ）

編集例

# Edit with mask image
uv run python fal-image-edit photo.jpg mask.png "Replace with beautiful garden"

# Auto-generate mask from text
uv run python fal-image-edit landscape.jpg --mask-prompt "sky" "Make it sunset with clouds"

# Remove objects
uv run python fal-image-edit photo.jpg object_mask.png "Remove completely" --strength 1.0

# Seamless object insertion
uv run python fal-image-edit room.jpg region_mask.png "Add modern sofa" --strength 0.85

# General editing (no mask)
uv run python fal-image-edit -m flux-2/redux photo.jpg "Enhance lighting and saturation"

# Premium quality inpainting
uv run python fal-image-edit -m flux-pro-v11/fill image.jpg mask.png "Professional portrait background"

# Artistic modification
uv run python fal-image-edit -m stable-diffusion-v35/inpainting photo.jpg mask.png "Van Gogh style"

ファイル構成

fal-text-to-image/
├── SKILL.md                    # This file
├── README.md                   # Quick reference
├── pyproject.toml              # Dependencies (uv)
├── fal-text-to-image           # Text-to-image generation script
├── fal-image-remix             # Image-to-image remixing script
├── fal-image-edit              # Image editing/inpainting script
├── references/
│   └── model-comparison.md     # Detailed model benchmarks
└── outputs/                    # Generated images (created on first run)

依存関係

uv で管理します。

• fal-client：fal.ai 公式の Python SDK
• python-dotenv：環境変数の管理
• pillow：画像処理と EXIF メタデータ
• click：CLI インターフェース

ベストプラクティス

全般

1. モデルの選択：特別な要件がない場合は、スクリプトによる自動選択を使用してください
2. プロンプトエンジニアリング：より良い出力を得るには、具体的で詳しく記述してください
3. コストの把握：fal.ai ダッシュボードで使用状況を確認してください
4. 再現性：反復作業で一貫した結果を得るには、--seed を使用してください

テキストから画像を生成

1. 参照画像：最良のスタイル転送結果を得るには、高品質な参照画像を使用してください
2. サイズの選択：用途に合わせてアスペクト比を選択してください（正方形、横長、縦長）
3. モデルの選択：タイポグラフィには recraft/v3、プロフェッショナルな写真には flux-pro を使用してください

画像リミックス

1. 強度の調整：デフォルト（0.75）から始め、希望する変化に応じて調整してください
2. 元画像の品質：元画像の品質が高いほど、より良いリミックス結果が得られます
3. 反復：同じ生成結果を異なるプロンプトで調整するには、--seed を使用してください
4. バランス：強度を下げると細部がより保持され、上げるとより劇的に変化します

画像編集

1. マスクの品質：きれいで明確に定義されたマスクほど、より良い結果が得られます
2. マスクの作成：精密に制御するには画像編集ソフトを、手早く試すには --mask-prompt を使用してください
3. ブレンド：マスクにグレーの濃淡を使用すると、滑らかな切り替わりになります
4. 編集強度：オブジェクトの削除には 0.95 以上、変更には 0.7～0.9 を使用してください
5. まず試す：詳細なマスクを作成する前に、--mask-prompt を試してください
6. 複数箇所の編集：複雑な変更は一度にまとめて行わず、段階的に編集してください

リソース

• fal.ai ドキュメント：https://docs.fal.ai/
• モデルプレイグラウンド：https://fal.ai/explore/search
• API キー：https://fal.ai/dashboard/keys
• 料金：https://fal.ai/pricing

ワークフローの例

画像作成の完全なパイプライン

# 1. Generate base image
uv run python fal-text-to-image -m flux-2 "Modern office space, minimalist" -o base.png

# 2. Remix to different style
uv run python fal-image-remix base.png "Cyberpunk aesthetic with neon" -o styled.png

# 3. Edit specific region
uv run python fal-image-edit styled.png --mask-prompt "desk" "Add holographic display"

反復的な調整

# Generate with seed for reproducibility
uv run python fal-text-to-image "Mountain landscape" --seed 42 -o v1.png

# Remix with same seed, different style
uv run python fal-image-remix v1.png "Oil painting style" --seed 42 -o v2.png

# Fine-tune with editing
uv run python fal-image-edit v2.png --mask-prompt "sky" "Golden hour lighting" --seed 42

オブジェクトの削除と置き換え

# 1. Remove unwanted object
uv run python fal-image-edit photo.jpg object_mask.png "Remove" --strength 1.0 -o removed.png

# 2. Fill with new content
uv run python fal-image-edit removed.png region_mask.png "Beautiful flowers" --strength 0.9

トラブルシューティング

問題	解決策	ツール
FAL_KEY not set	FAL_KEY をエクスポートするか、.env ファイルを作成してください	すべて
Model not found	ドキュメントでモデル名を確認してください	すべて
Image upload fails	ファイルが存在し、読み取り可能であることを確認してください	Remix、Edit
Mask not working	マスクがグレースケール PNG（白＝編集）であることを確認してください	Edit
Transformation too strong	--strength の値を小さくしてください	Remix、Edit
Transformation too weak	--strength の値を大きくしてください	Remix、Edit
Mask-prompt not precise	画像エディターで手動マスクを作成してください	Edit
Generation timeout	より高速なモデルを試すか、時間を置いてください	すべて
Rate limit error	fal.ai ダッシュボードで使用制限を確認してください	すべて

制限事項

全般

• 有効な fal.ai API キーが必要です
• fal.ai のレート制限とクォータが適用されます
• インターネット接続が必要です
• モデルによっては使用料金が発生します（料金を確認してください）

テキストから画像への変換

• 画像参照機能は特定のモデルに限定されています
• タイポグラフィの品質はモデルによって異なります

画像のリミックス

• 元画像の品質は出力品質に影響します
• 強度を極端な値にすると、アーティファクトが発生する場合があります
• スタイルによっては、特定のモデルとの相性がよいものがあります

画像編集

• シームレスな結果を得るには、マスクの品質が重要です
• 自動生成マスク（--mask-prompt）は手動マスクより精度が低くなります
• 複雑な編集には複数回の処理が必要な場合があります
• モデルによっては、すべての編集機能に対応していません