Imgix APIs動画 APIフォーマット

フォーマット

ショートフォーム動画の開始

ショートフォーム動画のパラメータを有効にするには fm=mp4 を設定する必要があります。

これらのパラメータは、動画の出力フォーマットを制御します。

Use case

ウェブサイト、アプリ、ブラウザへの直接再生向けにトランスコードした動画を配信します

fm=mp4はデフォルトでH.264にトランスコードします — Webページへの埋め込み、ネイティブアプリ、メディアプレイヤーで最も広く対応したフォーマットです。Imgixの自動品質がコンテンツの種類に合わせた最適な圧縮設定を選択します。
https://assets.imgix.net/Croatia.mp4?fm=mp4

アニメーション画像

Imgix Videoは任意の動画ソースから短いループアニメーションを生成できます。出力フォーマットと「アニメーション化」の指定は独立した軸です。video-generate=animationでアニメーション出力に切り替え、fmでフォーマットを指定します。これがすべてのフォーマットに対応した推奨の形式です。

リクエスト出力
fm=gifアニメーションGIF (省略形)
fm=webp&video-generate=animationアニメーションWebP
fm=avif&video-generate=animationアニメーションAVIF
fm=png&video-generate=animationアニメーションPNG (APNG)

すべてのアニメーション出力は、ファイルサイズを適切に管理するため、同じデフォルト値と上限を共有しています:

  • 再生時間: デフォルト5秒、最大 10秒video-clip-durationで制御
  • フレームレート: デフォルト15fps、最大 30fpsfpsで制御
  • サイズ: 未指定の軸はデフォルト320px、最大 640×640
  • ループ: デフォルトは無限ループ — video-loopで回数を指定可能

WebPとAVIFはフルカラーでGIFより大幅にファイルサイズが小さくなります。最大互換性が必要な場合のみfm=gifを使用してください。

Use case

Web向けのコンパクトなフルカラーループアニメーションを生成する

fm=webp&video-generate=animationはアニメーションWebPを生成します — フルカラーで同等のGIFより大幅にファイルサイズが小さくなります。video-clip-startvideo-clip-durationでソースを任意のセグメントにクリップできます。
https://assets.imgix.net/Croatia.mp4?fm=webp&video-generate=animation&video-clip-duration=5&w=480