ユーティリティ、レシピ、スキル
ping で接続を確認し、get_recipe で検証済みのレシピを読み込み、映画ディレクターのスキルを開始します。ビルダーツールでは、Web サイトを紹介する UGC 動画を準備できます。
ユーティリティ、レシピ、スキルのツールは、アシスタントがうまく作業を始められるようにします。ping は接続を確認し、get_recipe は検証済みの複数ステップのプレイブックを読み込み、start_film_director は映画ディレクターのスキルを読み込みます。3 つの UGC ビルダーは、Web サイトについてクリエイターが話す動画を準備します。どのツールもメディアを生成せず、クレジットも消費しません。このページには、クレジットを消費するツールがほかに 3 つあります。capture_site は Web ページをスクリーンショットとしてキャプチャし、ugc_split_speech と ugc_finish_clips は UGC 動画の音声を分割し、クリップを仕上げます。
指示を返すほかのツールは、それぞれのグループのページで説明しています。start_workflow_editor と get_node_skill、start_video_director、get_studio_production_skill、get_recast_authoring_skill です。
ping
pong、あなたの Nodaro ユーザー ID、呼び出したクライアントの名前を返します。コネクタが動作しているかを確認するときに使います。
権限:なし(常に表示されます)。クレジット:無料。
このツールにはパラメーターがありません。
get_recipe
コンテンツレシピを一覧表示し、読み込みます。コンテンツレシピは、ナレーション付きのアニメーション解説動画など、複数のツールを使う一連の流れを、アシスタントに最初から最後まで案内する検証済みのプレイブックです。このツールはテキストを返すだけです。レシピが求める操作は、ほかのツールで行います。それぞれのツールには、固有の権限と料金があります。レシピの一覧は、コンテンツレシピを参照してください。
権限:なし(常に表示されます)。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
recipe | string | レシピ名です。たとえば video-explainer です。指定しない場合は、すべてのレシピを一覧表示します。 |
file | string | レシピ内の参照ファイルです。たとえば references/prompts.md です。recipe が必要です。 |
戻り値:引数がない場合は、各レシピの名前、説明、トリガーフレーズです。recipe を指定した場合は、そのレシピの完全な指示です。file を指定した場合は、そのファイルです。不明な名前を指定すると、有効な名前の一覧を含むエラーが返されます。
Nodaro Cloud では、一覧に Web サイト紹介の UGC 動画も含まれます。クリエイターがカメラに向かってサイトについて話し、サイトのスクリーンショットがカードとして表示される動画です。
start_film_director
映画ディレクターのスキルを返します。このスキルは、脚本から最終カットまでの 10 のステージで映画を監督し、その過程でキャンバス上に編集可能なワークフローを構築するよう、アシスタントに指示します。予告編、短編映画、ミュージックビデオ、リール、広告など、複数のショットからなる動画の依頼では、アシスタントは最初にこのツールを呼び出します。映画ディレクターを参照してください。
権限:なし(常に表示されます)。クレジット:無料。Nodaro Cloud のみ。
このツールにはパラメーターがありません。何も変更しません。
capture_site
Web ページを、スマートフォンの幅の実際のスクリーンショットとしてキャプチャします。ページ全体の画像 1 枚と、スマートフォンのカードの形に切り出したセクションの静止画を最大 8 枚返します。ページのセクションのマップ(各セクションの見出し、位置、短いテキスト)と、ページのテキストにある正確な数値も返します。同意のポップアップは非表示にされ、承諾されることはありません。
権限:workflows:execute。クレジット:1 回のキャプチャごとの固定料金です。このツールは、インストールでページのキャプチャが有効になっていて、リンクからのメディアのインポートが許可されている場合にだけ表示されます。
| パラメーター | 型 | 説明 |
|---|---|---|
url | string | 必須。キャプチャするページです。https:// は省略できます。最大 2,048 文字です。 |
max_stills | integer | 返すセクションの静止画の最大数で、3〜8 です。デフォルトは 8 です。 |
client_request_id | string | 再試行用のトークンで、英字、数字、_ - . : からなる 8〜128 文字です。タイムアウトの後に再試行するときは、同じ値を使います。そうすれば、キャプチャの開始や課金が 2 回行われることはありません。 |
戻り値:ジョブ ID です。静止画は wait_for_job の outputData.stills から読み取ります。それぞれに assetId と url があります。静止画はメディアに保存されますが、保存するまではピッカーに表示されません。静止画はストレージの容量を使います。
自動の訪問者をブロックするページや、空で返ってくるページは失敗し、クレジットが返還されます。robots.txt がキャプチャを許可していないページは、何も実行される前に拒否されます。
UGC 動画ビルダー
Web サイト紹介の UGC 動画のレシピで使う、3 つの無料のヘルパーです。これらは何も生成しません。それぞれが自分の担当部分をチェックまたは準備し、次に行う生成の呼び出しの引数を正確に返します。ほかの 2 つのツール、ugc_split_speech と ugc_finish_clips は、同じレシピの音声と動画の作業を、1 回の呼び出しごとの固定料金で行います。5 つとも Nodaro Cloud でのみ使え、権限は不要です。ただし、保存したキャラクターを使う build_ugc_creator には、assets:read が必要です。
build_ugc_creator
カメラに向かって話すクリエイターを準備します。新しくサンプリングした人物、保存したキャラクターのいずれか、または自分の写真から選べます。
| パラメーター | 型 | 説明 |
|---|---|---|
source | string | 必須。sampled、character、photo のいずれかです。 |
character_id | string | character の場合に使う、保存したキャラクターです。 |
photo_url | string | photo の場合に使う、自分の写真です。 |
gender | string | woman または man です。 |
product_category, overrides, previous, seed | サンプリングしたクリエイターを調整したり、同じクリエイターを再現したりするための、任意の詳細設定です。 |
戻り値:クリエイターのアイデンティティ画像、または、次に実行する画像生成の正確な引数です。サンプリングしたクリエイターの場合は、候補ごとに 1 枚の画像なので、ユーザーはその中から 1 人を選べます。
build_ugc_clips
(Nodaro Cloud のみ)UGC 動画の台本をチェックします。すべての問題が、それぞれの修正方法とともに一度に返されます。そして、クリップごとに 1 つの generate_video 呼び出し、それらをつなぐ呼び出し、動画の残りの部分のクレジット見積もりを返します。台本は英語またはヘブライ語で書けます。ヘブライ語の台本には 2 段階で答えます。最初の呼び出しでは、録音する音声とその分け方が見積もりとともに返されます。ugc_split_speech の segments を渡してもう一度呼び出すと、セグメントごとに 1 つの generate_video 呼び出しが返されます。権限は不要で、無料です。UGC Web サイトのレシピ(get_recipe)で使われます。
| パラメーター | 型 | 説明 |
|---|---|---|
plan | object | 必須。台本です。 |
gender | string | 必須。woman または man です。 |
identity_images | array | 必須。クリエイターの画像で、1 枚または 2 枚です。 |
traits, seed | 任意です。 | |
spent_job_ids | array | この動画のためにすでに実行したジョブです。見積もりでは、消費済みとして記載されます。最大 64 件です。 |
segments | array | ugc_split_speech の出力にあるセグメントです。最初の呼び出しへの応答で求められた場合に渡します。最初の呼び出しでは省略します。最大 8 件です。 |
speech_lane | string | 英語のみです。reference-audio(デフォルト):音声が台本を話し、動画モデルがそれを演じます。prompt-quoted:動画モデルが自分の声でセリフを読みます。 |
voice_id | string | 英語のみです。reference-audio レーンの音声で、プリセット音声の名前、または list_voices の ID です。ビルダーがクリエイターに選ぶ音声の代わりに使われます。 |
戻り値:クリップごとの、すぐに実行できる generate_video の呼び出し、クリップをつなぐ呼び出し、動画の残りの部分のクレジットの見積もりです。見積もりの行に estimate: true が付いている場合、それは従量課金の LLM 呼び出し、つまりスクリーンショットを読み取る画像からテキストへの呼び出しの見積もりです。この呼び出しは、実際に使ったトークンに応じて課金されます。その場合、見積もりには totalIsEstimate: true が付くので、合計は ≈N と表示してください。料金のないモデルは、llm_model_unpriced で拒否されます。
build_ugc_cards
単語のタイミングから、UGC 動画のスクリーンショットカードと字幕のタイミングを決めます。
| パラメーター | 型 | 説明 |
|---|---|---|
plan | object | 必須。台本です。 |
alignment または words | array | 単語のタイミングです。forced_alignment または transcribe から取得します。 |
video_duration_ms | number | 動画の長さです。 |
caption_style | string | 最初のセリフの後の字幕の見た目です。body-captions(単語ごと、デフォルト)、karaoke、clean-subtitles、none のいずれかです。最初のセリフは、常にプレートを保ちます。 |
戻り値:overlay_images 用のレイヤーと、add_captions 用の字幕セグメントです。
ugc_split_speech
UGC 動画の録音された音声を、音声自身の間で区切ってセグメントに分けます。各セグメントは、前後に短い無音を付けたオーディオファイルとして保存されます。
クレジット:1 回の呼び出しごとの固定料金です。
| パラメーター | 型 | 説明 |
|---|---|---|
plan | object | 必須。台本です。 |
audio_url または audio_asset_id | string | 音声です。URL、または Nodaro のジョブ ID かアップロード ID で指定します。 |
alignment | array | 必須。音声の単語のタイミングで、{ word, start, end } の項目が 1〜2,000 件です。 |
戻り値:セグメントを一覧表示する出力を持つジョブです。build_ugc_clips の segments パラメーターに使います。
ugc_finish_clips
レンダリングした各クリップを、渡されたオーディオと照合し、そのオリジナルのオーディオをクリップに付け、単語の間の無音を詰めて、仕上がったクリップを順番に返します。クリップがオーディオと一致しない場合は、レンダリングし直すクリップを示し、何も変更しません。
クレジット:1 回の呼び出しごとの固定料金です。
| パラメーター | 型 | 説明 |
|---|---|---|
segments | array | 必須。ugc_split_speech のセグメントで、1〜8 件です。 |
clips | array | 必須。1〜8 件です。各項目には、clip(1〜8 の番号)と、レンダリングした動画の video_url または video_asset_id があります。reroll_video_url または reroll_video_asset_id は、レンダリングし直したクリップです。 |
セグメントで作られるヘブライ語の動画では、このツールは各クリップに、その場所の音も付けます。場所に合わせたリバーブ、-16 LUFS のレベル、その下のルームトーンです。屋外、車内、ホールの場所では、リバーブとレベルは付きますが、ルームトーンは付きません。この手順が失敗した場合、クリップはこの処理なしで、警告とともに返されます。
戻り値:仕上がったクリップを順番に一覧表示する出力を持つジョブです。
よくある質問
アシスタントが Nodaro に接続されていることを確認するにはどうすればよいですか?
ping を呼び出すよう、アシスタントに依頼してください。このツールは、pong、あなたの Nodaro ユーザー ID、クライアントの名前を返します。権限は必要ありません。
get_recipe は何を返しますか?
メディアではなく、指示を返します。引数を指定しない場合は、レシピの一覧を、説明とトリガーフレーズとともに返します。レシピ名を指定すると、そのレシピの完全なプレイブックを返します。アシスタントは、ほかのツールを使ってそのプレイブックに従います。
UGC ビルダーのツールは動画を生成しますか?
いいえ。これらは、Web サイト紹介の UGC 動画のレシピで使う無料のヘルパーです。クリエイターを準備し、台本をチェックし、カードと字幕のタイミングを決めます。そして、次に行う呼び出しを、クレジットの見積もりとともに正確に返します。ほかの 2 つのツール、ugc_split_speech と ugc_finish_clips は、1 回の呼び出しごとの固定料金で、音声を分割し、クリップを仕上げます。
関連ページ
コンテンツレシピ
映画ディレクター
MCP ツールリファレンス
トラブルシューティング
最終更新