fal-ai-image

fal-ai-image

fal.ai 経由で画像を生成します。このスキルは現在、fal がホストする 2 つのモデルに対応しています。

• Google Nano Banana Pro (fal-ai/nano-banana-pro) — デフォルト。後方互換性があります
• OpenAI GPT Image 2 (openai/gpt-image-2) — config/.env から有効にできます

エージェントが同等として扱うべき同義語：

• gpt = openai = GPT Image 2
• nano banana = google = gemini = Nano Banana Pro

特に適している用途：インフォグラフィック、テキスト描画、バナー、写真の編集、参照画像に基づく構図。

停止 — 実行前にお読みください

• 禁止：ユーザーがそのワークフローを明示的に依頼した場合を除き、テキストやロゴの重ね合わせに Pillow、ImageMagick、後処理を使用しないでください
• 禁止：ユーザーが参照画像を提供した場合に Generate モードを使用しないでください — Edit モードを使用してください
• 禁止：GPT が有効だと思い込まないでください — config/README.md の設定ロジックを確認してください。セレクターが設定されていない場合、このスキルは Nano Banana を使用します
• 禁止：プロバイダー固有のパラメーターを推測しないでください — Nano Banana と GPT Image 2 ではスキーマが異なります
• 必須：ユーザーが特定のモデル／プロバイダーを明示的に指定した場合、またはプロバイダーの比較を依頼した場合は、--model ... を渡してください
• 禁止：ローカルファイルのアップロードを省略しないでください — edit.sh 用の URL を取得するため、先に upload.sh を実行してください

クイックスタートの選択

Reference images provided?  -> Edit mode   (upload.sh -> edit.sh)
Text-only generation?       -> Generate mode (generate.sh)

Model comes from config/.env:
  no selector set           -> Nano Banana Pro
  FAL_IMAGE_PROVIDER=openai -> GPT Image 2
  FAL_IMAGE_MODEL=...       -> exact override

設定

config/.env または環境変数に FAL_KEY が必要です。

モデルの選択順：

1. --model — 現在のコマンドに対する一時的な上書き
2. FAL_IMAGE_MODEL — 設定内の完全な上書き
3. FAL_IMAGE_PROVIDER — google または openai
4. 何も設定されていない場合 — デフォルトで Nano Banana Pro を使用

ユーザーが次のように明示した場合は、--model を使用してください。

• "сделай через GPT"
• "используй OpenAI"
• "сделай через Google / Gemini / Nano Banana"
• "какие тут есть провайдеры?"

このスキルが 2 つの選択肢に対応していることを伝え、コマンドを次のように指定してください。

• OpenAI GPT Image 2 の場合は --model gpt
• Nano Banana の場合は --model gemini または --model nano-banana

OpenAI のデフォルト画質：

• --quality で上書きしない限り、FAL_IMAGE_OPENAI_QUALITY=medium
• GPT のデフォルトには、探索的な実行で高額にならないよう、意図的に medium を使用しています

セットアップとトラブルシューティングの詳細：config/README.md。

必要に応じて、以下のリファレンスを参照してください。

• references/MODELS.md — セレクターの優先順位、別名、コストの目安
• references/EDITING.md — generate と edit の違い、mask_url、インペインティングの動作

モデルについて

Nano Banana Pro

特長：

• 既存のインストールで手軽に使えるデフォルト
• キリル文字を含むテキスト描画に強い
• インフォグラフィック、バナー、テキストと画像を組み合わせたレイアウトに適している
• generate モードで --web-search に対応

主なパラメーター：

• --aspect-ratio
• --resolution
• --web-search（generate のみ）

OpenAI GPT Image 2

特長：

• プロンプトへの忠実度が高く、細かな編集に強い
• 写実性や商品向けのレンダリングに優れている
• ネイティブの quality 制御に対応
• fal 経由で同じ FAL_KEY を使用するため、別途 OpenAI キーは不要
• 現在の fal の料金はサイズと画質によって異なります。高画質の場合の大まかな目安は画像 1 枚あたり約 $0.18 ですが、正確な金額を提示する前に、最新のモデルページを確認してください

主なパラメーター：

• --image-size
• --quality

互換性レイヤー：

• --image-size を省略した場合、スクリプトは --aspect-ratio と --resolution から有効な OpenAI image_size を導き出します
• これにより、設定でプロバイダーを切り替えた後も、以前のプロンプトを引き続き使用できます

ワークフロー

Generate モード

1. 設定からモデルを決定します
2. 必要な場合に限り、不足しているパラメーターを確認します：
   • Nano Banana：アスペクト比、解像度
   • GPT Image 2：画像サイズ、画質
