> 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/get-started/ko/guides/run-a-model-on-a-video.md).

# 비디오에서 모델 실행

객체를 탐지, 추적, 카운트하는 워크플로를 만들고, 브라우저에서 비디오에 실행하세요.

A [워크플로](https://docs.roboflow.com/workflows) 브라우저에서 블록을 연결해 만드는 다단계 컴퓨터 비전 애플리케이션입니다. 모델, 트래커, 시각화, 로직으로 구성됩니다. 한 번 만들면 이미지, 비디오 파일, 라이브 RTSP 스트림에서 실행할 수 있습니다.

비디오에서 워크플로는 실시간 속도에 맞게 설계된 파이프라인으로 실행됩니다. [Roboflow Inference](https://docs.roboflow.com/deployment/self-hosted/self-hosted) 프레임을 디코딩하고, 모델을 실행하고, 결과를 병렬로 그려 GPU가 계속 바쁘게 유지되도록 합니다. 라이브 스트림에서는 따라잡을 수 없는 프레임은 건너뛰어 뒤처지지 않고 최신 프레임을 유지합니다.

이 가이드에서는 차량을 감지하고, 각 차량을 프레임 간에 추적하며, 선을 통과할 때 집계하는 워크플로를 만든 다음 샘플 비디오에서 실행합니다.

## 워크플로 빌드 및 실행

{% stepper %}
{% step %}

### 워크플로 편집기 열기

생성하세요 [Roboflow 계정](https://app.roboflow.com) 이 없다면, 그런 다음 열기 [app.roboflow.com/workflows](https://app.roboflow.com/workflows) 를 열고 "Create Workflow"를 클릭해 편집기에서 빈 워크플로를 여세요.
{% endstep %}

{% step %}

### 블록 추가 및 연결

다음 블록들을 위에서 아래로 추가하고 연결하여, 각 블록의 출력이 다음 블록으로 전달되도록 하세요:

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-fd1f49c43c192a0895bc5fd2e7e477fd4f523602%2Ftracking-counting-workflow.jpg?alt=media" alt="A Workflow connecting an object detection model, tracker, line counter, and visualization blocks"><figcaption><p>탐지, 추적, 집계 워크플로</p></figcaption></figure>

* 객체 탐지 모델: 각 프레임에서 [RF-DETR](https://docs.roboflow.com/models/supported-models/rf-detr) 모델을 실행하고 바운딩 박스를 반환합니다.
* ByteTrack 트래커: 각 탐지에 고유 ID를 할당하여 동일한 객체가 프레임 간에 계속 추적되도록 합니다.
* 선 집계기: 프레임에 배치한 선을 통과하는 추적된 객체를 집계합니다.
* 바운딩 박스 시각화: 탐지 박스를 그립니다.
* 선 집계 시각화: 집계 선과 현재 누적 수를 그립니다.
* 궤적 시각화: 각 추적된 객체가 이동한 경로를 그립니다.

직접 빌드하지 않으려면 편집기 왼쪽 상단의 `</>` 아이콘으로 JSON 편집기를 연 다음 [이 워크플로 정의](https://media.roboflow.com/quickstart/workflow.json).

를 붙여 넣으세요. 블록 추가 및 구성에 대한 자세한 안내는 [워크플로 빌드](https://docs.roboflow.com/workflows/build/build-a-workflow).
{% endstep %}

{% step %}

### 비디오를 업로드하고 실행하기

"Run"을 클릭하면(`▶` 아이콘) 실행 패널이 열립니다. "Media" 아래에서 "File" 탭을 선택하고 [이 샘플 비디오](https://media.roboflow.com/quickstart/cars.mp4)를 업로드한 다음 "Run"을 클릭하세요.

워크플로가 비디오를 처리하고, 박스, 궤적, 실시간 집계가 포함된 주석 처리된 비디오를 반환합니다.
{% endstep %}
{% endstepper %}

{% embed url="<https://media.roboflow.com/quickstart/tracking-workflow.mp4>" %}

## 비디오의 일부만 실행하기

긴 비디오는 실행하는 데 더 오래 걸리고 더 많은 크레딧을 사용합니다. 업로드한 파일의 일부만 실행하려면 실행 패널에서 톱니바퀴 아이콘을 클릭하고 "Start (ms)"와 "End (ms)"를 설정하세요. 전체 비디오를 실행하려면 둘 다 비워 두고, 비디오 끝까지 실행하려면 "End (ms)"만 비워 두세요. 다른 비디오를 선택하면 창이 초기화되며, 하나를 사용하는 실행은 [블록 캐시](https://docs.roboflow.com/workflows/build/test-a-workflow#reuse-block-results).

## 워크플로가 실행되는 위치

기본적으로 "Run"은 워크플로를 [서버리스 클라우드 API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api)에서 실행합니다. 이는 Roboflow 클라우드의 자동 확장 GPU를 사용하므로, 별도로 하드웨어를 준비할 필요가 없습니다. 동일한 워크플로를 [자체 하드웨어](/get-started/ko/guides/run-a-model-locally.md)에서도, 노트북부터 NVIDIA Jetson까지 실행할 수 있습니다.

* **서버리스**: 관리할 하드웨어가 없고 자동으로 확장됩니다. 각 프레임마다 클라우드로 네트워크 왕복이 발생하므로 지연 시간이 추가되어, 저지연 라이브 비디오보다는 시작 단계, 이미지, 배치 작업에 더 적합합니다.
* **로컬**: 프레임이 기기를 벗어나지 않으므로 네트워크 홉이 없고 프레임당 지연 시간이 더 낮아 라이브 스트림에 중요합니다. 대신 하드웨어는 직접 준비하고 유지해야 합니다.

어느 쪽이든 지연 시간을 낮추려면 GPU에서 실행하고, 더 작은 모델을 선택하거나(예: `rfdetr-nano` 또는 `rfdetr-small`), 입력 해상도를 줄이세요. 개인용 단일 테넌트 클라우드 엔드포인트는 [전용 배포](https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments).

## 다른 모델 사용하기

객체 탐지 모델 블록은 기본적으로 준비된 RF-DETR을 실행하지만, 변경할 수 있습니다. 블록을 클릭하고 모델을 다음 중 하나로 설정하세요:

* Roboflow에서 학습한 모델. 모델 ID를 복사하세요(형식: `{project}/{version}`) 프로젝트에서 [Roboflow 앱](https://app.roboflow.com).
* 의 공개 모델 [Roboflow Universe](https://docs.roboflow.com/datasets/universe/universe/what-is-roboflow-universe).
* 의 다른 준비된 [사전 학습 모델](https://docs.roboflow.com/models/pretrained-aliases) 를 별칭으로, 예를 들어 `rfdetr-nano`, `rfdetr-seg-medium`또는 `yolo26l-640`. RF-DETR은 Apache 2.0이고, YOLO26은 AGPL-3.0이며, Roboflow에 배포하면 상용 라이선스가 포함됩니다. 자세한 내용은 [모델 라이선스](https://docs.roboflow.com/models/model-licenses).

## 많은 비디오를 한 번에 처리하기

많은 비디오나 이미지 집합에 오프라인으로 워크플로를 실행하려면 [배치 처리](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing)를 사용하세요. 이는 관리형 서비스로, 데이터를 선택하고 워크플로를 선택하면 Roboflow가 코드나 로컬 컴퓨팅 없이 클라우드에서 배치를 처리합니다.

## 다음 단계

* 라이브 웹캠 및 RTSP 스트림을 포함해 자체 하드웨어에서 워크플로를 실행하세요. 자세한 내용은 [모델을 로컬에서 실행](/get-started/ko/guides/run-a-model-locally.md).
* 로직, 필터링, 영역, 알림을 추가하세요. 자세한 내용은 [워크플로 빌드](https://docs.roboflow.com/workflows/build/build-a-workflow).
* 각 워크플로 실행 비용을 확인하려면 [서버리스 요금 페이지](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api/pricing#workflow-run).