# 動画

> AI アシスタント向けの Nodaro の動画ツールで、テキストや画像から動画を生成し、クリップの延長、スタイル変更、リライティング、アップスケールができます。顔をしゃべらせたり、動かしたりもできます。

Source: https://nodaro.ai/ja/docs/mcp/tools/video

**動画ツール**を使うと、アシスタントは Nodaro で動画を作成、変換できます。テキストや画像からクリップを生成し、延長やスタイル変更、リライティング、アップスケールを行い、顔をしゃべらせたり、動きをコピーしたりできます。各ツールはジョブを開始してその ID を返し、結果はライブラリに保存されます。どの動画ツールにも `workflows:execute` 権限が必要です。動画のジョブには、通常 2〜10 分かかります。

| ツール | 機能 |
| --- | --- |
| [`generate_video`](#generate_video) | テキストから動画を作る（リファレンスは任意） |
| [`animate_image`](#animate_image) | 画像から動画を作る（終了フレームは任意） |
| [`extend_video`](#extend_video) | クリップを時間的に先へ続ける |
| [`modify_video`](#modify_video) | プロンプトでクリップのスタイルを変える、または編集する |
| [`relight_video`](#relight_video) | クリップ自体のピクセルを使って、ライティングを変える、または背景を差し替える |
| [`video_upscale`](#video_upscale) | クリップをアップスケールする |
| [`lip_sync`](#lip_sync) | オーディオトラックに合わせて、顔に話させる、または歌わせる |
| [`speech_to_video`](#speech_to_video) | 音声クリップに合わせてポートレートを動かす |
| [`motion_transfer`](#motion_transfer) | 動画の動きをキャラクター画像にコピーする |
| [`face_swap`](#face_swap) | 動画の中の顔を置き換える |
| [`stop_video_pro`](#stop_video_pro), [`continue_video_pro`](#continue_video_pro) | **動画生成 Pro**（Generate Video Pro）の長い実行を停止する、または再開する |

## `generate_video`
テキストプロンプトから動画を作成します。[**動画生成**](https://nodaro.ai/docs/nodes/video/generate-video)（Generate Video）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：モデルの料金です。ほとんどのモデルは、長さと解像度で料金が決まります。料金を伝える前に、[`list_models`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_models) でモデルの `pricing` を確認してください。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | 動画の説明で、最大 8,000 文字です。プリセットが提供する場合を除き、必須です。 |
| `model` | string | モデル ID です。デフォルトは `seedance-2-fast` です。不明な ID を指定すると、デフォルトのモデルが使われます。 |
| `duration` | number | 秒数です。対応している最も近い値が使われます。`-1` にすると、Seedance 2 が長さを決めます。 |
| `aspect_ratio` | string | たとえば `16:9`、`9:16`、`1:1` です。デフォルトは `16:9` です。対応していない値を指定すると、代わりの値が使われます。 |
| `resolution` | string | たとえば `480p`、`720p`、`1080p`、`4k` で、モデルによって異なります。指定しない場合は、そのモデルで最も低い解像度が使われます。これが最も安い解像度です。 |
| `sound` | boolean | 対応しているモデルで、サウンドを生成します。 |
| `negative_prompt` | string | 避けたい内容で、最大 8,000 文字です。 |
| `seed` | integer | 固定のシードです。対応しているモデルで使えます。 |
| `reference_image_urls` | array | 被写体の同一性やスタイルを伝えるリファレンス画像を、URL または Nodaro の ID で指定します。上限はモデルごとに異なります。たとえば、Seedance 2.5 では 30 枚、Seedance 2 と MiniMax Hailuo 3 では 9 枚、Gemini Omni では 7 枚、VEO 3.1 では 3 枚です。リファレンスに対応していないモデルは、これを無視します。 |
| `reference_video_urls` | array | スタイルや動きを伝えるリファレンス動画です。対応しているモデルで使えます。 |
| `reference_video_captions` | array | 各リファレンス動画の用途を、同じ順番で、それぞれ最大 500 文字で指定します。各キャプションは、プロンプト内で `@video_1: …` のような行になります。 |
| `reference_audio_urls` | array | 動きの元になるリファレンスオーディオです。対応しているモデルで使えます。 |
| `presetId` | string | [`list_node_presets`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets) で取得したプリセットです。指定したフィールドは、プリセットより優先されます。 |
| `structured` | object | プロンプトに追加する、構造化された詳細です。[`generate_image`](https://nodaro.ai/docs/mcp/tools/image#generate_image) と同じです。 |
| `described_references` | array | 名前は挙げられるものの画像がない被写体を指定する、最大 10 個の `{ name, description }` エントリーです。 |
| `connected_references`, `reference_order` | array | 上級者向けです。エディター独自の形式で、ラベルと順序を付けたリファレンスです。最大 14 個です。 |

**戻り値**：ジョブ ID です。MCP Apps に対応したクライアントでは、動画の準備ができるとカードで再生されます。

Seedance では、複数の場面がある動画を `Shot 1: … Shot 2: …` の形で書き、カメラの動きはショットごとに 1 つにして、サウンドもプロンプトの中で説明してください。`get_node_skill` に `generate-video` を指定すると、モデルファミリーごとのプロンプトのルールが返されます。

リファレンス動画は、そのクリップの何かをコピーするようモデルに指示するものです。何のためのリファレンスなのかを、`reference_video_captions` で伝えてください。たとえば、[3D シーン](https://nodaro.ai/docs/mcp/3d-scenes)をグレーのクレイでレンダリングした動画は、レイアウトのガイドであって、見た目の指定ではありません。キャプションがないと、モデルがグレーのクレイの見た目までコピーすることがあります。

### モデルごとの注意点
| モデル | 注意点 |
| --- | --- |
| Seedance 2（`seedance-2`） | `resolution: "4k"` と、`aspect_ratio: "adaptive"` または `"21:9"` を受け付けます。 |
| Seedance 2 Fast と Mini（`seedance-2-fast`、`seedance-2-mini`） | `480p` と `720p` のみです。 |
| Seedance 2.5（`seedance-2-5`） | `480p`、`720p`、`1080p` に対応し、1 回の呼び出しで最長 30 秒まで生成できます。リファレンスは、画像が最大 30 枚、動画が 10 本、オーディオクリップが 10 本までです。 |
| MiniMax Hailuo 3（`minimax-h3`） | リファレンスは、画像が最大 9 枚、動画が 3 本、オーディオクリップが 3 本までです。`resolution` は `2K`（デフォルト）か、より安い `768P` で、オーディオは常にオンです。テキストだけから作る動画では、具体的なアスペクト比が必要です。リファレンス動画はそれぞれ 2〜15 秒で、合計 15 秒までです。リファレンスオーディオは、画像または動画のリファレンスと一緒に指定する必要があります。 |
| Wan 3.0（`wan-3`、`wan-3-prime`） | リファレンスは、画像が最大 10 枚、動画が 5 本、オーディオクリップが 5 本までです。各クリップは 1〜15 秒で、種類ごとの合計は 15 秒までです。`duration` は 2〜30 秒で、デフォルトは 5 秒です。`resolution` は `480p`、`720p`、`1080p` のいずれかです。`wan-3-prime` は、より速く、料金は高くなります。 |
| Gemini Omni Flash（`gemini-omni-flash`） | Gemini Omni の、より安くて速いバージョンです。`duration` は 4、6、8、10 秒のいずれかで、デフォルトは 8 秒です。`aspect_ratio` は `16:9` または `9:16` です。`resolution` は `720p`、`1080p`、`4k` のいずれかです。 |
| VEO 3.1 Quality（`veo3`） | リファレンスモードがありません。リファレンスを使う場合は、VEO 3.1 Fast または Lite を使ってください。 |

Seedance 2、MiniMax Hailuo 3、Wan 3.0 では、リファレンスと一緒に渡した開始フレームや終了フレームは、リファレンス画像の 1 枚として扱われ、プロンプトでは最初または最後のフレームとして説明されます。Seedance では、リファレンス動画は入力の長さと出力の長さの合計で課金されます。そのため、リファレンスのクリップが長いほど、確保されるクレジットが多くなります。

## `animate_image`
静止画を動画にします。終了フレームも渡すと、最初の画像から 2 枚目の画像へと動く動画になります。[**動画生成**](https://nodaro.ai/docs/nodes/video/generate-video)の「画像から動画」モードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：モデルの料金です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` or `image_asset_id` | string | 最初のフレームです。 |
| `end_frame_url` or `end_frame_asset_id` | string | 最後のフレームです。`list_models` の `features` に `end-frame` を含むモデルを選んでください。 |
| `prompt` | string | 動画の中で起こることで、最大 8,000 文字です。 |
| `model` | string | デフォルトは `seedance-2-fast` です。不明な ID を指定すると、デフォルトのモデルが使われます。 |
| `duration`, `aspect_ratio`, `resolution`, `sound` | | `generate_video` と同じです。 |
| `reference_image_urls`, `reference_video_urls`, `reference_audio_urls` | array | リファレンスです。上限はモデルごとに異なります。たとえば画像は、Seedance 2.5 では 30 枚、Seedance 2 と MiniMax Hailuo 3 では 9 枚、Gemini Omni、Kling 3 Omni、Grok では 7 枚です。 |
| `loop_trim` | object | 結果を、最もきれいにループする位置でトリミングします。`enabled`、`frames_to_test`（1〜64）、`quality`（`lossless` または `precise`）を指定します。古い `auto_loop_trim` パラメーターも引き続き使え、このパラメーターに対応付けられます。 |
| `described_references`, `connected_references`, `reference_order` | array | `generate_video` と同じです。 |

ツールは、渡された内容からモードを選びます。フレーム（最初のフレームと、任意の最後のフレーム）か、リファレンスです。リファレンス動画とリファレンスオーディオは、終了フレームと組み合わせられません。シームレスなループにするには、最初と最後のフレームに同じ画像を使い、サウンドをオフにします。その後、`combine_videos` でコピーをつなぎ、`merge_video_audio` でサウンドを追加します。

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

## `extend_video`
クリップを時間的に先へ続けます。まずモデルを選んでください。2 つのモデルは自分が生成した動画の続きを作り、1 つのモデルはどの動画でも延長できます。

**権限**：`workflows:execute`。**クレジット**：延長に使うモデルの料金です。

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Seedance 2 Extend](https://nodaro.ai/docs/models/video/seedance-2-extend) | Bytedance | Video extension | from 260 | Extend ANY video: generates the continuation (audio included) and trim-stitches it into one seamless clip. |
| [VEO Extend](https://nodaro.ai/docs/models/video/veo-extend) | Google | Video extension | from 190 | Extend an existing VEO 3.1 clip by another segment. |
| [Runway Extend](https://nodaro.ai/docs/models/video/runway-extend) | Runway | Video extension | 320 | Extend a Runway video by another clip. |

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `model` | string | **必須**。`seedance-2-extend`、`veo-extend`、`runway-extend` のいずれかです。 |
| `prompt` | string | **必須**。次に起こることで、最大 8,000 文字です。`seedance-2-extend` では、続きの部分だけを説明します。 |
| `video_url` or `video_asset_id` | string | `seedance-2-extend` 専用です。延長する動画で、どこで作った動画でも使えます。 |
| `kie_task_id` | string | `veo-extend` と `runway-extend` 専用です。以前の VEO または Runway の生成のタスク ID で、そのジョブの出力から取得します。 |
| `duration` | integer | `seedance-2-extend` で追加する秒数です。4〜15 で、デフォルトは `8` です。 |
| `generate_audio` | boolean | `seedance-2-extend` で、サウンドトラックの続きも作ります。デフォルトは `true` です。 |
| `resolution` | string | `seedance-2-extend` の解像度で、`480p`、`720p`（デフォルト）、`1080p`、`4k` のいずれかです。つなぎ目を最もきれいにするには、元の動画に合わせてください。 |
| `reference_image_urls` | array | `seedance-2-extend` のリファレンス画像で、最大 8 枚です。プロンプトでは、リストの順に `@image_1`〜`@image_8` と呼びます。 |
| `veo_quality` | string | `veo-extend` の品質で、`fast` または `quality` です。 |
| `runway_resolution` | string | `runway-extend` の解像度で、`720p` または `1080p` です。 |
| `seed` | integer | 10,000〜99,999 です。 |

**戻り値**：ジョブ ID です。`seedance-2-extend` は、続きの場面をオーディオ付きで生成し、元の動画とつないで 1 本のクリップにします。

## `modify_video`
プロンプトを使って、既存のクリップのスタイルを変えたり、編集したりします。[**動画から動画**](https://nodaro.ai/docs/nodes/video/video-to-video)（Video to Video）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：モデルの料金です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。変更内容で、最大 8,000 文字です。 |
| `video_url` or `video_asset_id` | string | **必須（どちらか一方）**。元のクリップです。 |
| `model` | string | `wan`（デフォルト。Wan 2.6 で、汎用的な選択肢）、`wan-flash`、`wan-videoedit`、`luma-modify`、`runway-aleph`、`happyhorse-edit`、`seedance-2-5` のいずれかです。不明な ID を指定すると、`wan` が使われます。 |
| `duration` | string | Wan と Wan Flash で、`5` または `10` 秒です。 |
| `resolution` | string | Wan と Wan Flash では `720p` または `1080p`、Seedance 2.5 では `480p`〜`1080p` です。 |
| `aspect_ratio` | string | Runway Aleph 専用です。`16:9`、`9:16`、`4:3`、`3:4`、`1:1`、`21:9` のいずれかです。 |
| `audio` | boolean | Wan Flash 専用です。オーディオを残すか、生成し直すかを指定します。 |
| `multi_shots` | boolean | Wan Flash 専用です。クリップ内でのシーンの切り替わりを許可します。 |
| `reference_image_url` | string | Runway Aleph 専用です。スタイルのリファレンス画像です。 |
| `reference_image_urls` | array | Seedance 2.5 専用です。最大 30 枚の画像で、プロンプトでは `{image:1}`、`{image:2}` のように参照します。 |
| `seed` | integer | 固定のシードです。 |

`seedance-2-5` では、プロンプトはクリップ全体を編集する指示になります。結果は、元のクリップの長さとアスペクト比を保ちます。クリップの長さは 4〜30 秒である必要があります。料金は、リファレンス動画を使う Seedance 2.5 の実行と同じように計算されます。入力の秒数と出力の秒数の合計で、最も長いクリップの分が確保され、実際に納品された長さで精算されます。

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

## `relight_video`
元の動画自体のピクセルを使って、クリップのライティングを変えたり、背景を差し替えたり、背景のスタイルを変えたり、新しい要素を合成したりします。Beeble SwitchX を使い、[**リライティングと差し替え**](https://nodaro.ai/docs/nodes/video/relight-and-switch)（Relight & Switch）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：フレーム数と出力解像度で決まります。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `video_url` or `video_asset_id` | string | 元のクリップです。最大 240 フレーム、1 フレームあたり最大 2,770,000 ピクセルです。 |
| `prompt` | string | 新しいライティングや見た目で、最大 2,000 文字です。プロンプト、リファレンス画像、またはその両方を渡します。 |
| `reference_image_url` | string | 新しい見た目のリファレンス画像です。指定することを強くおすすめします。 |
| `alpha_mode` | string | `auto`（デフォルト）は、メインの被写体をマスクします。`fill` は、フレーム全体のスタイルを変えます。`select` は、`mask_url` を 1 つのキーフレームのマスクとして使います。`custom` は、`mask_url` をすべてのフレームに使うマスク動画として使います。 |
| `mask_url` | string | `select` と `custom` では必須です。 |
| `alpha_keyframe_index` | integer | `select` の場合に、マスクが表すフレームです。0 から数えます。 |
| `max_resolution` | string | `720` または `1080`（デフォルト）です。 |
| `seed` | integer | 固定のシードです。 |

**戻り値**：ジョブ ID です。結果には、SwitchX で作成されたことを示す表記が付きます。

## `video_upscale`
クリップを、より高い解像度にアップスケールします。[**動画をアップスケール**](https://nodaro.ai/docs/nodes/video/upscale-video)（Upscale Video）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：アップスケールに使うモデルの料金です。

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Topaz Video Upscale](https://nodaro.ai/docs/models/video/topaz-video-upscale) | Topaz | Video upscaling | 190 | High-quality video upscale and enhancement. |
| [VEO 1080p Upscale](https://nodaro.ai/docs/models/video/veo-1080p-upscale) | Google | Video upscaling | 20 | Upscale VEO output to 1080p. |
| [VEO 4K Upscale](https://nodaro.ai/docs/models/video/veo-4k-upscale) | Google | Video upscaling | 380 | Upscale VEO output to 4K. |

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `model` | string | `topaz`（デフォルト）、`veo-1080p`、`veo-4k` のいずれかです。 |
| `video_url` or `video_asset_id` | string | `topaz` では必須です。 |
| `upscale_factor` | string | `topaz` の倍率で、`1`、`2`、`4` のいずれかです。デフォルトは `2` です。 |
| `kie_task_id` | string | `veo-1080p` と `veo-4k` では必須です。元の VEO の生成のタスク ID です。 |

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

## `lip_sync`
オーディオトラックに合わせて、顔に話させたり歌わせたりします。ポートレートをトーキングヘッド動画にしたり、既存のクリップの口の動きを新しいオーディオに合わせたりできます。[**リップシンク**](https://nodaro.ai/docs/nodes/video/lip-sync)（Lip Sync）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：モデルの料金です。各モデルの料金は、ツールの `model` の説明に記載されています。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` or `image_asset_id` | string | ポートレートです。`kling-avatar`、`kling-avatar-pro`、`infinitalk` で使います。 |
| `video_url` or `video_asset_id` | string | 顔が映ったクリップです。`latentsync` や `video-retalking` など、既存の動画の顔を動かし直すモデルで使います。 |
| `audio_url` or `audio_asset_id` | string | 話し声または歌です。 |
| `model` | string | デフォルトは `kling-avatar` で、720p のトーキングヘッドです。ほかに `kling-avatar-pro`、`infinitalk`、`omnihuman-1-5`、`latentsync`、`wav2lip`、`video-retalking`、`sadtalker`、`heygen-lipsync-precision`、`lipsync-2-pro`、`sync-lipsync-v3`、`volcengine-lipsync`、Seedance 2 ファミリー、`minimax-h3` などがあります。不明な ID を指定すると、`kling-avatar` が使われます。 |
| `prompt` | string | 演技のヒントで、最大 500 文字です。たとえば `a confident TED speaker` のように書きます。一部のモデルが使います。 |
| `resolution` | string | InfiniTalk では `480p` または `720p`、Seedance 2 と 2 Fast では `480p`、`720p`、`1080p` のいずれか、OmniHuman 1.5 では `720p` または `1080p`（デフォルト）です。 |
| `seed`, `fast_mode` | | OmniHuman 1.5 専用です。固定のシードと、品質がわずかに下がる代わりに速いモードです。 |
| `mode` | string | Volcengine 専用です。`lite`（デフォルト。カメラを向いた 1 人）または `basic`（複雑なシーン）です。 |
| `open_scenedet`, `separate_vocal`, `align_audio`, `align_audio_reverse`, `templ_start_seconds` | | Volcengine 専用です。複数の話者がいる場合の話者検出、オーディオのノイズ除去、元の動画をオーディオの長さまでループする設定、元の動画での開始時間です。 |

`get_node_skill` に `lip-sync` を指定すると、歌、吹き替え、映画的な全身ショット、最も安い下書きのそれぞれに、どのモデルが合うかがわかります。

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [minimax-h3](https://nodaro.ai/docs/models/video/minimax-h3) | MiniMax | Image to video, Text to video | from 230 | MiniMax Hailuo 3 — premium multimodal tier: first/last frame + image/video/audio references, native audio, 2K (default) or 768P output, 4-15s per-second pricing. |
| [Kling Avatar Standard](https://nodaro.ai/docs/models/video/kling-avatar-standard) | Kuaishou | Lip sync | 280 | Lip-sync a still portrait to driving audio. Standard quality. |
| [Kling Avatar Pro](https://nodaro.ai/docs/models/video/kling-avatar-pro) | Kuaishou | Lip sync | 560 | Premium lip-sync — better mouth shape and timing. |
| [Seedance 2](https://nodaro.ai/docs/models/video/seedance-2) | Bytedance | Image to video, Text to video | from 230 | Seedance 2 — premium tier with native audio. Per-second pricing by resolution. |
| [Seedance 2 Fast](https://nodaro.ai/docs/models/video/seedance-2-fast) | Bytedance | Image to video, Text to video | from 180 | Cheaper / quicker Seedance 2 tier. |
| [Seedance 2 Mini](https://nodaro.ai/docs/models/video/seedance-2-mini) | Bytedance | Image to video, Text to video | from 120 | Budget Seedance 2 tier — 480p/720p only, per-second pricing by resolution. |
| [Seedance 2.5](https://nodaro.ai/docs/models/video/seedance-2-5) | Bytedance | Image to video, Text to video | from 340 | Seedance 2.5 — up to 30s in one shot, native audio, wide multimodal references. 480p/720p/1080p. |
| [OmniHuman 1.5](https://nodaro.ai/docs/models/video/omnihuman-1-5) | Bytedance | Lip sync | from 1020 | Premium prompt-directed talking avatar from a still image + audio. 720p / 1080p, up to 60s. People, pets, anime. |
| [InfiniTalk](https://nodaro.ai/docs/models/video/infinitalk) | InfiniTalk | Lip sync | from 110 | Audio-driven talking-head from a still image. 480p / 720p. |
| [Sync Lipsync v3](https://nodaro.ai/docs/models/video/sync-lipsync-v3) | Sync | Lip sync | from 1000 | Dub existing footage — re-syncs lips to a new audio track. Video input, billed per second. |
| [Volcengine Lip Sync](https://nodaro.ai/docs/models/video/volcengine-lip-sync) | Volcengine | Lip sync | from 300 | Video-to-video AI dubbing — re-syncs lips to a new vocal track. Multi-speaker (scene detection + speaker ID) in basic mode. Video input, billed per second. |

**戻り値**：ジョブ ID です。動画の準備ができると、カードで再生されます。

## `speech_to_video`
ポートレートを動かし、音声クリップの内容を話させます。顔はリップシンクされ、頭と体も動きます。Wan Speech to Video を使い、[**音声から動画**](https://nodaro.ai/docs/nodes/video/speech-to-video)（Speech to Video）ノードと同じように動作します。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `prompt` | string | **必須**。動きとシーンで、最大 2,500 文字です。 |
| `image_url` or `image_asset_id` | string | ポートレートです。 |
| `audio_url` or `audio_asset_id` | string | 話し声です。 |
| `resolution` | string | `480p`（デフォルト）、`580p`、`720p` のいずれかです。 |
| `negative_prompt` | string | 避けたい内容で、最大 2,500 文字です。 |

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

## `motion_transfer`
動きの元になる動画のモーションをキャラクター画像にコピーし、キャラクターに同じ動きをさせます。[**モーション転送**](https://nodaro.ai/docs/nodes/video/motion-transfer)（Motion Transfer）ノードと同じように動作します。

**権限**：`workflows:execute`。**クレジット**：モデルと長さに応じた料金です。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `image_url` or `image_asset_id` | string | **必須**。キャラクターです。 |
| `video_url` or `video_asset_id` | string | **必須**。動きをコピーする元の動画です。 |
| `prompt` | string | 求める結果で、最大 8,000 文字です。 |
| `provider` | string | モデルです。デフォルトは `kling` です。 |
| `resolution` | string | `480p`、`580p`、`720p`（デフォルト）、`1080p` のいずれかです。 |
| `character_orientation` | string | どちらのフレーミングを優先するかです。`image`（デフォルト）または `video` です。 |
| `background_source` | string | どちらの入力から背景を取るかです。`input_video` または `input_image` で、対応しているモデルで使えます。 |
| `video_duration` | number | 出力の長さで、1〜60 秒です。対応しているモデルで使えます。 |

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

## `face_swap`
動画の中の顔を、ポートレートの顔に置き換えます。[**フェイススワップ**](https://nodaro.ai/docs/nodes/video/face-swap)（Face Swap）ノードと同じように動作します。

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

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `video_url` or `video_asset_id` | string | 元の動画です。 |
| `face_image_url` or `face_image_asset_id` | string | 使う顔が写ったポートレートです。 |

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

## `stop_video_pro`
実行中の**動画生成 Pro** のジョブを停止します。動画生成 Pro は、長い動画をセグメントに分けて作るエンジンで、たとえば [**動画生成 Pro**](https://nodaro.ai/docs/nodes/video/generate-video-pro) ノードを含むワークフローから使われます。処理中のセグメントは破棄されますが、その料金は請求されます。残りのセグメントはスキップされ、完成したセグメントはすべてつなぎ合わされて、ジョブの最終的な動画になります。確保されたクレジットの残りは返還されます。まだ開始していないジョブはキャンセルされ、全額が返還されます。

**権限**：`workflows:execute`。**クレジット**：無料。確保されたクレジットのうち、使われなかった分は返還されます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `job_id` | string | **必須**。動画生成 Pro のジョブです。 |

**戻り値**：処理の確認です。`get_job` でジョブをポーリングしてください。ジョブは、`output_data.pro.stopped` が `true` になった状態で完了し、途中までの動画が結果になります。

## `continue_video_pro`
停止、失敗、または完了した動画生成 Pro の実行を、新しいジョブとして続けます。`from_segment` より前のセグメントは再利用され、`from_segment` 以降のすべてのセグメントが生成し直されます。失敗した実行を続けるには、納品済みのセグメントが 1 つ以上必要です。

**権限**：`workflows:execute`。**クレジット**：生成し直すセグメントの分と、動画生成 Pro の固定料金だけです。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `job_id` | string | **必須**。元の動画生成 Pro のジョブです。 |
| `from_segment` | integer | 生成し直す最初のセグメントです。1 から数え、最大 24 です。デフォルトは、最初の欠けているセグメントです。完了した実行の終わりの部分を作り直すには、それより前のセグメントを指定します。 |

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

## Frequently asked questions

### generate_video は、デフォルトでどのモデルを使いますか？

Seedance 2 Fast です。変更するには、list_models にある別の ID を model に指定します。不明な ID を指定しても、エラーにならずにデフォルトのモデルが使われます。resolution を指定しない場合は、そのモデルで最も低く、最も安い解像度が使われます。

### generate_video と animate_image の違いは何ですか？

generate_video はテキストから動画を作ります。animate_image は静止画から動画を作ります。animate_image は終了フレームも受け取れるので、ある画像から別の画像へと動く動画も作れます。

### MCP でポートレートをしゃべらせるにはどうすればよいですか？

ポートレートまたは顔が映った動画と、オーディオトラックを指定して、lip_sync を呼び出します。デフォルトのモデルは Kling Avatar です。speech_to_video も選択肢の 1 つで、音声クリップに合わせてポートレートを動かします。

### MCP で動画を生成すると、いくらかかりますか？

エディターと同じ料金です。ほとんどの動画モデルは長さと解像度で料金が決まるため、料金を伝える前に list_models でモデルの料金を確認してください。

### Nodaro で作っていない動画を延長できますか？

はい、seedance-2-extend で延長できます。このモデルは、URL または Nodaro の ID で指定したどの動画でも延長します。veo-extend と runway-extend のモデルは、自分が以前に生成した動画の続きしか作れません。