# 비디오 추론

{% hint style="warning" %}
당사의 Hosted Video Inference 방식은 인터넷이 필요하며 저장된 비디오 파일에서 실행됩니다. 실시간 비디오 스트림에 대한 edge inference는 다음을 참조하세요. [Inference](https://inference.roboflow.com) Custom Metadata API 문서
{% endhint %}

Video Inference API는 비동기 비디오 처리에 최적화되어 있습니다. 이 API는 모든 모델을 실행하는 것을 지원합니다. [Roboflow Inference](https://roboflow.com/inference) 가 구현하는 모델(예: CLIP과 같은 foundation model, 사용자가 [Roboflow로 학습한](https://roboflow.com), 그리고 에서 다른 사용자가 공유한 수천 개의 모델 [Roboflow Universe](https://universe.roboflow.com))을 사용하여 녹화된 비디오의 전체 프레임 또는 일부 프레임에서 예측을 얻을 수 있습니다.

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

1. 비디오 업로드
2. 업로드한 비디오에 대해 하나의 모델 또는 모델 목록에 inference 요청
3. 결과를 사용할 수 있을 때까지 Poll

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

API 출력 형식에 대한 사양 보기 [여기](https://docs.roboflow.com/deploy/hosted-api/video-inference/video-inference-json-output-format).

### 모델 지원

다음 모델 유형에서 Video Inference API를 사용할 수 있습니다:

| 작업 유형                                                                                       | Hosted API에서 지원됨 |
| ------------------------------------------------------------------------------------------- | ---------------- |
| [Object Detection](https://docs.roboflow.com/deploy/video-inference/use-a-fine-tuned-model) | ✅                |
| [CLIP](https://docs.roboflow.com/deploy/video-inference/use-clip)                           | ✅                |
| [시선 감지](https://docs.roboflow.com/deploy/video-inference/use-gaze-detection)                | ✅                |
| 분류                                                                                          | ✅                |
| 인스턴스 세분화                                                                                    | ✅                |
| 시맨틱 세분화                                                                                     | ✅                |

### 예시 사용 사례

다음은 Video Inference API를 사용할 수 있는 몇 가지 예시 사용 사례입니다:

* 비디오 태깅
* 비디오 moderation(예: 미디어에서 폭력, 노골적인 장면 검색),
* 브랜드 또는 제품 찾기 및 태깅
* 비디오에서 텍스트 추출
* 장면 분할 및 분류
* 객체 수 계산
* 미디어 검색 인덱싱
* 비디오에 contextual ads를 배치할 수 있는 영역 식별
* 그리고 그 외에도.

### **중요 사항**

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