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

# Video Inference

{% hint style="warning" %}
当社の Hosted Video Inference 方式はインターネット接続を必要とし、保存済みの動画ファイルで実行されます。リアルタイムの動画ストリームに対するエッジ推論については、当社の [Inference](https://inference.roboflow.com) のドキュメント。
{% endhint %}

Video Inference API は非同期の動画処理向けに最適化されています。任意のモデルの実行をサポートします [Roboflow Inference](https://roboflow.com/inference) 実装するもの（CLIP のような基盤モデルや、あなたがカスタムで fine-tune したモデルを含む [Roboflow で学習した](https://roboflow.com)、そして他の人が Roboflow 上で共有した何千ものモデルも [Roboflow Universe](https://universe.roboflow.com)）を使用して、録画済み動画の全フレームまたは一部のフレームに対する予測を取得します。

API を使用して予測を取得するには、以下の手順に従ってください：

1. 動画をアップロード
2. アップロードした動画に対して、モデルまたはモデルのリストで推論をリクエストする
3. 結果が利用可能になるまでポーリングする

GPU を効率的にバッチ処理して活用するための最適化と、より高いレイテンシ許容度により、Video Inference API は保存済み（リアルタイム配信ではない）動画処理において、画像ベースのものより最大 100 倍安くなる場合があります [Roboflow Serverless Hosted API](/roboflow/roboflow-jp/depuroi/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 にアップロードされた動画は、ダウンロードすることはできません。アップロード機能は、バックエンドが推論目的で動画を処理できるようにするためだけのものです。