> 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/deployment/ko/roboflow-cloud/cloud-streaming.md).

# 클라우드 스트리밍

라이브 카메라를 연결하고, 관리형 클라우드 GPU에서 워크플로를 실행하며, Cloud Streaming으로 비디오와 예측 결과를 소비하세요.

Cloud Streaming은 Roboflow에서 관리하는 컴퓨팅 리소스를 사용해 라이브 카메라에서 Workflow를 실행합니다. Inference Server를 호스팅하지 않고도 RTSP, RTMP, IP 및 USB 카메라를 지속적으로 처리할 수 있습니다. 소스를 연결하고 Workflow를 테스트한 다음 배포하세요.

먼저 [Cloud Streaming 빠른 시작](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/quickstart.md).

## 소개

Cloud Streaming은 세 부분으로 구성됩니다.

* 소스는 비디오를 제공합니다. Roboflow Video Connector를 통해 연결된 카메라, URL을 통해 Roboflow가 연결하는 카메라, 직접 연결된 RTMP 게시자, 또는 브라우저 웹캠이나 휴대폰을 이용한 임시 세션이 소스가 될 수 있습니다.
* 커넥터는 카메라 근처의 컴퓨터에서 실행됩니다. 로컬 소스를 검색하고 요청이 있을 때 Roboflow로 비디오를 전송합니다. Workflow의 모델 추론은 실행하지 않습니다.
* 작업은 하나의 소스에서 하나의 Workflow를 실행합니다. 미리보기는 실행 범위가 제한된 테스트입니다. 배포는 소스 가용성, 제한 및 복구 정책에 따라 브라우저와 독립적으로 처리를 계속합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-e776128b2d385363e34542f7883b589748cf7203%2Fcloud-streaming-architecture.svg?alt=media" alt="Cameras on your network send video through the Video Connector, and RTMP publishers or a webcam send it directly, to a job that runs your Workflow on a managed GPU in Roboflow Cloud. The job returns annotated video, the latest JSON result, Workflow sink events, and saved captures."><figcaption><p>소스에서 작업을 거쳐 결과로 이어지는 비디오 흐름입니다.</p></figcaption></figure>

하나의 소스에서 여러 작업을 동시에 실행할 수 있습니다(예: 배포된 Workflow와 초안 미리보기를 함께 실행하거나, 두 Workflow 버전을 병렬로 비교). 소스가 온라인이라고 해서 Workflow가 해당 소스를 처리 중이라는 뜻은 아닙니다. 비디오 플레이어를 닫아도 배포는 중지되지 않습니다.

<table data-search="false"><thead><tr><th>작업</th><th>용도</th></tr></thead><tbody><tr><td>관리형 클라우드 컴퓨팅 리소스에서 라이브 카메라 실행</td><td>Cloud Streaming</td></tr><tr><td>웹캠 또는 휴대폰 카메라 테스트</td><td>임시 Cloud Streaming 미리보기</td></tr><tr><td>저장된 비디오 또는 이미지를 끝까지 처리</td><td><a href="https://docs.roboflow.com/deployment/ko/roboflow-cloud/batch-processing.md">일괄 처리</a></td></tr><tr><td>개별 이미지 또는 요청을 Workflow로 전송</td><td><a href="https://docs.roboflow.com/deployment/ko/roboflow-cloud/serverless-api.md">서버리스 클라우드 API</a></td></tr><tr><td>자체 하드웨어 또는 로컬 네트워크에서 처리 유지</td><td><a href="https://docs.roboflow.com/deployment/ko/self-hosted/inference-server.md">자체 호스팅 Inference Server</a></td></tr></tbody></table>

Cloud Streaming 요금은 프레임당이 아니라 GPU 시간당 부과되며, 시간당 0.1 크레딧부터 시작합니다. 자세한 내용은 [요금 및 제한](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/pricing-and-limits.md).

## 웹 앱

