Nodaro ドキュメントショットシーケンスと動画ディレクター
1 回の呼び出しでナレーション付きのモーショングラフィックス動画を作る動画ディレクターのツールと、ナレーションに合わせてリビールのタイミングを決めるショットシーケンスのツールのパラメーターです。
動画ディレクターとショットシーケンスのツールは、ナレーション付きのモーショングラフィックス動画を作ります。キネティックタイポグラフィ、図形、画像が、ナレーションで対応するフレーズが話された瞬間に現れます。動画ディレクターのツールは 1 回の呼び出しで動画を作り、ショットシーケンスのツールでは各ステップを個別に実行できます。このページでは、パラメーターを説明します。使い方は、動画ディレクターとショットシーケンスで説明しています。
| ツール | 権限 | クレジット |
|---|---|---|
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）ノードと同じように動作します。
権限：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）ノードと同じです。長辺が 1920 ピクセルまでは 50 です。
| パラメーター | 型 | 説明 |
|---|---|---|
plan | object | 必須。resolve_shot_sequence で取得したプランです。 |
戻り値：ジョブ ID です。カードに進行状況が表示され、動画が再生されます。
よくある質問
関連ページ
動画ディレクター
ショットシーケンス
オーディオ
強制アライメント
最終更新