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

パイプライン

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

Nodaro Cloud で利用できます

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

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

ステージ

パイプラインは、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

パイプラインの状態を返します。ステータス(pending、running、awaiting_approval、completed、failed)、現在のステージ、クレジットのカウンター、モード、そして失敗した場合は 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 です。

よくある質問

最終更新

目次