Workflows を実行

コマンドラインから Roboflow Workflow を使って、単一画像、画像ディレクトリ、動画ファイルを処理します。

この inference workflows コマンドは、画像と動画を処理する方法を提供します ワークフロー。処理できるものは次のとおりです:

• 個別の画像

• 画像のディレクトリ

• 動画ファイル

コマンドの詳細を確認するには、次を実行します:

inference workflows --help

各サブコマンドについてもヘルプガイドがあります:

inference workflows process-image --help

個別の画像を処理する

コマンドの基本的な使い方:

inference workflows process-image \
    --image_path {your-input-image} \
    --output_dir {your-output-dir} \
    --workspace_name {your-roboflow-workspace-url} \
    --workflow_id {your-workflow-id} \
    --api-key {your_roboflow_api_key}

これにより、入力画像がワークフローで実行され、結果が出力ディレクトリに保存されます。既定では、ワークフローは Roboflow のホスト型 API を使用して処理されます。コマンドの動作は調整できます:

• 画像をローカルで処理したい場合は、 推論 Python パッケージを使用し、 --processing_target inference_package オプション（ 推論 インストールが必要です）

• すべてのオプションを表示するには、 inference workflows process-image --help

• で始まる任意のオプションは、 -- 一覧に記載されていない --help の出力は、自動型変換が適用された状態で、ワークフロー実行への入力パラメーターとして扱われます。さらに、 --workflow_params オプションで、 *.json ファイルへのパスを指定できます。このファイルにはワークフローパラメーターが含まれます（明示的なパラメーターは、ファイルで定義されたパラメーターを上書きします）。

• ワークフローで画像パラメーターのプレースホルダーが 画像とは異なる名前で定義されている場合は、適切な画像入力を --image_input_name

• その --allow_override フラグは、出力ディレクトリが空でない場合に使用する必要があります

画像のディレクトリを処理する

コマンドの基本的な使い方:

inference workflows process-images-directory \
    -i {your_input_directory} \
    -o {your_output_directory} \
    --workspace_name {your-roboflow-workspace-url} \
    --workflow_id {your-workflow-id} \
    --api-key {your_roboflow_api_key}

コマンドの動作は調整できます:

• 画像をローカルで処理したい場合は、 推論 Python パッケージを使用し、 --processing_target inference_package オプション（ 推論 インストールが必要です）

• すべてのオプションを表示するには、 inference workflows process-images-directory --help

• で始まる任意のオプションは、 -- 一覧に記載されていない --help の出力は、自動型変換が適用された状態で、ワークフロー実行への入力パラメーターとして扱われます。さらに、 --workflow_params オプションで、 *.json ファイルへのパスを指定できます。このファイルにはワークフローパラメーターが含まれます（明示的なパラメーターは、ファイルで定義されたパラメーターを上書きします）。

• ワークフローで画像パラメーターのプレースホルダーが 画像とは異なる名前で定義されている場合は、適切な画像入力を --image_input_name

• その --allow_override フラグは、出力ディレクトリが空でない場合に使用する必要があります

• その --threads オプションでは、処理対象が API の場合にリクエストを実行するために使用するスレッド数を指定できます

動画ファイルを処理する

このコマンドには 推論 パッケージがインストールされている必要があります。

コマンドの基本的な使い方:

inference workflows process-video \
    --video_path {video_to_be_processed} \
    --output_dir {empty_directory} \
    --workspace_name {your-roboflow-workspace-url} \
    --workflow_id {your-workflow-id} \
    --api-key {your_roboflow_api_key}

コマンドの動作は調整できます:

• その --max_fps オプションは、処理中に動画フレームを間引くために使用できます

• すべてのオプションを表示するには、 inference workflows process-video --help

• で始まる任意のオプションは、 -- 一覧に記載されていない --help の出力は、自動型変換が適用された状態で、ワークフロー実行への入力パラメーターとして扱われます。さらに、 --workflow_params オプションで、 *.json ファイルへのパスを指定できます。このファイルにはワークフローパラメーターが含まれます（明示的なパラメーターは、ファイルで定義されたパラメーターを上書きします）。

• ワークフローで画像パラメーターのプレースホルダーが 画像とは異なる名前で定義されている場合は、適切な画像入力を --image_input_name

• その --allow_override フラグは、出力ディレクトリが空でない場合に使用する必要があります