> 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/ko/inference/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`와 다른 이름 아래 이미지 매개변수 자리표시자를 정의한 경우 `--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`와 다른 이름 아래 이미지 매개변수 자리표시자를 정의한 경우 `--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`와 다른 이름 아래 이미지 매개변수 자리표시자를 정의한 경우 `--image_input_name`
* 해당 `--allow_override` 플래그는 출력 디렉터리가 비어 있지 않은 경우 사용해야 합니다