od-next-media-inputs

OD Next メディア入力

現在のタスクでメディア入力が必要な場合にのみ使用してください。適用される間はこの手順を再利用し、アセット作業のないタスクでは読み込まないでください。現在のルート、ステージ、確定済みプラン、納品範囲に従ってください。contract_repair 中はツールを呼び出さないでください。必要な入力作業は、それに依存する納品物を書き込む前に完了してください。書き込み後の成果物の検査、レンダリング、検証、修正を、出荷時の書き込みを回避するために入力準備と呼んではいけません。

必須スロットを維持する

既存の作業コンテキストにある確定済みアセット要件を使用してください。用途、対象、ソース／ライセンスの制約、形状、再利用位置、準備状況が含まれます。適切なユーザーアセットと、ページをまたいで同じアセットを再利用してください。作業は重複をなくし、異なる対象や必須の状態は維持してください。新しいプラン、マニフェスト、承認ステップ、レビューエージェントを追加しないでください。意味の適合性、真正性、ライセンス、ローカルまたはインラインの参照、画像の形状など、すべての必須アセットと品質条件を維持してください。

各画像スロットのルートを決める

各スロットのルートと、ストック検索で使用できるライブラリを、Core imagery-by-type rule に従って決定してください。これが該当ルールの唯一の情報源です。

ストック写真を検索する

• 会社のサービスと既存の Vela ログインを使い、認証済みデーモンラッパー経由で、すべてのストックスロットを1回の呼び出しで取得してください。 "$OD_NODE_BIN" "$OD_BIN" media stock-search --slots '[{"id":"hero","query":"black eyeglasses frame","width":1200,"orientation":"landscape"}]' クエリは対象を先頭にして英語で記述してください。このサービスは設定済みのチャンネル優先順位に従い、試行上限内で各チャンネルを最大1回試し、各結果を返します。ラッパーは画像を assets/stock/ にダウンロードし、クレジットを assets/stock/credits.json に記録します。プロバイダーキーはサーバー上に保持してください。ストックプロバイダーキーをユーザーに設定させてはいけません。
• コマンドが失敗またはタイムアウトした場合、あるいはスロットが error、not_found、budget_exceeded を返した場合は、成功したローカルファイルを保持し、不足しているスロットのみ、利用可能なウェブ／画像検索ツールを使ってください。サービス／ログインが利用できない場合、API エラー、レート制限、画像ダウンロードの失敗も該当します。失敗したスロットについてストックツールを再度呼び出してはいけません。
• ストックライブラリの公開ページ、または名称が特定された実在の対象については適切な公式ソースを検索してください。実際の画像 URL を選ぶ前に、各結果のタイトル／代替テキスト、ソース、ライセンスを確認してください。URL や ID を捏造してはいけません。
• 独立したダウンロードはまとめて実行し、各リクエストの上限を10～15秒としてください。既存の取得予算が尽きたら停止してください。HTTP 403／429 が発生した場合は、繰り返さず別のソースに切り替えてください。不足しているスロットごとに、代替ウェブ検索は最大1回までです。取得に成功した画像は保持し、使用可能な画像が見つからない場合は、デザイン済みのプレースホルダーであることを明示してください。
• 表示サイズでダウンロードしてください（長辺は1600 px 以下）。各 JPEG または WebP は約400 KB 未満にしてください。
• ソースから返された各写真のページ URL、作者（表示されている場合）、ライセンスを、アセットの隣にあるサイドカーに保持してください。表示する成果物にこれらのメタデータを含めるかどうかは、Core Image attribution rule に従って判断してください。
• 制限時間に達した場合は、取得に成功したファイルを保持してください。残りのスロットには、プレースホルダーであることを明示して使用してください。

機能を再利用し、原因に応じて復旧する

この実行で実際に提供されたツール、モデル ID、パラメーター、権限のみを使用してください。有効で完全な機能の結果は再利用してください。不足、欠落、または無効になった事実のみを照会し、環境、認可、またはエラーによって判断が変わる場合は、関連する事実を更新してください。カタログに項目があるだけでは、認可や準備が整っていることの証明にはなりません。ツール名やモデル名を推測したり、認証情報の値を公開したりしないでください。

再試行する前に、失敗の原因を分類してください。

• 認可：認証情報の不足や無効状態が安定している場合、対象を変更したり別のモデルを推測したりしても解決しません。検証済みで許可された代替手段、または既存の契約で定められたフォールバックのみを使用してください。アクセス制御を回避してはなりません。
• パラメーター：実際の機能情報やエラー情報に基づいて、サポートされていない入力を修正してください。推測した別名を検索してはなりません。
• 一時的な失敗：既存の再試行ガイダンスと回数制限に従ってください。ジョブが受け付けられた場合は、別のジョブを作成する前にその結果を取得してください。再試行可能な一時的エラーの場合は、ガイダンスの範囲内でパラメーターを変更せずに再試行してもかまいません。
• アセットの不一致：該当スロットの対象または構図を修正してください。要求された対象の名前を変更したり、スロットを削除したり、失敗を隠すために内容を歪めたりしてはなりません。

変更が原因に対処する場合、関連する状態が変わる場合、または既存のガイダンスで一時的な失敗の再試行が許可されている場合にのみ、再試行してください。 呼び出し回数を減らすために必要な品質を犠牲にしてはなりません。時間予算の範囲内でストックフォト検索を行ってください。

独立した入力作業をバッチ処理する

ツールが対応しており、入力が独立している場合は、検索、取得、ダウンロード、フォーマット処理、固有の幅と高さの測定をバッチ処理してください。各項目の結果と失敗を保持し、依存するリクエストは順序どおりに処理してください。変更されていないファイルの有効な測定値は再利用してください。変換後は、影響を受けるファイルを再測定してからコンテナーのサイズを決定してください。

HTTP の成功やファイル／サイズの確認だけでは、意味的な適合性は証明されません。画像を会話に読み戻さず、「コア画像ルール」の説明に従って判断してください。

結果を収集し、完了したら停止する

実際の各ジョブ ID、ステータス、返されたカーソル、元のレスポンス、出力先を保持してください。サポートされている待機操作またはバッチ操作のみを使用してください。送信の成功や終了時の成功だけでは、アセットの準備が整ったことの証明にはなりません。完全な出力／エラー情報を伴う明示的な終端結果が得られたら、そのジョブのポーリングを停止してください。失敗または中断で終端した結果は、使用可能なアセットではありません。実行中のジョブ、不完全な結果、新たなエラーについては、必要な取得を続けてください。書式を変更するためだけにレスポンスを再取得せず、保存済みのレスポンスを再解析してください。

必要なすべてのスロットが、内容と入力の条件を満たしたら、アセットの取得を停止してください。必要なアセットが利用できない場合は、既存のフォールバック／失敗時の契約に従い、不確実性をそのまま保持してください。呼び出し回数が少なかったという理由だけで、完了したと宣言してはなりません。