動画サムネイル
video-thumbnail
動画からサムネイルを生成します。次のいずれかの形式を受け付けます：
- サムネイルを生成する時間（秒）を表す数値（例：
video-thumbnail=5、video-thumbnail=0.04） - 空の値または
0（デフォルト）：カラーヒストグラムスコアリングを使用して最も代表的なフレームを自動選択し、黒や単色のフレームを除外します
video-thumbnail が指定されている場合、Iris は動画ではなく画像を返します。fm パラメータはオプションで、出力画像の形式を設定します（例：fm=jpg、fm=webp、fm=png）。
さらに、auto=compress,format、w、h、fit、crop などを含む Rendering API の任意のパラメータを使用して、サムネイルを変換・最適化できます。
サムネイルと動画は別々のリクエストです
video-thumbnail を含む URL は画像を返します。動画ではありません。動画用（fm=mp4）とサムネイル用（fm=jpg&video-thumbnail=N）の2つの別々の URL が必要です。1つの URL で両方を返すことはできません。
よくある使用例
最初のフレーム
最初のフレームを抽出するには、video-thumbnail=0.04（24fps で約1フレーム）などの小さな正の値を使用します。video-thumbnail=0 は使用しないでください — これはフレーム 0 ではなく、自動選択を引き起こします。
最後のフレーム
動画の長さを超えるタイムスタンプは最終フレームにクランプされます。最後のフレームを確実に取得するには、まず fm=json（別リクエスト）で動画の長さを取得し、その値をタイムスタンプとして渡します（例：22秒の動画であれば video-thumbnail=22.08）。または、video-thumbnail=99999 のような十分に大きな値を使用すると、どの動画でも最終フレームにクランプされます。
video-thumbnail を HTML で使用する
<video> 要素の poster 属性にサムネイル URL を、src に動画 URL を指定します：
<video
controls
poster="https://myhost.imgix.net/myvideo.mp4?fm=jpg&video-thumbnail=3"
src="https://myhost.imgix.net/myvideo.mp4?fm=mp4"
>
Your browser does not support the video tag.
</video>以下の「動画サムネイルピッカー」デモを使用して、video-thumbnail パラメータをテストできます。