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

# 動画推論

動画フレーム全体でコンピュータビジョンモデルを実行します。

{% hint style="warning" %}
当社のホスト型ビデオ推論方式はインターネット接続を必要とし、保存済みの動画ファイルに対して実行されます。リアルタイム動画ストリームでのエッジ推論については、当社の [推論](/deployment/ja/serufuhosuto/self-hosted.md) ドキュメントをご覧ください。
{% endhint %}

Video Inference API は非同期の動画処理に最適化されています。任意のモデルの実行をサポートします [Roboflow Inference](https://roboflow.com/inference) が実装するもの（CLIP のような基盤モデルや、あなたがカスタムでファインチューニングしたモデルを含む [Roboflow で学習させた](https://roboflow.com)、および他のユーザーが [Roboflow Universe](https://universe.roboflow.com))で、録画済み動画の全フレームまたは一部のフレームに対する予測を取得できます。

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

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

GPU を効率的にバッチ処理・活用する最適化と、より高いレイテンシ許容のおかげで、Video Inference API は、画像ベースの [ホスト型 API（レガシー）](/deployment/ja/regash/legacy-serverless.md).

API の出力形式の仕様を表示する [こちら](/deployment/ja/regash/legacy-serverless/video-inference/video-inference-json-output-format.md).

### モデル対応

Video Inference API は次のモデルタイプで使用できます：

| タスクタイプ                                                                                    | Hosted API（レガシー）でサポート |
| ----------------------------------------------------------------------------------------- | --------------------- |
| [物体検出](/deployment/ja/regash/legacy-serverless/video-inference/use-a-fine-tuned-model.md) | ✅                     |
| [CLIP](/deployment/ja/regash/legacy-serverless/video-inference/use-clip.md)               | ✅                     |
| [視線検出](/deployment/ja/regash/legacy-serverless/video-inference/use-gaze-detection.md)     | ✅                     |
| 分類                                                                                        | ✅                     |
| インスタンスセグメンテーション                                                                           | ✅                     |
| セマンティックセグメンテーション                                                                          | ✅                     |

### 使用例

Video Inference API を使用できるいくつかの使用例を以下に示します：

* 動画のタグ付け
* 動画モデレーション（つまり、メディア内の暴力的なシーンや露骨なシーンを検索すること）、
* ブランドや製品を見つけてタグ付けする
* 動画からテキストを抽出する
* シーンの分割と分類
* オブジェクト数のカウント
* メディア検索のインデックス化
* 動画内でコンテキスト広告を配置できる領域を特定する
* その他。

### **重要な注意事項**

1. ビデオ推論は現在、次の動画ファイル拡張子をサポートしています： *mp4、MP4、avi、AVI、mkv、MKV、webm、WEBM。*
2. Roboflow は、ユーザーが同じアップロード済み動画に対して動画推論を再実行する際に、動画を毎回すべて再アップロードしなくて済むよう、アップロードされた動画を1週間キャッシュします。この1週間を過ぎると、動画は完全に削除されます。
3. Roboflow にアップロードされた動画は、ダウンロードできません。アップロード機能は、バックエンドが推論目的で動画を処理できるようにするためだけのものです。