vmake-image-remove-watermark

画像のテキスト透かしを削除する

機能と準備

image-remove-text を使用してテキストやテキストの透かしを識別・削除し、覆われていた背景を修復します。入力画像とテキスト削除の目的が明確であれば、そのまま進めてください。認識と処理はサービス側で行われます。

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

初回の呼び出しの前に、CLI のセットアップを読み、実行ファイルを特定して、そのバージョンと tool image-remove-text --help を確認してください。JSON フィールドやメディアの制限が不明な場合は、該当する vmake contracts エントリーを確認してください。出力の解析、サービスに関する質問、中断された実行については、ランタイムとリカバリーを読んでください。

入力の収集

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

アップロードと送信

解決済みの実行ファイルを使用し、準備したローカルファイルを個別の引数として指定してください。

vmake tool image-remove-text --image-file '<local-image-path>'

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

状態の確認と結果の提供

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