Imgix APIs動画 API概要

Video API

Imgix Video API を使用すると、ユーザーに対して最適化された動画配信が可能になります。URL ベースの API を使用して、サムネイルの生成やさまざまな動画変換処理を行うことができます。Video API は、ウェブサイトやアプリでの素早い再生に最適です。5 分未満の動画(動画クリップ、GIF、背景動画など)に特に適しています。ショートフォーム動画は .net サブドメインを通じて配信され、カスタムドメインをサポートし、トランスコード不要ですぐに利用できます。

動画機能

  • サムネイル生成
  • 即時利用可能
  • ビットレート選択
  • コーデック選択
  • 署名機能
  • 動画のリサイズ
  • クリッピング
  • .net 経由の配信
  • カスタムドメイン対応

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

Imgix Video は最大 5 分の動画をサポートしています。クリップ、GIF、背景動画などのほとんどのユースケースには、この長さで十分です。

最大 30 分の動画については、ベータ機能として拡張サポートをご利用いただけます。アカウントで有効にするには、サポートまでお問い合わせください。

30 分を超える動画の場合、Imgix Video は初回リクエスト時に非同期でエンコードを行います。

処理時間

動画のエンコードには時間がかかる場合があります。初回リクエストは、動画が完全に処理されるまで数分間 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 95+)を保証しながら最小限のファイルサイズを実現します。

帯域効率を最適化する場合は、品質レベルを手動で調整する必要がない 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 日間は無料です。クレジットの消費を抑えるには、90 日以内に動画を再リクエストしてキャッシュを維持するようにしてください。