워크스페이스에서 "배포"를 연 다음 "Cloud Streaming"을 선택하세요.

다음 가이드를 순서대로 따르세요.

1. [커넥터 설치](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/install-a-connector.md) 카메라가 연결된 컴퓨터 또는 네트워크에 설치합니다.
2. [소스 연결](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/connect-a-source.md)(RTSP, RTMP, USB, ONVIF 및 임시 카메라 포함)
3. [Workflow 실행](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md) 미리보기, 배포 및 버전 동작을 알아보세요.
4. [결과 사용](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/consume-results.md) 비디오, JSON, Workflow 싱크 이벤트 또는 저장된 캡처로 확인할 수 있습니다.
5. [관리 및 모니터링](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/manage-and-monitor.md) 실행 중인 배포를 관리하고 모니터링하세요.

자주 하는 작업:

* 카메라 추가: "비디오 소스 추가"를 클릭하고 다음 안내를 따르세요. [소스 연결](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/connect-a-source.md).
* 커넥터 없이 인터넷에서 연결 가능한 카메라 추가: "카메라 URL" 탭을 사용하세요. 자세한 내용은 [URL로 카메라 추가](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/add-cameras-by-url.md).
* Verkada 카메라 추가: "Verkada" 탭을 사용하세요. 자세한 내용은 [Verkada 카메라](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/verkada.md).
* RTSP 또는 ONVIF 카메라 추가: 커넥터를 열고 "RTSP 카메라"를 사용하세요. 자세한 내용은 [RTSP 및 ONVIF 카메라](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/connect-a-source.md#rtsp-and-onvif-cameras).
* Workflow 실행: 소스와 Workflow를 선택한 다음 "처리 시작"을 클릭하세요. 자세한 내용은 [게시된 Workflow 배포](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#deploy-a-published-workflow).
* 미리보기 계속 실행: 앱에서 제안하면 재시작 없이 배포하세요. 자세한 내용은 [실행 중인 미리보기 승격](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#promote-a-running-preview).

미리 보기를 포함한 처리 작업에는 크레딧이 사용됩니다. 시작하기 전에 예상 사용량을 확인하세요.

## Roboflow Agent

카메라 연결과 Workflow 미리 보기를  [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) 에 요청하세요. Agent는 명시적으로 요청하면 소스 선택, 결과 확인, 배포를 도와줍니다. 웹캠 또는 휴대전화 QR 세션은 임시 세션이므로 지속적인 배포로 전환할 수 없습니다.

카메라를 연결하고 Workflow를 미리 본 후 배포하려면  [Agent 빠른 시작](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/quickstart.md#roboflow-agent) 을 참조하세요.

## HTTP API

워크스페이스 API 키와 함께 HTTP API를 사용하여 소스 목록 조회, Workflow의 입력 및 출력 확인, 소스 비디오 미리 보기, 임시 세션 실행, 작업 시작·조회·취소 및 출력 모니터링을 할 수 있습니다. 먼저 다음을 따르세요:  [HTTP API 빠른 시작](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/quickstart.md#http-api). 그다음 참조할 문서:  [소스 설정](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/connect-a-source.md#http-api)  및  [작업 제어](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/run-a-workflow.md#http-api).

커넥터 설정, RTSP 및 ONVIF 카메라, RTMP 소스와 키 교체, 재시작, 미리 보기의 배포 전환에는 웹 앱을 사용하세요. API에는 이러한 기능을 위한 엔드포인트가 없습니다.

앱은 Workflow를 기준으로 GPU 리소스 크기를 결정합니다. API로 시작하는 작업에는 전송한 GPU 크기가 사용되며, 크기를 전송하지 않으면 Small(`gpu-s-v1`)이 사용됩니다. 대신 Roboflow가 Workflow를 기준으로 크기를 결정하도록 하려면  `autoSize: true` 를 전송하세요. 다음을 참조하세요:  [요금 및 제한](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming/pricing-and-limits.md#http-api).
