> 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/roboflow/roboflow-ko/deploy/serverless/video-inference.md).

# 비디오 추론

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

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

API를 사용하고 예측 결과를 가져오기 위해 따라야 할 단계는 다음과 같습니다:

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

GPU를 효율적으로 배치하고 활용하도록 최적화되어 있고 지연 허용치가 더 높기 때문에, Video Inference API는 저장된 비디오 처리(실시간 스트리밍 대비)에 대해 이미지 기반 [Roboflow Serverless Hosted API](/roboflow/roboflow-ko/deploy/serverless.md).

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

### 모델 지원

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

| 작업 유형                                                                            | Hosted API에서 지원 |
| -------------------------------------------------------------------------------- | --------------- |
| [객체 탐지](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를 사용할 수 있는 몇 가지 사용 사례입니다:

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

### **중요 참고 사항**

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