gpt-image-1-5

GPT Image 1.5 - 画像生成と編集

OpenAI の GPT Image 1.5 モデルを使用して、新しい画像を生成したり、既存の画像を編集したりできます。

• 生成：Responses API の image_generation ツールを使用します
• 編集：確実なマスクベースのインペインティングには Image API を使用します

使用方法

絶対パスを使用してスクリプトを実行してください（最初にスキルディレクトリへ cd しないでください）。

新しい画像を生成：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--quality low|medium|high] [--size 1024x1024|1024x1536|1536x1024|auto] [--background transparent|opaque|auto] [--api-key KEY]

既存の画像を編集（マスクなし - 画像全体を編集）：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--size 1024x1024|1024x1536|1536x1024|auto] [--api-key KEY]

既存の画像を編集（マスクあり - 正確なインペインティング）：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "what to put in masked area" --filename "output-name.png" --input-image "path/to/input.png" --mask "path/to/mask.png" [--size 1024x1024|1024x1536|1536x1024|auto] [--api-key KEY]

重要： 画像がスキルディレクトリではなくユーザーの作業場所に保存されるよう、必ずユーザーの現在の作業ディレクトリから実行してください。

パラメーター

品質オプション

• low - 最速で生成しますが、品質は低くなります
• medium（デフォルト） - 品質と速度のバランスが取れています
• high - 最高品質ですが、生成に時間がかかります

ユーザーのリクエストに対応する値：

• 品質の指定なし → medium
• 「quick」「fast」「draft」 → low
• 「high quality」「best」「detailed」「high-res」 → high

サイズオプション

• 1024x1024（デフォルト） - 正方形
• 1024x1536 - 縦長
• 1536x1024 - 横長
• auto - プロンプトに基づいてモデルに決定させます

ユーザーのリクエストに対応する値：

• サイズの指定なし → 1024x1024
• 「square」 → 1024x1024
• 「portrait」「vertical」「tall」 → 1024x1536
• 「landscape」「horizontal」「wide」 → 1536x1024

背景オプション（生成のみ）

• auto（デフォルト） - モデルに決定させます
• transparent - 透明な背景（PNG/WebP 出力）
• opaque - 単色の背景

API キー

スクリプトは次の順序で API キーを確認します。

1. --api-key 引数（ユーザーがチャットでキーを指定した場合に使用）
2. OPENAI_API_KEY 環境変数

どちらも使用できない場合、スクリプトはエラーメッセージを表示して終了します。

ファイル名の生成

次のパターンでファイル名を生成します：yyyy-mm-dd-hh-mm-ss-name.png

形式： {timestamp}-{descriptive-name}.png

• タイムスタンプ：現在の日付と時刻。形式は yyyy-mm-dd-hh-mm-ss（24 時間形式）
• 名前：説明的な小文字のテキストをハイフンでつなぎます
• 説明部分は簡潔にします（通常 1～5 語）
• ユーザーのプロンプトまたは会話の文脈を使用します
• 文脈が不明確な場合は、ランダムな識別子を使用します（例：x9k2、a7b3）

例：

• プロンプト「穏やかな日本庭園」 → 2025-12-17-14-23-05-japanese-garden.png
• プロンプト「山々に沈む夕日」 → 2025-12-17-15-30-12-sunset-mountains.png
• プロンプト「ロボットの画像を作成」 → 2025-12-17-16-45-33-robot.png
• 文脈が不明確 → 2025-12-17-17-12-48-x9k2.png

画像の編集

どちらの編集モードでも、確実な結果を得るために gpt-image-1.5 を使用した Image API（images.edit エンドポイント）を利用します。

マスクなし（画像全体を編集）

正確な範囲を指定せずに既存の画像を変更する場合：

1. --input-image パラメーターに画像のパスを指定します
2. プロンプトに編集の指示を含めます（例：「空をもっとドラマチックにする」「カートゥーン風に変更する」）
3. 完全に透明なマスクが自動生成され、モデルが画像全体を編集できるようになります

マスクあり（正確なインペインティング）

特定の範囲を編集する場合：

1. --input-image パラメーターに画像のパスを指定します
2. --mask パラメーターに PNG マスクファイルを指定します
3. 編集する範囲は透明（alpha=0）にします
4. プロンプトでマスク範囲に表示する内容を説明します

よくある編集作業：要素の追加・削除、スタイルの変更、色の調整、背景の置き換えなど。

プロンプトの処理

生成の場合： ユーザーの画像の説明をそのまま --prompt に渡します。明らかに不十分な場合に限り、内容を調整してください。

編集の場合： 編集の指示を --prompt に渡します（例：「空に虹を追加する」「水彩画のように見せる」）。

どちらの場合も、ユーザーの創作意図を尊重してください。

出力

• PNG を現在のディレクトリに保存します（ファイル名にディレクトリが含まれている場合は、指定されたパスに保存します）
• スクリプトは生成された画像のフルパスを出力します
• 画像を読み込まないでください。保存先のパスだけをユーザーに伝えてください

例

新しい画像を生成：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2025-12-17-14-23-05-japanese-garden.png" --quality high --size 1536x1024

背景を透明にして生成：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "A cute cartoon cat mascot" --filename "2025-12-17-14-25-30-cat-mascot.png" --background transparent --quality high

既存の画像を編集（画像全体）：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "make the sky more dramatic with storm clouds" --filename "2025-12-17-14-27-00-dramatic-sky.png" --input-image "original-photo.jpg"

マスクを使って編集（インペインティング）：

uv run ~/.claude/skills/gpt-image-1-5/scripts/generate_image.py --prompt "a flamingo swimming" --filename "2025-12-17-14-30-00-lounge-flamingo.png" --input-image "lounge.png" --mask "mask.png"