3. プロジェクトの構成に基づいて保存先のパスを提案します
4. generate.sh を実行します
5. 結果の JSON を解析し、ダウンロード済みの場合は URL とローカルファイルを報告します

Edit モード

1. 参照画像を用意します：
   • URL がすでにある場合 → そのまま使用します
   • ローカルファイルの場合 → upload.sh を実行します
2. 設定からモデルを決定します
3. 編集内容を確認します
4. edit.sh を実行します
5. 結果の JSON を解析し、ダウンロード済みの場合は URL とローカルファイルを報告します

スクリプト

generate.sh

Nano Banana の例：

sh scripts/generate.sh \
  --model "gemini" \
  --prompt "infographic about coffee brewing" \
  --aspect-ratio "9:16" \
  --resolution "1K" \
  --output-dir "./images" \
  --filename "coffee_infographic"

GPT Image 2 の例：

sh scripts/generate.sh \
  --model "gpt" \
  --prompt "realistic product hero shot with sharp packaging text" \
  --image-size "landscape_4_3" \
  --quality "medium" \
  --output-dir "./images" \
  --filename "product_hero"

GPT の互換性の例：

sh scripts/generate.sh \
  --model "openai" \
  --prompt "editorial portrait, window light, magazine cover layout" \
  --aspect-ratio "4:3" \
  --resolution "2K"

パラメーター	必須	デフォルト	備考
--prompt	はい	-	テキストプロンプト
--model	いいえ	config / Nano Banana にフォールバック	nano-banana、google、gemini、gpt、openai、または正確なエンドポイント
--aspect-ratio	いいえ	1:1	Nano のネイティブ設定。GPT では --image-size を省略した場合のみ使用
--resolution	いいえ	1K	Nano のネイティブ設定。GPT では --image-size を省略した場合のみ使用
--image-size	いいえ	比率／解像度から算出	GPT のみ。プリセット（landscape_4_3）または WIDTHxHEIGHT
--quality	いいえ	config 経由で medium	GPT のみ。low、medium、high
--num-images	いいえ	1	1～4
--output-format	いいえ	png	jpeg、png、webp
--output-dir	いいえ	-	ローカルパス
--filename	いいえ	generated	ベースファイル名
--web-search	いいえ	false	Nano のみ。GPT では無視

edit.sh

Nano Banana の例：

sh scripts/edit.sh \
  --model "gemini" \
  --prompt "combine these into a collage" \
  --image-urls "https://example.com/img1.png,https://example.com/img2.png" \
  --aspect-ratio "16:9" \
  --output-dir "./images" \
  --filename "collage"

GPT Image 2 の例：

sh scripts/edit.sh \
  --model "gpt" \
  --prompt "make this product shot look like a premium studio campaign" \
  --image-urls "https://example.com/source.png" \
  --mask-url "https://example.com/mask.png" \
  --image-size "auto" \
  --quality "medium" \
  --output-dir "./images" \
  --filename "studio_edit"

パラメーター	必須	デフォルト	備考
--prompt	はい	-	編集指示
--image-urls	はい	-	カンマ区切りの URL
--model	いいえ	config / Nano Banana にフォールバック	nano-banana、google、gemini、gpt、openai、または正確なエンドポイント
--mask-url	いいえ	-	GPT の編集のみ。対象を指定した編集に使用する任意のマスク
--aspect-ratio	いいえ	auto	Nano のネイティブ設定。GPT では --image-size を省略した場合のみ使用
--resolution	いいえ	1K	Nano のネイティブ設定。GPT では --image-size を省略した場合のみ使用
--image-size	いいえ	比率／解像度から算出／auto	GPT のみ
--quality	いいえ	config 経由で medium	GPT のみ
--num-images	いいえ	1	1～4
--output-format	いいえ	png	jpeg、png、webp
--output-dir	いいえ	-	ローカルパス
--filename	いいえ	edited	ベースファイル名

upload.sh

# Get hosted URL for local file
URL=$(sh scripts/upload.sh --file /path/to/image.png)

# Get base64 data URI for manual API work
URI=$(sh scripts/upload.sh --file /path/to/image.png --base64)

コストに関するガイダンス

• Nano Banana Pro は、手早く反復する場合に、より低コストで安全なデフォルトです
• GPT Image 2 のコストは、quality と image_size に大きく左右されます
• このスキルでは、想定外の出費を抑えるため、GPT の品質をデフォルトで medium に設定しています

最新の料金については、fal のモデルページを config/README.md で確認してください。

注意事項

• 結果の URL は約 1 時間で期限切れになります。保持する必要がある場合は、ローカルにダウンロードしてください
• fal ストレージにアップロードしたファイルは一時的なものです
• edit.sh は現在、fal がドキュメント化しているものと同じ /edit キューエンドポイントをポーリングします