Imgix APIs動画 API概要

Video API

Imgix Video API を使用すると、ユーザーに対して最適化された動画配信が可能になります。URL ベースの API を使用して、サムネイルの生成やさまざまな動画変換処理を行うことができます。Video API は、ウェブサイトやアプリでの素早い再生に最適で、動画クリップ、GIF、背景動画などのショートフォームコンテンツに特に適しています。2 分以下の動画はオンザフライでレンダリングされ、すぐに利用できます。それより長い動画は、非同期のバックグラウンド処理によってサポートされます。Imgix Video は .net サブドメインを通じて配信され、カスタムドメインをサポートし、個別のトランスコード手順を必要としません。

動画機能

サポートされる動画の長さ

Imgix Video は短い動画と長い動画の両方に対応しています。動画がどのように処理されるかは、その長さによって異なります。

  • 2 分以下: 動画はオンザフライで同期的にレンダリングされ、すぐに利用できます。
  • 2 分を超える場合: 動画はバックグラウンドで非同期に処理されます。初回リクエストでは、レンダリングの準備中に 423 ステータスが返され、それ以降のリクエストでは完成した動画がキャッシュから配信されます。

クリップ、GIF、背景動画などのほとんどのユースケースでは、同期レンダリングにより、個別のトランスコードや前処理の手順なしで動画をすぐに利用できます。

処理時間

動画のエンコードには時間がかかる場合があります。初回リクエストは、動画が完全に処理されるまで数分間 423 が返されることがあります。動画のレスポンスが返るまで URL をポーリングするか、数分後に再度アクセスしてください。

自動ビットレート選択

デフォルトでは、fm=mp4video-bitrate および video-codec パラメータなしで使用した場合、Imgix Video は幅広くサポートされている H.264 コーデックを使用してエンコードし、適切なビットレートを自動的に選択します。エンコーダーは可変ビットレートを使用し、固定の出力値を目標とするのではなく、動画コンテンツを分析して品質とファイルサイズのバランスを取ります。

fm=mp4 を使用する際は、エンコードされていない動画を Imgix Video で使用することをお勧めします。配信前に動画をあらかじめエンコードすると、Imgix Video の自動ビットレート選択の動作により、出力ファイルサイズがソースより大きくなる場合があります。予測可能で制御された出力を得るには、video-bitrate および video-codec パラメータを使用してください。

ショートフォーム動画の最適化

画像ではリサイズが最も一般的な最適化操作であるのに対し、動画の最適化はより複雑です。最も効果的な最適化操作は以下の通りです:

  • video-bitrate:このパラメータでは動画のビットレートを指定できます。ビットレートが高いほど画質は向上しますが、ファイルサイズも大きくなります。推奨範囲は 1M5M です。
  • video-codec:このパラメータでは動画のコーデックを指定できます。コーデックには効率の良いものもありますが、すべてのブラウザが対応しているわけではありません。
  • video-aq:このパラメータでは動画エンコード時に使用する品質解析モードを制御します。video-aq=enhanced を設定すると、エンコード前に深層 VMAF 解析を実行し、知覚品質を維持しながら大幅にファイルサイズを削減できます。低複雑度コンテンツでは 40〜60%、標準的な映像コンテンツでは 15〜25% の帯域削減が期待できます。

品質制御:qvideo-aq の違い

Imgix Video には、異なる目的を持つ 2 つの品質関連パラメータがあります:

  • q出力品質レベルを直接制御します。ファイルサイズと視覚的な品質のトレードオフを明示的に制御したい場合に使用します。デフォルトは q=75 で、低い値ではファイルサイズが小さくなる代わりに画質が低下し、高い値では画質が向上しますがファイルサイズが大きくなります。
  • video-aq はエンコード時に使用する品質解析モードを制御します。固定の品質レベルを設定する代わりに、video-aq=enhanced は VMAF 解析を使用して各動画の最適なビットレートを自動的に決定し、目標とする知覚品質(デフォルトで VMAF 93)を維持しながら最小限のファイルサイズを実現します。

帯域効率を最適化する場合は、品質レベルを手動で調整する必要がない video-aq=enhanced の使用を推奨します。

動画クレジット

Imgix Video はクレジットベースの料金モデルを採用しています。クレジットは実行された処理の種類に応じて消費されます。

カテゴリ対象操作クレジット
スタンダード動画エンコーディング:ビットレート、コーデック、クリップ、スケール、品質、クロップ、ウォーターマーク、字幕、スプライトシート、音声波形、HLS/DASHMP4 出力 1 分あたり 2 クレジット;HLS/DASH 出力 1 分あたり 6 クレジット。クレジットは秒単位で計算されます。
アドバンスドスマートクロップ、自動プレビュー、高精度自動品質調整 (VMAF)プレビューは入力 1 分あたり 1 クレジット;スマートクロップと VMAF は出力 1 分あたり 1 クレジット。クレジットは秒単位で計算され、スタンダードクレジットに加算されます。
プレミアム再生速度 & フレーム補間出力 1 分あたり 10 クレジット。クレジットは秒単位で計算され、スタンダードクレジットに加算されます。
スペシャライズド画像から動画への変換リクエストあたり 25 クレジット。クレジットはリクエスト単位で計算され、その他のクレジットに加算されます。
キャッシュレイヤー派生動画レンダリングのキャッシュストレージ作成後 90 日間は無料;90 日経過後は 1 GB あたり月 1 クレジット。

無料キャッシュ

レンダリングされた動画はキャッシュされ、最初の 90 日間は無料で保存されます。レンダリング結果がそれ以降もキャッシュに残る場合、91 日目からは 1 GB あたり月 1 クレジットのストレージ料金が発生します。同じ URL への繰り返しのリクエストはこのキャッシュから配信されるため、クレジットを抑える鍵は正規の URL を再利用することです。これにより、同じ出力を再レンダリングするコストを回避できます。