> 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/legacy/legacy-serverless/video-inference.md).

# 비디오 추론

비디오 프레임 전반에서 컴퓨터 비전 모델을 실행합니다.

{% hint style="warning" %}
호스팅 비디오 추론 방식은 인터넷 연결이 필요하며 저장된 비디오 파일에서 실행됩니다. 실시간 비디오 스트림에 대한 엣지 추론은 다음을 참조하세요. [추론](/deployment/ko/self-hosted/self-hosted.md) 문서.
{% endhint %}

비디오 추론 API는 비동기 비디오 처리에 최적화되어 있습니다. 이 API는 다음을 구현하는 모든 모델의 실행을 지원합니다. [Roboflow Inference](https://roboflow.com/inference) (CLIP과 같은 파운데이션 모델, 사용자가 커스텀으로 파인튜닝한 모델을 포함하여 [Roboflow로 학습한](https://roboflow.com)및 다른 사람들이 [Roboflow Universe](https://universe.roboflow.com))에서 공유한 수천 개의 모델)을 사용하여 녹화된 비디오의 전체 프레임 또는 일부 프레임에 대한 예측을 얻을 수 있습니다.

API를 사용하고 예측을 가져오려면 다음 단계를 따라야 합니다:

1. 비디오 업로드
2. 업로드한 비디오에서 모델 또는 모델 목록에 대해 추론 요청
3. 결과를 사용할 수 있을 때까지 폴링

GPU를 효율적으로 배치하고 활용하기 위한 최적화와 더 높은 지연 시간 허용 덕분에, 비디오 추론 API는 저장된 비디오 처리(실시간 스트리밍 대비)에서 이미지 기반 [호스팅 API(레거시)](/deployment/ko/legacy/legacy-serverless.md).

API 출력 형식의 사양 보기 [여기](/deployment/ko/legacy/legacy-serverless/video-inference/video-inference-json-output-format.md).

### 모델 지원

다음 모델 유형에서 비디오 추론 API를 사용할 수 있습니다:

| 작업 유형                                                                                      | Hosted API(레거시)에서 지원됨 |
| ------------------------------------------------------------------------------------------ | --------------------- |
| [객체 탐지](/deployment/ko/legacy/legacy-serverless/video-inference/use-a-fine-tuned-model.md) | ✅                     |
| [CLIP](/deployment/ko/legacy/legacy-serverless/video-inference/use-clip.md)                | ✅                     |
| [시선 감지](/deployment/ko/legacy/legacy-serverless/video-inference/use-gaze-detection.md)     | ✅                     |
| 분류                                                                                         | ✅                     |
| 인스턴스 분할                                                                                    | ✅                     |
| 시맨틱 분할                                                                                     | ✅                     |

### 예시 사용 사례

비디오 추론 API를 사용할 수 있는 몇 가지 예시 사용 사례는 다음과 같습니다:

* 비디오 태깅
* 비디오 모더레이션(예: 미디어에서 폭력성, 노골적인 장면 검색),
* 브랜드 또는 제품 찾기 및 태깅
* 비디오에서 텍스트 추출
* 장면 분할 및 분류
* 객체 수 세기
* 미디어 검색 인덱싱
* 비디오에 맥락 광고를 배치할 수 있는 영역 식별
* 그리고 더 많은 것들.

### **중요 사항**

1. 비디오 추론은 현재 다음 비디오 파일 확장자를 지원합니다: *mp4, MP4, avi, AVI, mkv, MKV, webm, WEBM.*
2. Roboflow에 업로드된 비디오는 일주일 동안 캐시되어 사용자가 전체 비디오를 반복해서 다시 업로드하지 않고도 동일한 업로드 비디오에 대해 비디오 추론을 다시 실행할 수 있습니다. 이 1주일이 지나면 비디오는 영구적으로 삭제됩니다.
3. Roboflow에 업로드된 비디오는 절대로 다운로드할 수 없습니다. 업로드 기능은 오직 백엔드가 추론 목적으로 비디오를 처리할 수 있도록 하기 위한 것입니다.