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

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

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

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

ツール権限クレジット
start_video_director不要無料
create_explainerworkflows:execute脚本作成の実行、ナレーション、レンダリング。ナレーションに単語のタイミングがない場合は、強制アライメントも加わります。Nodaro Cloud のみ。
create_launch_videoworkflows:executecreate_explainer と同じ。Nodaro Cloud のみ。
list_shot_shapes不要無料
get_shot_shape不要無料
list_brand_presets不要無料
forced_alignmentworkflows:execute33
resolve_shot_sequenceworkflows:execute無料。ジョブなし
render_shot_sequenceworkflows:execute55

start_video_director

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

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

create_explainer

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

権限:workflows:execute。クレジット:脚本作成の実行に、ナレーションとレンダリングを加えた料金です。ナレーションに単語のタイミングがない場合は、強制アライメントの料金も加わります。脚本作成の料金は、list_models の video-director に記載されています。Nodaro Cloud のみ。

パラメーター型説明
topicstring必須。解説動画で伝える内容で、1〜8,000 文字です。
brandstring または objectcobalt-corporate のようなブランドプリセットの ID か、独自のブランドトークンです。下記を参照してください。

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

create_explainer と create_launch_video は、デプロイメントが動画ディレクター(nodes.allow と nodes.deny のリストにある利用可否の ID video-director)を提供していない場合、一覧に表示されません。それでも届いた呼び出しは、何かを確保する前に 403 node_not_available で拒否されます。音声、アライメント、レンダリングの各ステップは、それぞれ独自のノード text-to-speech、forced-alignment、render-video として確認されます。

create_launch_video

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

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

パラメーター型説明
briefstring製品の説明です。製品の内容、対象となる人、主な機能、トーンを書きます。1〜8,000 文字です。
brandstring または objectcreate_explainer と同じです。
urlstringキャプチャする製品の 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 スキーマ、そしてブリーフにそのまま貼り付けられる記入済みの例です。

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

list_brand_presets

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

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

forced_alignment

内容がわかっている文字起こしを、オーディオまたは動画のクリップに合わせ、すべての単語の開始時間と終了時間を返します。動画の場合は先に音声トラックが抽出されるため、人物が話しているクリップもそのままアライメントできます。強制アライメントノードと同じように動作します。

権限:workflows:execute。クレジット:33。

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

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

resolve_shot_sequence

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

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

パラメーター型説明
briefobject必須。ショットシーケンスのブリーフです。ナレーション、シーン、ショット、リビールを含みます。
audio_urlstring必須。ナレーションのオーディオです。
alignmentarray必須。forced_alignment の output_data.alignment です。

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

render_shot_sequence

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

権限:workflows:execute。クレジット:動画レンダリングノードと同じです。フレームサイズにかかわらず、55 です。

パラメーター型説明
planobject必須。resolve_shot_sequence で取得したプランです。

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

よくある質問

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 つのツールも、クレジットを使います。

最終更新

目次