vmake-image-repair

画像品質の修復

機能と準備

image-repair を使って、ぼやけた画像や低解像度の画像を高画質化します。視覚的な鮮明さとディテールを改善し、修復した画像を返します。入力画像と高画質化の目標が明確であれば、処理を進めます。

現在の CLI でサポートされているパラメーターを使用してください。詳細はヘルプまたはコントラクトを確認してください。vmake-labs-cli が必要です。対象バージョンは 0.1.11 で、>=0.1.11 <0.2.0 と互換性があります。

最初に実行する前に、CLI setup を読み、実行ファイルを解決して、バージョンと tool image-repair --help を確認してください。JSON フィールドやメディアの制限が不明な場合は、該当する vmake contracts の項目を照会してください。出力の解析、サービスに関する質問、実行の中断については、runtime and recovery を読んでください。

入力の収集

1. リクエストまたは添付ファイルから、実際の画像ファイルまたは URL を 1 つ取得します。入力が明確な場合は、再度確認しないでください。候補が複数あり、どれか不明な場合はユーザーに選択してもらいます。複数の入力を処理するのは、許可されている場合に限り、それぞれの記録を保持してください。
2. ローカル入力には、実在して読み取り可能なパスを使用します。CLI setup に従ってリモートの元画像をダウンロードし、そのローカルファイルを送信してください。メディア ID しかない場合は、まずそのセッションを照会して実際の URL を取得してください。ダウンロードに失敗した場合は、元のローカルファイルを依頼してください。
3. タスクを続行するには -r '<session_id>' を追加し、新規タスクでは省略します。デフォルト、認証、不足情報については CLI setup に従ってください。オプションのパラメーターは現在のヘルプを確認し、指定されていない値は省略してください。
4. 復旧に備えて、元のソース、ローカルパス、セッションを保持してください。ユーザーからダウンロード済みのファイルが提供された場合は、確立済みの目標に沿って処理を続けてください。失敗した出力をソースとして扱わないでください。

アップロードと送信

解決済みの実行ファイルを使用し、準備したローカルファイルを個別の引数として渡します。

vmake tool image-repair --image-file '<local-image-path>'

CLI はファイルを検証し、組み込みのアップロードパイプラインを通じてアップロードして CDN URL を取得した後、タスクを送信して状態を確認します。最初に create-room や add-media を呼び出したり、プレースホルダーのメディア参照を作成したりしないでください。パラメーターファイルと個別の事前確認は任意です。引数の処理とクリーンアップについては CLI setup に従ってください。

状態の確認と納品

• 元の入力、実際の session_id / room_url、すべての Task ID を保持してください。別の監視プロセスを同時に開始せず、元のコマンドの stdout と stderr を個別に読み取ってください。
• TASK_STATE_COMPLETED になり、このタスクから実際に利用可能な出力 URL を取得した後にのみ納品してください。HTTP 200、ストリームの終了、終了コード 0、または end.reason=result だけでは、完了の証明になりません。不明な状態を成功として扱わないでください。
• 利用可能な場合はネイティブのプレビューまたは添付ファイルを使い、それ以外の場合はクエリパラメーターを含む完全なクリック可能 URL を使ってください。利用可能な Part をすべて納品し、成功した部分結果も含めてください。実際に返されたセッション URL を含め、ID から URL を作成しないでください。
• 切断、タイムアウト、受け付けられたか不明な場合は、まず元のセッションとタスクを照会してください。確認済みの失敗を修正し、許可を得た後にのみ処理を再試行してください。出力のダウンロードに失敗した場合は、成功済みの処理を繰り返さずにダウンロードを復旧してください。詳細は runtime and recovery を参照してください。