クリップ範囲

1回のリクエストで動画の複数の非連続セグメントを選択して連結します。

video-clip-ranges はセミコロン区切りの start-end 時刻ペアのリスト（秒単位）を受け取ります。各ペアが出力に含めるセグメントを定義し、指定した順序で結合されます。

video-clip-ranges=0-5;10-15;18-22

上記の例では、0〜5秒、10〜15秒、18〜22秒の3つのセグメントをこの順序で連結した1つの出力動画を生成します。

個別のクリップパラメータとの比較

video-clip-start、video-clip-end、video-clip-duration は単一の連続セグメントを抽出します。1回の操作で複数の非連続セグメントを抽出して結合する場合は video-clip-ranges を使用してください。

video-clip-ranges は video-clip-start、video-clip-end、video-clip-duration と組み合わせることはできません。

パーセント指定

範囲の境界値には、絶対秒数の代わりに動画の総尺に対するパーセンテージも使用できます。数値に % サフィックスを付けて指定してください。

% は URL の予約文字であるため、クエリ文字列内では %25 にパーセントエンコードする必要があります。たとえば 25% は URL 上では 25%25 と記述します。

video-clip-ranges=0-25%25;50%25-75%25

秒数とパーセンテージは、同一の範囲ペア内またはペアをまたいで混在させることができます。たとえば 0-25%25 は 0 秒から総尺の 25% の位置までを指定します。

https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=mp4&video-clip-ranges=0-25%25;50%25-75%25