image-batch-runner

画像バッチランナー

使用する場合

• ペルソナ、コンセプト、またはショットの入力がすでに存在し、次のステップがホスト型の 画像生成または参照ベースの編集実行である場合。
• 出力にローカルの画像ファイルと、後続の QA や動画レンダリングのために永続的なリクエスト、レスポンス、 マニフェストの記録を含める必要がある場合。

使用しない場合

• タスクがアイデア出し、QA、またはハンドオフセクションに記載された別の公開済みスキルに属する場合。
• 必須の入力が欠けており、推測すると結果が変わってしまう場合。
• クリエイティブな分類、モデル/参照ポリシー、またはストーリーボードのロジックがまだ 未解決である場合。まず image-generation を使用してください。

実行境界

• ホスト型の画像生成と編集は、公開されている postplus media create verb を通じて実行され、非同期です。submit は実行ハンドル、現在のステータス、および 完了したアーティファクトのメタデータを記録します（バイトは 自動ダウンロードされません。以下のダウンロードコマンドを参照してください）。
• このランナーは解決済みのリクエストを検証して実行します。クリエイティブな 戦略、タスク分類、または参照ポリシーの決定を行ってはなりません。
• より高品質なデフォルトと、より高速または安価なモデルファミリーが利用可能です。 ユーザーまたは上流のブリーフが特定のファミリー、 比率、品質、または解像度を要求しない限り、デフォルトを優先してください。以下に示す生成例は、デフォルトの エンドポイントキーを示しています。
• --reference-image を受け付けるのは編集エンドポイントのみです（デフォルトの編集エンドポイント: image-gpt-image-2-edit）。image-gpt-image-2-text などのテキストエンドポイントは このフラグを Unknown option で拒否するため、参照に紐づく生成は必ず テキストエンドポイントではなく編集エンドポイントを対象にする必要があります。
• 参照ベースの編集では、繰り返し指定する --reference-image フラグを介して各ソース画像を渡します。各値は、ローカルパス、HTTPS URL、既存の PostPlus メディア参照、またはデータ URI のいずれかです。CLI は、単一のホスト型 submit の前にローカル メディアを検証して準備します。事前にアップロードしたり、手動でリクエストオブジェクトを構築したりしないでください。
• 完成した画像出力をディスクに保存するには、 postplus media-file download --reference <output.data.artifacts[0].mediaReference> --output-file <path> を使用します。 完了した結果のアーティファクト参照をダウンロード元として使用してください。
• 識別子と実行ローカルの状態（assetId、runId、localAssetDir、マニフェスト パス）はランナーによって生成または導出されます — これらを指定しないでください。次のハンドオフのために 結果から読み戻してください。

ソースとパス

• すべてのリクエストを、ベンチマークに裏付けられたペルソナロック、コンセプトまたはショットのニーズ、 視覚的制約、assetPurpose、および sourceBasis に基づいてください。
• アクティブなプロジェクト/クライアントフォルダーのソースファイルを最初に使用してください。1 つの クライアントディレクトリをすべての画像作業のデフォルトとして扱わないでください。
• 内部のリクエスト、レスポンス、およびマニフェストは .postplus の下に置き、最終的な ユーザー向けの画像とマニフェストはアクティブなアセットフォルダーに置いてください。アセットフォルダーが 存在しない場合は、1 つの明示的なワークスペースパスを選択してください。

レビューとハンドオフ

• 提出前に、ペルソナの根拠、アセットの目的、ソースの基準、および 固定すべきものと変化させるべきものを確認してください。
• 生成後、リアリズム、ベンチマークへの適合、動画間での再現性、 クリエイターのコピーリスク、および広告的なドリフトを確認してください。
• 処理がまだ保留中の場合、マニフェスト/リクエストのパスとポーリング コマンド postplus media poll --handle <output.data.id> --output path/to/generation-result.json を返してください。 最初の submit で使用した正確な --output パスを再利用してください。完了したポーリングは そのパスにある処理中の JSON を完了した結果でアトミックに置き換えます。 同じ操作には CLI が返すアクションまたは再開コマンドを優先し、 その待機/復旧の境界を守り、決して代替ジョブを submit しないでください。

