> 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는 비동기 비디오 처리에 최적화되어 있습니다. 모든 모델 실행을 지원합니다 [Roboflow Inference](https://roboflow.com/inference) 구현하는 모델(Foundation model인 CLIP 같은 것, 사용자가 [Roboflow로 학습한](https://roboflow.com), 그리고 다른 사람들이 공유한 수천 개의 모델 [Roboflow Universe](https://universe.roboflow.com))를 사용해 녹화된 비디오의 모든 프레임 또는 일부 프레임에 대한 예측을 얻을 수 있습니다.

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

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

GPU를 효율적으로 배치하고 활용하기 위한 최적화와 더 높은 지연 허용 덕분에, Video Inference API는 저장된(실시간 스트리밍 대비) 비디오 처리에서 이미지 기반보다 최대 100배 저렴할 수 있습니다 [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주일 동안 캐시합니다. 전체 비디오를 반복해서 다시 업로드할 필요가 없습니다. 이 1주일이 지나면 비디오는 영구적으로 삭제됩니다.
3. Roboflow에 업로드된 비디오는 절대 다운로드할 수 없습니다. 업로드 기능은 오직 백엔드가 추론 목적으로 비디오를 처리할 수 있게 하기 위한 것입니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/deploy/serverless/video-inference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.