> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ja/tui-lun/inference-cli/workflows.md).

# Workflows を実行する

この `inference workflows` コマンドは、画像と動画を処理する方法を提供します [ワークフロー](https://docs.roboflow.com/workflows)。処理できるものは次のとおりです:

* 個別の画像
* 画像のディレクトリ
* 動画ファイル

{% hint style="success" %}
コマンドの詳細を確認するには、次を実行します:

```bash
inference workflows --help
```

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

```bash
inference workflows process-image --help
```

{% endhint %}

## 個別の画像を処理する

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

```bash
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` フラグは、出力ディレクトリが空でない場合に使用する必要があります

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

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

```bash
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 の場合にリクエストを実行するために使用するスレッド数を指定できます

## 動画ファイルを処理する

{% hint style="info" %}
このコマンドには `推論` パッケージがインストールされている必要があります。
{% endhint %}

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

```bash
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` フラグは、出力ディレクトリが空でない場合に使用する必要があります