# ショットシーケンスと動画ディレクター

> 1 回の呼び出しでナレーション付きのモーショングラフィックス動画を作る動画ディレクターのツールと、ナレーションに合わせてリビールのタイミングを決めるショットシーケンスのツールのパラメーターです。

Source: https://nodaro.ai/ja/docs/mcp/tools/shot-sequence-and-video-director

**動画ディレクターとショットシーケンスのツール**は、ナレーション付きのモーショングラフィックス動画を作ります。キネティックタイポグラフィ、図形、画像が、ナレーションで対応するフレーズが話された瞬間に現れます。動画ディレクターのツールは 1 回の呼び出しで動画を作り、ショットシーケンスのツールでは各ステップを個別に実行できます。このページでは、パラメーターを説明します。使い方は、[動画ディレクター](https://nodaro.ai/docs/mcp/video-director)と[ショットシーケンス](https://nodaro.ai/docs/mcp/shot-sequence)で説明しています。

| ツール | 権限 | クレジット |
| --- | --- | --- |
| `start_video_director` | 不要 | 無料 |
| `create_explainer` | `workflows:execute` | 脚本作成の実行、ナレーション、アライメント、レンダリング。Nodaro Cloud のみ。 |
| `create_launch_video` | `workflows:execute` | `create_explainer` と同じ。Nodaro Cloud のみ。 |
| `list_shot_shapes` | 不要 | 無料 |
| `get_shot_shape` | 不要 | 無料 |
| `list_brand_presets` | 不要 | 無料 |
| `forced_alignment` | `workflows:execute` | 30 |
| `resolve_shot_sequence` | `workflows:execute` | 無料。ジョブなし |
| `render_shot_sequence` | `workflows:execute` | 1920 × 1080 で 50 |

## `start_video_director`
アシスタントが、ナレーション付きの動画を自分で作るときに従う、モーションディレクター向けのガイドを返します。ジャンルとストーリーの構成の選び方、キューフレーズとしてのナレーションの書き方、ショットシーケンスのブリーフの組み立て方、パイプラインの実行方法を説明しています。何も変更しないので、何度でも呼び出せます。

このツールにパラメーターはありません。

## `create_explainer`
あるトピックについて、ナレーション付きでタイムコードの入った解説動画を、1 回の呼び出しで書いてレンダリングします。ディレクターがナレーション原稿とショットシーケンスのブリーフを書き、ナレーションを生成して単語単位でアライメントし、MP4 をレンダリングします。

**権限**：`workflows:execute`。**クレジット**：脚本作成の実行に、ナレーション、アライメント、レンダリングを加えた料金です。脚本作成の料金は、`list_models` の `video-director` に記載されています。**Nodaro Cloud のみ**。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `topic` | string | **必須**。解説動画で伝える内容で、1〜8,000 文字です。 |
| `brand` | string or object | `cobalt-corporate` のようなブランドプリセットの ID か、独自のブランドトークンです。下記を参照してください。 |

**戻り値**：ジョブ ID です。カードに進行状況が表示され、動画が再生されます。カードがない場合は、`get_job` をポーリングします。MP4 は `output_data.videoUrl` にあります。

## `create_launch_video`
製品の説明から、ナレーション付きの製品ローンチ動画を、1 回の呼び出しで書いてレンダリングします。

**権限**：`workflows:execute`。**クレジット**：`create_explainer` と同じです。**Nodaro Cloud のみ**。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `brief` | string | 製品の説明です。製品の内容、対象となる人、主な機能、トーンを書きます。1〜8,000 文字です。 |
| `brand` | string or object | `create_explainer` と同じです。 |
| `url` | string | キャプチャする製品の URL です。この機能には対応していません。`brief` がない場合、ツールはブリーフが必要だと答えます。`brief` がある場合、URL は無視されます。 |

**戻り値**：ジョブ ID です。

### `brand` オブジェクト
| フィールド | 説明 |
| --- | --- |
| `palette` | **必須**。16 進数のカラーコードです。`bg`、`text`、`accent` は必須で、`accent2`、`bgAlt`、`line`、`textMuted` は任意です。 |
| `fonts` | **必須**。`heading` と `body` で、それぞれ対応している 24 のファミリーのいずれかを指定します。たとえば Inter、Montserrat、Playfair Display、Bebas Neue です。Rubik、Heebo、Cairo、Tajawal は、ヘブライ語とアラビア語に対応しています。任意の `headingType` と `bodyType` では、`weight`（100〜900）、`casing`（`uppercase`、`lowercase`、`none`）、`tracking`（-0.2〜0.5 em）を設定します。 |
| `logo` | 任意です。`name` は必須で、ワードマークの文字列です。`tagline` は、その下に表示する 1 行のテキストです。`image` は、Nodaro にアップロードした PNG、WebP、JPEG の `https` URL です。`imageBackdrop` は、画像の背後に置くパネルの色を示す 16 進数のカラーコードです。 |

## `list_shot_shapes`
15 種類のショットシーケンスのブループリントのカタログを返します。ブループリントは、`kinetic-type-beats` や `titlecard-reveal` のような既製のアニメーション演出で、それぞれの役割、説明、フレーム単位のデフォルトの長さが含まれます。ブリーフを書く前に呼び出して、場面ごとに使うブループリントを選びます。

このツールにパラメーターはありません。

## `get_shot_shape`
1 つのブループリントの詳細を返します。役割、説明、デフォルトの長さ、`params` の JSON スキーマ、そしてブリーフにそのまま貼り付けられる記入済みの例です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `id` | string | **必須**。`titlecard-reveal` のようなブループリントの ID です。不明な ID を指定すると、既知の ID の一覧とともにエラーが返されます。 |

## `list_brand_presets`
`midnight-violet` や `editorial-cream` など、8 つのブランドプリセットを返します。ブランドプリセットは、名前の付いたパレットとフォントの組み合わせで、ラベル、ムード、説明、パレット、フォントが含まれます。プリセットの ID を `brand` として渡すと、すべてのシーンの統一感を保てます。

このツールにパラメーターはありません。

## `forced_alignment`
内容がわかっている文字起こしを、オーディオまたは動画のクリップに合わせ、すべての単語の開始時間と終了時間を返します。動画の場合は先に音声トラックが抽出されるため、人物が話しているクリップもそのままアライメントできます。[**強制アライメント**（Forced Alignment）](https://nodaro.ai/docs/nodes/audio/forced-alignment)ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：30。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `transcript` | string | **必須**。話されている言葉そのもので、最大 50,000 文字です。ショットシーケンスでは、ナレーション原稿をそのまま指定します。 |
| `audio_url` or `audio_asset_id` | string | オーディオまたは動画です。URL か、Nodaro のジョブ ID で指定します。 |

**戻り値**：ジョブ ID です。アライメントは `output_data.alignment` に含まれます。これは、秒単位の `{ word, start, end }` のリストです。

## `resolve_shot_sequence`
ショットシーケンスのブリーフと単語のタイミングを、レンダリングできる状態のプランに焼き込みます。各キューを対応する単語と照合し、キューに基づくすべてのリビールを正確なフレームに変換します。ジョブを作らずにすぐ実行され、プランを返します。

**権限**：`workflows:execute`。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `brief` | object | **必須**。ショットシーケンスのブリーフです。ナレーション、シーン、ショット、リビールを含みます。 |
| `audio_url` | string | **必須**。ナレーションのオーディオです。 |
| `alignment` | array | **必須**。`forced_alignment` の `output_data.alignment` です。 |

**戻り値**：`plan` と `warnings` です。警告の例として、見つからなかったために比例配分のタイミングにフォールバックしたキューがあります。シーンの時間が重なっている場合、ツールは `422 scene_overlap` を返します。ここでは、ブランドのロゴ画像は自動で追加されません。ロゴを表示するには、`logo-assemble-lockup` のリビールを自分で入れてください。

## `render_shot_sequence`
解決済みのプランを、MP4 にレンダリングします。動画はライブラリにも保存されます。

**権限**：`workflows:execute`。**クレジット**：[**動画レンダリング**（Render Video）](https://nodaro.ai/docs/nodes/video/render-video)ノードと同じです。長辺が 1920 ピクセルまでは 50 です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `plan` | object | **必須**。`resolve_shot_sequence` で取得したプランです。 |

**戻り値**：ジョブ ID です。カードに進行状況が表示され、動画が再生されます。

## Frequently asked questions

### create_explainer とショットシーケンスのツールの違いは何ですか？

create_explainer は、1 回の呼び出しで、ナレーション原稿とブリーフを書き、ナレーションを生成してアライメントし、動画をレンダリングします。ショットシーケンスのツールでは、各ステップを自分で実行でき、レンダリングの前にブリーフを確認できます。

### 動画ディレクターで、自分のブランドカラーとロゴを使えますか？

はい。brand に、list_brand_presets で取得したプリセットの ID を渡すか、自分のパレット、フォント、ロゴを渡します。ロゴ画像は、Nodaro にアップロードした PNG、WebP、JPEG の画像である必要があります。

### このグループのツールのうち、無料なのはどれですか？

start_video_director、list_shot_shapes、get_shot_shape、list_brand_presets、resolve_shot_sequence は無料です。forced_alignment と render_shot_sequence はクレジットを使います。1 回の呼び出しで動画を作る 2 つのツールも、クレジットを使います。