> 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/workflows/ko/deploy/video-processing.md).

# Workflows를 이용한 비디오 처리

라이브 카메라에는 관리형 Cloud Streaming을 선택하거나, 자체 호스팅 Inference Server에서 웹캠, 카메라 피드 및 동영상 파일을 처리하세요.

관리형 라이브 카메라 처리를 위해서는 다음을 사용하세요 [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming). 카메라 소스를 Roboflow가 관리하는 컴퓨트의 Workflow 작업에 연결합니다. 다음을 따라가세요 [빠른 시작](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/quickstart) 에 연결, 미리보기, 배포, 결과 보기, 처리를 중지하는 방법이 나와 있습니다.

다음을 사용하세요 [Batch Processing](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing) 유한한 작업으로 완료되어야 하는 저장된 미디어에 사용하세요. 대신 Cloud Streaming의 커넥터 로컬 파일은 라이브 테스트 소스로 반복 재생됩니다.

## 자가 호스팅 비디오

아래의 Inference SDK WebRTC 클라이언트는 자체 Inference Server에서 Workflow를 통해 비디오를 실행합니다. 프레임을 처리하는 동안 하나의 세션을 열어 둔 채 유지하며, 트래커와 카운터 같은 상태 저장 블록을 지원하고, 각 프레임마다 별도의 HTTP 요청을 보내지 않습니다.

다음을 시작하세요 [Inference Server](https://docs.roboflow.com/deployment/self-hosted/inference-server) 클라이언트를 실행하기 전에. 처리를 하드웨어나 네트워크 내에 유지해야 한다면 자가 호스팅을 사용하세요. 다음을 참조하세요 [비디오 구성](https://docs.roboflow.com/deployment/self-hosted/inference-server/configuration/video-configuration) 에서 워커 제한 및 서버 측 미디어 참조를 확인하세요.

이전의 [Serverless Video Streaming API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api/serverless-video-streaming-api) 는 더 이상 사용되지 않습니다. 기존 레거시 참조는 여전히 사용할 수 있지만, Cloud Streaming에서 설명하는 관리형 라이브 경로는 아닙니다. 마이그레이션은 API URL만 바꾸는 것으로는 되지 않습니다.

## SDK를 설치하세요

```bash
pip install "inference-sdk[webrtc]"
```

## Workflow 스트리밍하기

이 예제는 웹캠에서 비디오를 캡처하고 다음을 출력합니다 `예측` 저장된 Workflow의 출력:

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration
from inference_sdk.webrtc import StreamConfig, WebcamSource

client = InferenceHTTPClient(
    api_url="http://localhost:9001",
    api_key="ROBOFLOW_API_KEY",
).configure(InferenceConfiguration(api_key_transport="header"))

session = client.webrtc.stream(
    source=WebcamSource(),
    workflow="workflow-id",
    workspace="workspace-name",
    config=StreamConfig(data_output=["predictions"]),
)

@session.on_data("predictions")
def handle_predictions(predictions, metadata):
    print(f"Frame {metadata.frame_id}: {predictions}")

session.run()
```

다음을 바꾸세요 `workflow-id`, `workspace-name`과 `ROBOFLOW_API_KEY` 를 사용자의 값으로 바꾸세요. 다음을 가리키세요 `api_url` 을 자가 호스팅 서버로.

다음의 이름은 `data_output` Workflow에서 정의한 출력과 일치해야 합니다. 영상 출력을 비디오로 수신하려면 이를 다음에 추가하세요 `stream_output` 그리고 `on_frame` 핸들러를 등록하세요. 전체 예시는 다음을 참조하세요 [WebRTC 스트리밍 참조](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#stream-a-workflow) 에서 확인하세요.

## 비디오 소스를 선택하세요

다음을 변경하세요 `source` 를 다음에 전달하는 `client.webrtc.stream()` 은 비디오의 출처에 따라 다릅니다:

<table data-search="false"><thead><tr><th>소스</th><th>다음 경우에 사용</th></tr></thead><tbody><tr><td><code>WebcamSource()</code></td><td>카메라가 클라이언트 머신에 연결되어 있습니다.</td></tr><tr><td><code>RTSPSource("rtsp://...")</code></td><td>Inference Server가 RTSP 카메라에 접근할 수 있습니다.</td></tr><tr><td><code>LocalStreamSource("rtsp://...")</code></td><td>클라이언트만 RTSP 또는 RTMP 스트림에 접근할 수 있습니다.</td></tr><tr><td><code>VideoFileSource("video.mp4")</code></td><td>저장된 비디오 파일을 처리하려는 경우</td></tr><tr><td><code>ManualSource()</code></td><td>애플리케이션이 개별 프레임을 제공합니다.</td></tr></tbody></table>

다음의 경우 `RTSPSource`의 경우, Inference Server는 카메라 URL에 접근할 수 있어야 합니다. 다음을 사용하세요 `LocalStreamSource` 는 클라이언트만 접근할 수 있는 경우에 사용합니다. 관리형 Cloud Streaming의 경우, RTSP 포트를 공용 인터넷에 노출하는 대신 Video Connector를 통해 카메라를 연결하세요.

다음을 참조하세요 [WebRTC 비디오 소스](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#video-sources) 에서 소스 구성 및 [결과 소비](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#consuming-results) 에서 콜백, 이터레이터, 세션 정리를 확인하세요.

## 단일 모델 스트리밍

하나의 모델만 필요하다면 Workflow를 만들 필요가 없습니다. 다음을 전달하세요 `model_id` 대신 `workflow` 와 `workspace`:

```python
session = client.webrtc.stream(
    source=WebcamSource(),
    model_id="rfdetr-nano",
)
```

다음을 참조하세요 [모델 스트리밍](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc#stream-a-model) 에서 작업 유형별 예측 처리.

## 다음 단계

* 다음에서 프레임 및 데이터 출력을 구성하세요 [WebRTC 스트리밍 참조](https://docs.roboflow.com/reference/inference/inference-sdk/webrtc).
* 다음을 시작하고 구성하세요 [자가 호스팅 Inference Server](https://docs.roboflow.com/deployment/self-hosted/inference-server).
* 다음을 사용해 관리형 라이브 카메라를 연결하세요 [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming).
