分析と編集リスト
MCP ツールで、動画をシーンごとに分析し、その分析を監査し、無音を検出し、複数の収録を同期して、編集決定リストを計画してレンダリングします。
分析と編集リストのツールは、既存の収録を読み取り、構造化されたデータや完成したカットに変えます。video_analysis と video_audit は、動画を再現できるように、シーンごとに分解します。silence_detect と audio_sync は、収録を測定します。plan_edit と apply_edl は、文字起こしからカットを計画してレンダリングします。どのツールにも workflows:execute 権限が必要で、ジョブ ID を返します。
video_analysis
動画を分析し、AI で再現するためのシーンごとの内訳を作ります。動画分析(Video Analysis)ノードと同じように動作します。
- シーンは自然な区切りで分割され、最長 8 秒です。1 シーンが、画像または動画の 1 回の生成に相当します。
visualResolvedは各シーンの説明で、それだけで完結し、プロンプトにそのまま使えます。後のステップが読み込むのは、このフィールドです。- 各シーンには、ショットの種類、カメラの動き、音のレイヤーのリストもあります。音声は一字一句そのまま引用され、音楽と効果音は生成できるように説明されます。空のリストは、無音を意味します。
- スロットは、繰り返し登場する人物、オブジェクト、場所です。自分のキャラクターで、キャスティングし直せます。
権限:workflows:execute。クレジット:ティアと動画の長さによって決まります(下の表を参照)。
| パラメーター | 型 | 説明 |
|---|---|---|
video_asset_id, video_url or youtube_url | string | 必須(1 つだけ指定)。Nodaro の動画のジョブ ID かアップロード ID、動画への直接の URL、または YouTube のリンクです。最長 10 分で、ライブ配信は使えません。ソースが 0 個か 2 個の場合は、エラーが返されます。 |
llm_model | string | ティアです。pro(デフォルト)、fast(より安価)、smart(最も正確)、mixed、mixed-fast のいずれかです。 |
selection_mode | string | choose(デフォルト)か combine です。combine は、検証を経て強化された、最も詳細な結果です。少し遅くなりますが、おすすめです。 |
variations | boolean | 着替え、夢、変装など、人物やものの別の見た目も検出し、それぞれの見た目を登場するシーンに結び付けます。デフォルトは false です。 |
music_video | boolean | クリップをミュージックビデオとして扱い、歌われたすべての歌詞を音声として文字起こしします。デフォルトは false で、その場合、画面上の誰も歌っていない歌のボーカルは、音楽のレイヤーに含まれます。 |
translate_speech_to_english | boolean | 話された言葉と歌われた言葉を、英語で返します。デフォルトは false で、元の言語のままです。 |
translate_on_screen_text_to_english | boolean | 看板、字幕、タイトルを英語で返します。このテキストは映像のプロンプトの一部なので、再生成したシーンには英語の文字が表示されます。名前は元の形のままです。デフォルトは false です。 |
analysis_focus | string | 分析の方向づけで、最大 2,000 文字です。たとえば「商品のショットと画面上のテキストに注目」です。 |
戻り値:ジョブ ID です。分析結果(meta、slots、scenes)は、ジョブの output_data に入ります。
料金は、ティアと長さの段階によって決まります。長さの段階は、60、180、360、600 秒のうち、動画が収まる最小のものです。
| ティア | 60 秒まで | 180 秒まで | 360 秒まで | 600 秒まで |
|---|---|---|---|---|
fast | 181 | 186 | 516 | 849 |
pro | 217 | 233 | 642 | 1,059 |
mixed、mixed-fast | 270 | 292 | 731 | 1,181 |
smart | 414 | 504 | 1,270 | 2,081 |
最新の料金は、常にツール自体の説明に記載されています。この表とツールの内容が異なる場合は、ツールのほうが正しい情報です。
video_audit
動画をもう一度見て分析と照らし合わせ、誤りを修正します。すべての修正はチェックを経て適用され、報告されます。修正できなかった部分は、変更されずに要注意として示されます。AI 監査(AI Audit)ノードと同じように動作します。
権限:workflows:execute。クレジット:長さによって決まり、分析を渡すと安くなります。
| パラメーター | 型 | 説明 |
|---|---|---|
video_url | string | 必須。監査する動画です。 |
analysis | object | 以前の video_analysis または video_audit の呼び出しで得た分析を、そのまま渡します。渡さない場合、ツールはまず高速な分析を実行するため、料金が高くなります。 |
戻り値:ジョブ ID です。ジョブの output_data にはレポートが入ります。レポートには、チェックした内容、変更した内容、未解決のまま残った内容が含まれます。
| 実行 | 60 秒まで | 180 秒まで | 360 秒まで | 600 秒まで |
|---|---|---|---|---|
analysis あり | 215 | 291 | 664 | 1,075 |
analysis なし | 396 | 477 | 1,180 | 1,924 |
silence_detect
収録の中の無音区間を、音だけから見つけます。文字起こしも映像も使いません。無音検出(Silence Detect)ノードと同じように動作します。
権限:workflows:execute。クレジット:10。
| パラメーター | 型 | 説明 |
|---|---|---|
audio_url | string | 必須。オーディオか動画の URL です。どちらの場合も、オーディオトラックが読み込まれます。 |
threshold_db | number | 無音とみなすレベルで、dBFS 単位の -90〜0 です。デフォルトは -35 で、話し声に適した下限です。 |
min_silence_ms | integer | 報告する、最短の無音の長さで、1〜600,000 ミリ秒です。デフォルトは 700 です。 |
pad_ms | integer | 各範囲の前後に残す、話し声の長さで、0〜60,000 ミリ秒です。デフォルトは 120 です。 |
戻り値:ジョブ ID です。結果は output_data.json で、{ ranges, durationMs } の形です。output_data 全体ではなくこのオブジェクトを、plan_edit の silence として渡します。または、ranges を使って、編集リストを手で書きます。
audio_sync
カメラのファイルとメインマイクなど、1 つの会話を収録した 2〜6 本の録音について、音を比較して、それぞれの時計がどれだけずれているかを測定します。音声同期(Audio Sync)ノードと同じように動作します。
権限:workflows:execute。クレジット:基準にそろえる録音 1 本につき 10 で、10 ×(ソースの数 - 1)です。
| パラメーター | 型 | 説明 |
|---|---|---|
sources | array | 必須。2〜6 本の録音で、それぞれ { id, url } です。ID は重複しないようにします。オーディオか動画の URL を指定します。 |
reference | string | すべてのオフセットの基準になる録音の ID です。デフォルトは、最初の録音です。 |
戻り値:ジョブ ID です。結果は output_data.json で、{ reference, offsets, notes } の形です。各オフセットには、sourceId、offsetMs、confidence、driftMsPerHour が含まれます。基準の時計での時刻は、そのソースでの時刻に offsetMs を足したものです。低い信頼度と時計のドリフトは notes で報告され、補正されることはありません。
plan_edit
タイムスタンプ付きの文字起こしを、収録の編集決定リストに変えます。読み取るのは文字起こしだけで、映像は読み取りません。編集プラン(Edit Plan)ノードと同じように動作します。
権限:workflows:execute。クレジット:収録の長さ、モード、ティアによって、30〜1,480 です。Nodaro Cloud のみ。
| パラメーター | 型 | 説明 |
|---|---|---|
mode | string | 必須。tighten は、無音、フィラーワード、言い直しを取り除いた 1 本のカットを作ります。clips は、共有しやすい短いクリップを見つけ、クリップごとに 1 つの編集リストを作ります。chapters は、タイトル付きのチャプターを付けます。 |
transcript | object | 必須。単語単位の文字起こしです。transcribe で作ります。 |
sources | array | 必須。1〜6 本の収録素材です。それぞれに url を指定し、任意で kind(video または audio)、role(master-audio、camera、wide、screen のいずれか)、speakers、マスタークロック上の offset_ms を指定します。 |
silence | object | silence_detect の結果です。 |
plan_tier | string | economy、standard(デフォルト)、premium のいずれかです。 |
count | integer | clips 用です。クリップの数で、1〜50 です。 |
target_duration_sec | integer | clips 用です。各クリップの長さで、5〜180 秒です。 |
target_aspect | string | 16:9、9:16、1:1、4:5 のいずれかです。 |
platform, instructions, style_guide | string | クリップを投稿する場所と、自由記述のガイダンスです。 |
戻り値:ジョブ ID です。プランはジョブの output_data に入り、そのまま apply_edl に渡せます。
apply_edl
編集決定リストを、完成したカットにレンダリングします。EDL 適用(Apply EDL)ノードと同じように動作します。1 分あたりの料金も、このノードのページに記載されています。
権限:workflows:execute。クレジット:レンダリングされた出力の 1 分ごとに課金されます。
| パラメーター | 型 | 説明 |
|---|---|---|
edl | object or string | 必須。plan_edit のプラン、または自分で書いたリストです。その segments は master クロック上の整数のミリ秒で表し、それぞれが EDL の sources の 1 つを ID で指定します。動画をレンダリングするには、すべてのセグメントに動画のソースが必要です。 |
sources | array | EDL のソースの URL を置き換える URL で、同じ順番で指定します。 |
output | string | video(デフォルト)または audio です。 |
quality | string | 高速なプレビュー用の proxy、または final(デフォルト)です。 |
crossfade_ms | number | 独自のトランジションがないつなぎ目にかけるクロスフェードで、最大 5,000 ms です。デフォルトは 0 で、ハードカットになります。 |
transcript | object | カットに合わせて再マッピングする文字起こしです。再マッピングにより、結果と一致するようになります。 |
1 回のレンダリングで作れるのは、最大 180 分です。形式が正しくないリストや長すぎるリストは、何かが実行される前に拒否され、該当するセグメントと、違反したルールが示されます。
戻り値:ジョブ ID です。レンダリングされたファイルが、ジョブの結果です。
文字起こしから収録を編集する
文字起こしする
収録に対して transcribe を呼び出します。単語のタイミングは、ジョブの output_data.json.words に入ります。
無音を見つける
silence_detect を呼び出します。このステップは任意ですが、tighten に役立ちます。
カットを計画する
文字起こし、無音、収録を渡して、tighten、clips、chapters のいずれかのモードで plan_edit を呼び出します。プランを確認し、必要に応じて変更します。
レンダリングする
プランを渡して apply_edl を呼び出します。まず quality: "proxy" で、すばやくプレビューします。
podcast-editing レシピは、アシスタントに同じ手順を案内します。コンテンツレシピを参照してください。複数のカメラと別録りのマイクがある場合は、先に audio_sync を実行し、各ソースの offset_ms を plan_edit に渡します。
よくある質問
関連ページ
動画分析
EDL 適用
オーディオ
コンテンツレシピ
Recast
最終更新