NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
ツールリファレンス

パイプライン

MCP ツールで、プロンプトから「ストーリー → 動画」のパイプラインを開始し、ステージを監視して、チャットで承認や調整を行い、完了したパイプラインを任意のステージから分岐します。

Nodaro Cloud で利用できます

パイプラインツールを使うと、AI アシスタントからストーリー → 動画のパイプラインを操作できます。1 つのプロンプトでパイプラインが始まります。パイプラインは脚本を書き、キャストとロケーションを作成し、ショットを計画してレンダリングし、完成した映画に結合します。アシスタントは、ステージの監視、承認、チャットでの調整を行い、完了したパイプラインを任意のステージから分岐できます。同じエンジンをキャンバスで使うのが、ストーリー → 動画ノードです。

パイプラインツールは、Nodaro Cloud にしかありません。pipelines:read、pipelines:execute、pipelines:approve の権限を許可した場合にだけ表示されます。

start_pipeline、branch_pipeline、chat_pipeline_stage、apply_chat_proposal は、パイプラインの作業を開始または続行します。デプロイメントが映画パイプライン(nodes.allow と nodes.deny のリストにある利用可否の ID film-pipeline)を提供していない場合、これらは一覧に表示されません。エディションとプロファイルを参照してください。それでも届いた呼び出しは、何かを確保する前に 403 node_not_available で拒否されます。読み取りのツールは引き続き一覧に表示されるので、以前に作ったパイプラインは引き続き確認できます。

ステージ

パイプラインは、script、characters、objects、locations、shot_list、scene_images、animate_audio_edit、post_merge の順にステージを実行します。auto モードでは、すべてのステージを自動で実行し、停止するのは、2 つのショットの間で計画したマッチカットが成立しない場合だけです。その場合、実行は、すべての不連続が REST API で承認されるまで待機します。MCP ツールで不連続を承認することはできません。manual モードと guided モードでは承認ゲートで停止し、そのステージは awaiting_approval のステータスで待機します。

start_pipeline

ストーリーのプロンプトから、新しい「ストーリー → 動画」のパイプラインを開始します。

権限:pipelines:execute。クレジット:パイプラインが実行するすべての生成のクレジットです。get_pipeline_status で、進行に合わせてクレジットを確認できます。

パラメーター型説明
story_promptstring必須。映画の内容で、最大 4,000 文字です。
formatstringtrailer、short_film、music_video、reel、commercial のいずれかです。デフォルトは reel です。
target_duration_secondsinteger映画の長さで、5〜600 秒です。デフォルトは 15 です。
modestringauto(デフォルト)は、マッチカットの不連続があるときを除き、人の操作なしで最後まで実行します。manual と guided は、承認ゲートで停止します。
output_resolutionstring480p、720p、1080p、4K のいずれかです。デフォルトは 720p です。
music_enabledboolean音楽を追加します。デフォルトは true です。
narration_enabledbooleanナレーションを追加します。デフォルトは false です。
lipsync_enabledbooleanキャラクターの唇の動きを、セリフに合わせます。デフォルトは false です。

戻り値:新しいパイプラインの ID です。get_pipeline_status をポーリングし、ステージが待機している間は pipeline_pending_approvals もポーリングします。

アシスタントがパイプラインを開始する場合、ナレーションとリップシンクはデフォルトでオフです。そのため、人の操作なしで実行しても、依頼しない限り、これらにクレジットは使われません。

get_pipeline_status

パイプラインの状態を返します。ステータス(queued、running、awaiting_approval、completed、failed、cancelled、forked)、現在のステージ、クレジットのカウンター、モード、そして失敗した場合は failure_reason です。

権限:pipelines:read。クレジット:無料。

パラメーター型説明
pipeline_idstring必須。パイプラインの ID です。

pipeline_pending_approvals

承認を待っているステージを、それぞれの出力のスナップショットとともに一覧表示します。一覧が空の場合、待っているステージはありません。実行が auto モードでマッチカットの不連続がないか、まだ生成中です。

権限:pipelines:read。クレジット:無料。

パラメーター型説明
pipeline_idstring必須。パイプラインの ID です。

chat_pipeline_stage

承認待ちのステージについて、調整を担当する監督にメッセージを送ります。たとえば「結末をもっと暗くして」と送ります。パイプラインは guided モードである必要があります。

権限:pipelines:approve。

パラメーター型説明
pipeline_idstring必須。パイプラインの ID です。
stagestring必須。待機しているステージで、script か post_merge です。
messagestring必須。送るメッセージで、最大 8,000 文字です。

戻り値:監督の返信です。監督が編集を提案した場合は、proposed_change も返されます。変更は apply_chat_proposal で適用します。

apply_chat_proposal

監督の返信で提案された変更を受け入れ、その変更を適用してステージを承認します。

権限:pipelines:approve。クレジット:無料。

パラメーター型説明
pipeline_idstring必須。パイプラインの ID です。
stagestring必須。チャットのステージです。
turn_idstring必須。受け入れる変更を提案した、監督の返信の ID です。

get_pipeline_stage_chat

ステージのチャットのメッセージを、古い順に一覧表示します。まだ誰も書き込んでいない場合、一覧は空です。

権限:pipelines:read。クレジット:無料。

パラメーター型説明
pipeline_idstring必須。パイプラインの ID です。
stagestring必須。チャットのステージです。

branch_pipeline

完了したパイプラインを、あるステージから再実行する新しいパイプラインを作成します。そのステージより前のステージと、そこで作られたキャラクター、オブジェクト、ロケーションは、承認済みとしてコピーされます。選んだステージとそれ以降のすべてのステージは、もう一度実行されます。

権限:pipelines:execute。クレジット:もう一度実行されるステージのクレジットです。

パラメーター型説明
pipeline_idstring必須。ステータスが completed のパイプラインです。
from_stagestring必須。script、characters、objects、locations、shot_list、scene_images、animate_audio_edit、post_merge のいずれかです。

戻り値:新しいパイプラインの ID です。

よくある質問

「ストーリー → 動画」のパイプラインでは、何が作られますか?

1 つのストーリーのプロンプトから、完成した映画が作られます。パイプラインは脚本を書き、キャラクター、オブジェクト、ロケーションを作成し、ショットを計画します。続いてシーン画像を生成し、オーディオ付きで動画化して、最終カットを結合します。

auto、manual、guided の各モードの違いは何ですか?

auto は、プロンプトから完成した映画まで、自動で実行します。停止するのは、2 つのショットの間で計画したマッチカットが成立しない場合だけで、REST API ですべての不連続が承認されるまで待機します。MCP ツールで不連続を承認することはできません。manual と guided は、承認ゲートで停止します。guided では、承認する前に、脚本と最終カットをチャットで調整することもできます。

パイプラインを途中から再実行できますか?

はい、パイプラインが完了していればできます。branch_pipeline は、選んだステージより前のステージを承認済みとしてコピーします。そして、選んだステージとそれ以降のすべてのステージを、新しいパイプラインとしてもう一度実行します。

アシスタントにパイプラインツールが表示されないのはなぜですか?

パイプラインツールには pipelines の権限が必要です。また、これらのツールは Nodaro Cloud にしかありません。接続し直し、同意画面でパイプラインの権限を許可してください。

最終更新

目次