ショットカット

ショットカットノードは、動画のすべてのショットがどこで始まり、どこで終わるかを見つけます。各ショットを、開始、終了、長さとともに一覧にします。最初と最後のフレームを保存をオンにすると、各ショットの最初のフレームと最後のフレームも画像として得られます。

ノードはファイルそのものを測定します。デコードしたすべてのフレームを直前のフレームと比べ、落ち着いた状態から急に大きく変化したフレームで新しいショットが始まります。これは、動画マスクが動画をショットごとにマスクするときと同じルールです。

ノードは、AI モデルやプロバイダーのキーを使わずにローカルで動作するので、すべてのエディションで使えます。

使いどころ

• 広告、予告編、ミュージックビデオなどの編集からショットリストを得て、ショットごとに作り直したり、スタイルを変えたりする。
• すべてのショットの静止画を保存し、画像モデルや動画モデルのリファレンス画像に使う。
• すべてのショットの長さをひと目で確認して、編集のテンポを測る。
• チャンクに分割の前にカットの位置を見つける。そのショットモードは、これと同じ位置で動画を分割します。

クイックスタート

入力

出力

ショット出力は次のようになります。

{
  "shotCount": 3,
  "cutsSec": [2.5, 6.042],
  "durationSec": 9,
  "shots": [
    { "index": 0, "startSec": 0, "endSec": 2.5, "durationSec": 2.5, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
    { "index": 1, "startSec": 2.5, "endSec": 6.042, "durationSec": 3.542, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
    { "index": 2, "startSec": 6.042, "endSec": 9, "durationSec": 2.958, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" }
  ]
}

設定

カットとして数えるもの

• ハードカットは新しいショットを始めます。1 つのフレームが前後のフレームと大きく異なる場合です。
• 緩やかな切り替えはカットではありません。ディゾルブや黒へのフェードは変化を多くのフレームに分散させるので、前後のショットは 1 つとして数えられます。
• フラッシュ。2〜3 フレーム続いて元の映像に戻るフラッシュはカットではありません。1 フレームだけのフラッシュはカットです。
• カットを見逃すことがあります。ホイップパンのように、カットの直後 3 フレーム以内に 2 つ目の大きな変化が続く場合です。

クレジット

ショットカットは、フレームの有無や動画の長さにかかわらず、1 回の実行につき一律の料金です。ノードの実行ボタンに料金が表示されます。セルフホスティングの Community エディションと Business エディションでは、クレジットを使いません。

次の実行は失敗し、クレジットは返還されます。

• 読み込める動画ではないファイル。
• 約 10.7 GiB を超えるファイル。ダウンロードはそこで止まります。
• 30 分より長い動画。先にトリミングしてください。
• フレームの保存がオンの場合、1,000 を超えるショットがある動画。時間だけを得るにはフレームの保存をオフにするか、動画をトリミングしてください。

ヒント

• 1 つのショットの時間を読み取る。****ショット出力を、フィールドを shots、出力タイプをリストにしたフィールドを抽出か、リストのノードに接続します。リストとバッチ処理を参照してください。
• 動画をショットごとに作り直す。フレームの保存をオンにし、各ショットの最初のフレームを新しいクリップの開始フレームに使います。
• ショットごとに 1 本のクリップに分割する。****ショットモードのチャンクに分割を使います。
• フレームは正確です。デコードしたフレームそのものを劣化なしで保存し、サイズは動画の映像と同じです。

トラブルシューティング

API から

POST /v1/shot-cuts に { videoUrl, frames? } を渡すとジョブがキューに入り、その jobId が返ります。形式が正しくないリクエストは、クレジットが確保される前に 400 validation_error を返します。完了したジョブの output_data.json は、上記のショットの結果です。フレームの保存がオンの場合、output_data.firstFrames と output_data.lastFrames がフレームの画像をショットの順に並べます。

SDK のメソッドは client.media.shotCuts、MCP ツールは shot_cuts です。単一ノードの実行、SDK のメディアとアップロード、MCP ツールリファレンスを参照してください。