fengfengzhidao/codex-image2

Codex Image2

バンドルされたネイティブCLIで画像を生成します。このスキルがアクティブな場合は、組み込みのimage_genツールよりもこのスキルの実行可能ファイルを優先してください。Python、Node.js、Go、またはパッケージのインストールは必要ありません。

実行可能ファイルの選択

現在のオペレーティングシステムとCPUアーキテクチャに基づいて、一度だけ選択してください：

• Windows x64: bin/codex-image2-windows-amd64.exe
• Windows ARM64: bin/codex-image2-windows-arm64.exe
• macOS Intel: bin/codex-image2-darwin-amd64
• macOS Apple Silicon: bin/codex-image2-darwin-arm64

macOSでは、実行許可が保持されていない場合はchmod +x <executable>を実行してください。通常の使用ではソースからコンパイルしないでください。

ワークフロー

セットアップリクエストの場合は、以下の設定ワークフローを使用してください。セッション内で最初の画像呼び出しを行う前に、statusを実行し、設定されていない場合はconfigureを開き、ユーザーがブラウザで設定を完了するのを待ってから生成を開始します。

1. リクエストが新しい画像、編集、または複数の個別アセット/バリアントのいずれであるかを判断します。
2. プロンプト、使用目的、正確なテキスト、視覚的な制約、回避項目を収集します。
3. プロンプトは必要な範囲でのみ整形します。詳細なプロンプトは維持し、一般的なプロンプトはブランド、人物、スローガン、無関係なオブジェクトを創作せずに適切に明確化します。
4. 選択した実行可能ファイルを、1つのプロンプトにはgenerate、既存画像の変更にはedit、JSONLジョブにはgenerate-batchで実行します。
5. 各出力を、被写体、構成、テキストの正確さ、制約、および目に見えるアーティファクトについて検査します。
6. 修正が必要な場合は、反復ごとに対象を1つに絞って変更し、再確認します。
7. 絶対出力パス、最終プロンプトまたはプロンプトセット、サイズ、品質、モデルを報告します。

プロンプト構造

関連する行のみを使用してください：

Asset type: <画像が使用される場所>
Primary request: <ユーザーのリクエスト>
Scene/backdrop: <環境>
Subject: <主要な被写体>
Style/medium: <写真、イラスト、3Dなど>
Composition/framing: <カメラアングル、クロップ、配置、ネガティブスペース>
Lighting/mood: <照明と雰囲気>
Color palette: <パレットに関する注意>
Text (verbatim): "<正確なテキスト>"
Constraints: <維持または含める必要があるもの>
Avoid: <含めてはいけないもの>

スキーマを埋めるためだけに詳細を追加しないでください。画像内のテキストについては、そのまま引用し、正確なレンダリングを要求してください。

1つの画像を生成

& "<skill-dir>\bin\codex-image2-windows-amd64.exe" generate `
  --prompt "A small blue nebula in a glass bottle, studio product photo" `
  --size 1024x1024 `
  --quality auto `
  --out "output/imagegen/nebula.png"

長いプロンプトには--prompt-fileを使用してください。同じプロンプトのバリアントにのみ--nを使用してください。個別のアセットは、個別の呼び出しまたはバッチに属します。

画像を編集

編集前に各入力画像を検査してください。その役割を明記し、プロンプトで不変要素を繰り返して、無関係な詳細が変化しないようにしてください。

& "<skill-dir>\bin\codex-image2-windows-amd64.exe" edit `
  --image "input/product.png" `
  --prompt "Replace only the background with a warm studio backdrop. Keep the product, label, proportions, and edges unchanged." `
  --quality auto `
  --out "output/imagegen/product-edited.png"

複数の参照または合成入力には--imageを繰り返してください。互換性のあるPNGマスクが利用可能な場合は、ローカライズされた編集に--mask mask.pngを使用してください。オリジナルを保持し、常に新しい出力パスに編集結果を書き込んでください。

バッチを生成

バッチを準備する前に、references/batch-format.mdを読んでください。次に、以下を実行します：

