Codex Gateway Imagegen は何をしますか？

このスキルを使用すると、プロンプトを ~/.codex/config.toml で定義されたゲートウェイ経由で画像ファイルに変換できます。

以下の両方に対応しています：

テキストからの画像生成
1枚以上の参照画像を使用した画像編集

クイックスタート

ユーザーが生成か編集のどちらを希望しているか確認し、出力先のパスも確認します。
対象に合ったサイズを選択します：
- 正方形画像：1024x1024
- 縦長／スマートフォン画面：1024x1536
- 横長：1536x1024
scripts/generate_gateway_image.py を実行します。
画像生成がレート制限された場合は、元のプロンプト、画像、サイズ、アクションを維持します。プロンプトを短縮したり、書き換えたり、簡略化したりしないでください。ヘルパースクリプトがバックオフ付きで同じリクエストを再試行します。
サンドボックス内でTLS、schannel、または読み取りタイムアウトエラーが発生した場合は、ホストネットワークアクセスを昇格させて同じコマンドを再実行します。
保存されたファイルパスを報告します。

ワークフロー

1. プロンプトを整形する

プロンプトは断片ではなく、制作仕様として記述します。以下の内容を含めます：

被写体
シーン
ビジュアルスタイル
構図
照明
出力の手がかり（ライブ配信スクリーンショット、ポスター、フォトリアリスティック、9:16 縦長 など）
必要に応じてUIのオーバーレイや画面上の要素の正確な記述

ユーザーがライブアプリのスクリーンショットのような見た目を希望する場合は、その旨を明示し、オーバーレイについて説明します。

ユーザーが編集を希望する場合は、以下の点も説明します：

参照画像に近い状態を保つべき部分
変更すべき部分
編集が大まかなスタイル変更なのか、忠実度の高い保存なのか

2. 適切なサイズを選ぶ

デフォルトは 1024x1024 ですが、構図が明らかに別のアスペクト比を必要とする場合は変更します。

このワークフローで実績のあるサイズ：

1024x1024
1024x1536

ゲートウェイが Invalid size ... below the current minimum pixel budget のようなエラーを返した場合は、同じサイズで再試行せず、要求するサイズを大きくします。

3. ヘルパースクリプトで生成する

テキストからの画像生成：

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<プロンプト>" --out "<出力パス>" --size 1024x1024

ローカルの参照画像を使用した画像編集：

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<プロンプト>" --image "<参照画像>" --action edit --out "<出力パス>" --size 1024x1536

複数の参照画像を使用した画像編集：

python "${CLAUDE_SKILL_DIR}/scripts/generate_gateway_image.py" --prompt "<プロンプト>" --image "<参照画像1>" --image "<参照画像2>" --action edit --out "<出力パス>" --size 1024x1536

オプションの入力：

--image <パス>：ローカルの参照画像（繰り返し指定可能）
--image-url <URL>：リモートの参照画像（繰り返し指定可能）
--mask <パス>：編集領域を指定するローカルマスク画像
--action auto|generate|edit：デフォルトは auto
--max-retries <数値>：画像レート制限エラー時の最大リトライ回数、デフォルトは 5

スクリプトの動作：

~/.codex/config.toml から base_url を読み取ります
~/.codex/auth.json から OPENAI_API_KEY を読み取ります
/responses を呼び出します
デフォルトで model="gpt-5.5" を使用します
action=auto|generate|edit を指定して image_generation ツールを要求します
プロンプトテキストを input_text として送信します
参照画像を input_image として送信します
オプションのマスクを input_image_mask として送信します
返されたbase64画像をデコードし、出力ファイルに書き込みます

重要：

Responsesの model は gpt-5.5 などのメインモデルのままです
画像生成と編集は image_generation ツールを通じて実行されます
編集の場合は --action edit を推奨し、少なくとも1つの --image を含めます

4. よくある障害モードに対処する

サンドボックス内でネットワークまたはTLSに関連する以下のような症状で呼び出しが失敗した場合：

Authentication failed, see inner exception
schannel: AcquireCredentialsHandle failed
The read operation timed out

これはまず環境パスの問題として扱い、必ずしもゲートウェイの問題ではありません。同じスクリプトをサンドボックスの外で、ホストネットワークアクセスを昇格させて再実行します。

ゲートウェイに到達し、HTTPエラーボディが返された場合は、プロンプトを変更する前にそのボディを確認します。

ゲートウェイまたはストリームが画像生成に対して rate_limit_exceeded を返した場合は、プロンプトを変更しません。報告された遅延またはバックオフ間隔の後、元のリクエストを再試行します。プロンプトの簡略化は、1分あたりの画像生成上限の修正にはなりません。

結果が参照画像を無視しすぎている場合：

プロンプトに明示的な保存指示を強化します
auto から edit に切り替えます
画像の一部のみを変更する場合はマスクを使用します

5. 出力を意図的に保存する

ユーザーが現在のタスク用の画像を要求した場合は、現在のワークスペースに直接、説明的な名前で保存します（例）：

hero_poster.png
livestream_vertical_v2.png
product_mockup_square.png

最終的なアセットを一時的な場所だけに残さないでください。

参考資料

リクエストが失敗したときのクイック判定フローについては references/troubleshooting.md を参照してください。

Codex Gateway Imagegen