停止条件

• 必要なユーザーの意図、根拠資料、または所有する入力アーティファクトが不足しており、推測によって結果が変わる場合は停止します。

• バッチのカナリア：独立した項目のバッチを並列処理する前に、項目 1 だけを送信し、終端状態になるまでポーリングします。カナリアがコンテンツポリシーによってブロックされた場合（下記の項目単位の型付きコード）、バッチ分離のルールに従って記録してスキップし、次の項目をカナリアとして実行します。ブロックされていないカナリアが正常に完了した後にのみ、並列処理を開始します。それ以外のカナリアの失敗はすべてシステム障害です。停止してください。非同期の終端状態など、一部の失敗はポーリング時に初めて確認できます。そのため、送信が受理されたバッチでも、100％失敗する可能性があります。カナリアにより、参照形式の不備、サービス停止、認証などのシステム障害の影響範囲をバッチ全体ではなく 1 項目に抑えられます。

• バッチ分離：独立した項目のバッチを作成するとき、項目単位のコンテンツ／安全性による拒否は、その項目だけに分離されます。該当する拒否は、型付きコード postplus_cli_hosted_media_content_policy_blocked によってのみ識別され、エラーの説明文との照合では識別しません。この拒否は、型付きエラーの code がそのコードである postplus media create の失敗、またはポーリング結果の output.data.status: failed と output.data.error.code がそのコードに設定された送信済み実行のいずれかで発生します。どちらの場合も、ブロックされた項目とその正確な理由を記録してスキップし、残りの項目の送信とポーリングを続行した後、最後に未完了の項目を報告します。ブロックされた項目を再試行、緩和、または再送信してはいけません。これは禁止されたペイロードの書き換えにあたります。それ以外のすべての失敗（型付き code がこのコンテンツポリシーコードではない、所有する CLI／スクリプトコマンドの失敗、または error.code がこのコンテンツポリシーコードではない実行の失敗、つまり認証、通信、クォータ、不正なリクエスト、サービス停止）はシステム障害です。上記のルールに従って停止してください。

公開コマンドの境界

• ユーザーの入力に一致する最小のコマンドまたはワークフローを選び、直接実行します。

• 準備状況の診断：postplus doctor --skill image-batch-runner。

• 保留中の画像ジョブをポーリングする：postplus media poll --handle <output.data.id> --output path/to/generation-result.json。 初回送信時の結果パスを再利用し、完了したポーリング結果で処理中の JSON をアトミックに置き換えます。返された再開アクションを優先し、CLI の待機／復旧境界に達したら停止します。

• エンドポイント、フラグ、列挙値の完全な契約を確認する必要がある場合、または不明なリクエスト形式を修正する場合に限り、postplus media schema --json を使用します。

• 以下で生成されたコマンドを使ってホスト型の画像ジョブを実行します。他の実行インターフェースは使用しません。

postplus media create image-gpt-image-2-text \
  --prompt "Describe the result you need" \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。自由形式のメッセージから復旧方法を推測してはいけません。 求められた場合は、ユーザーの明示的な承認を待ってください。アクションによって、支出、公開、上書きが許可されるわけではありません。 返されたチェックポイントまたはアクションを使って同じ操作を再開してください。不確実な作業を再送信したり、使い切った復旧手段を繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしてはいけません。

• リクエストされたタスクでは、現在の価格と残高を確認したうえで、既存の PostPlus クレジットを使用します。 見積もりのみのリクエストは実行しません。クレジットが不足している場合は停止します。チャージ、サブスクリプションの購入、不確実な有料操作の繰り返しは行いません。