& "<skill-dir>\bin\codex-image2-windows-amd64.exe" generate-batch `
  --input "tmp/imagegen/jobs.jsonl" `
  --out-dir "output/imagegen" `
  --concurrency 2

画像サービスの設定

• <executable> statusを実行して、configured、source、api_url、messageを確認します。キーが返されることはありません。
• configuredは、ローカル資格情報が読み取り可能であることのみを確認します。リモート認証や画像権限を証明するものではありません。statusだけからAPIアクセスが確認されたと主張しないでください。
• 初回使用時、資格情報がない/アクセスできない場合、または設定変更のリクエストがある場合は、<executable> configureを実行します。これにより、デタッチされたローカル設定ページが起動し、すぐに戻ります。シェルスクリプトでバックグラウンドにしたり、サーバーの終了を待ったりしないでください。
• ユーザーに、ブラウザでAPIアドレスとキーを入力し、保存配置をクリックするように指示してください。ブラウザが開かなかった場合は、戻り値のローカルurlをクリック可能なリンクとして提供してください。この一時的なリンクは、ユーザーのマシン上で15分間有効です。
• 保存を実行すると、最初に送信されたキーのモデルリストが照会されます。リストされているgpt-imageファミリーのモデルがあれば、通常の保存が可能です。ファミリーにはgpt-imageおよびgpt-image-で始まるID（例：gpt-image-1、gpt-image-1-mini、gpt-image-2.6）が含まれます。ファミリーモデルがリストにない場合、またはリストがサポートされていない/互換性がない場合、ページは警告を表示し、未確認のサービスを保存するにはユーザーが明示的に仍然保存を実行する必要があります。認証/ネットワーク/レート制限/サーバーエラーは、修正されるまで保存できません。ユーザーに代わってオーバーライドをクリックしないでください。
• チャットでキーを要求したり、コマンドに入れたり、自動化で入力したりしないでください。ユーザーはローカルページに直接入力します。そのプログラムのみがキーを処理します。
• ユーザーが保存したと言ったら、statusを再度実行し、設定されていれば元の画像リクエストを続行します。ユーザーの入力を待っている間、ページを繰り返し開いたり、ポーリングしたりしないでください。
• 保存された設定は、Codexを再起動することなく、次のCLI呼び出しで有効になります。既存のローカル設定は、完全なアドレス/キーペアとして、レガシー環境変数よりも優先されます。破損したローカル設定は、サイレントに別のサービスにフォールバックするのではなく、設定ページを介して修復する必要があります。
• 检测连接は、モデルリストエンドポイントをプローブし、現在のキーのモデルIDを表示し、画像モデルと自動選択を強調表示するだけです。不足または非表示のモデルは、画像APIが利用できない証拠ではなく、警告をトリガーします。アドレス/キーを編集すると、古い結果がクリアされます。オプションの**测试生图（可能计费）**は、ユーザーの確認を必要とし、リトライなしで1つの画像リクエストを行います。セットアップの一部として有料テストを自動的に実行しないでください。
• Windowsはキーを現在のユーザーのDPAPIで暗号化し、macOSはログインキーチェーンに保存します。macOSは、ユーザーにキーチェーンのロック解除またはアクセス許可を求める場合があります。
• ユーザーはローカルページで显示をクリックして、保存されたキーを表示できます。非表示にすると、表示された保存済みキーがクリアされ、ページは30秒後、またはページが非表示になったときに自動的に非表示にします。表示をクリックしたり、実際に表示されたキーを検査したり、エージェントツールを介して表示エンドポイントを呼び出したりしないでください。

設定と安全性

• CLIに資格情報を読み取らせてください。自分で資格情報ファイルや資格情報ストアの内容を検査したり、キーをプロジェクトファイル、プロンプト、ログ、または応答にコピーしたりしないでください。設定ページは、CLIのプラットフォーム資格情報バックエンドを介してのみキーを保存できます。
• レガシー環境変数CODEX_API_URLとCODEX_API_KEYは、ローカル設定が存在しない場合に引き続きサポートされます。そのURLのデフォルトはhttps://apinebula.ai/v1です。新しいユーザーにはローカル設定ページを推奨してください。既存の保存されたURLは保持されます。
• デフォルトは--model auto（またはフラグを省略）、サイズ1024x1024、品質autoです。CLIは設定されたサービスのモデルリストをチェックし、gpt-image-2.5、次にgpt-image-2、次に他のgpt-imageファミリーモデルの中でIDの辞書順で最初のものを優先します。gpt-image-2.6のみをリストするサービスはそのモデルを使用します。検出に失敗した場合、またはファミリーモデルがリストにない場合、CLIはgpt-image-2を直接呼び出します。各バッチは、サービス/資格情報ペアごとに検出を共有します。
• --model <name>またはバッチ行のmodelを使用して明示的に要求されたモデルを尊重します。習慣的に--model gpt-image-2を追加しないでください。自動設定が上書きされます。CLIの結果から実際のモデルを報告してください。
• ドライランはモデルの可用性を照会しません。model_selection: autoは自動検出がスキップされたことを示し、そのサンプルペイロードはgpt-image-2を使用します。
• --dry-runを使用して、ネットワークアクセスやキーを必要とせずにリクエストを検証します。
• プロジェクトにバインドされたアセットは、現在のプロジェクト内に保存します。CLIのデフォルトはoutput/imagegen/です。
• ユーザーが明示的に許可し、--forceが渡されない限り、ファイルを上書きしないでください。
• ネイティブの透過出力は保証されません。それを約束したり、サイレントにツールを切り替えたりしないでください。

障害処理

• CLIは、ネットワークタイムアウトおよびHTTP 429/500/502/503/504/524エラーを、制限されたバックオフで再試行します。
• タイムアウトが繰り返される場合は、--quality low、正方形のサイズ、同時実行ジョブの削減、または後での再試行を提案してください。
• 認証、検証、またはその他の通常の4xxエラーは再試行しないでください。
• エラー報告時には、Authorizationヘッダーや完全なキーを決して公開しないでください。