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

コンテンツレシピ

コンテンツレシピは、アニメーションの解説動画など、Nodaro での一連の流れを AI アシスタントに案内する検証済みのプレイブックです。get_recipe で読み込みます。

コンテンツレシピは、1 つの成果物に向けた Nodaro での一連の流れを、最初から最後まで AI アシスタントに案内する、検証済みのプレイブックです。たとえば video-explainer レシピでは、アシスタントはビジュアルスタイルを固定し、ナレーションを書き、無音のクリップをレンダリングし、それに音声を付けて、assemble_narrated_video で仕上げます。アシスタントは get_recipe でレシピを読み込み、ツールの呼び出しを 1 つずつ、レシピどおりに進めます。

レシピの仕組み

get_recipe が返すのは、テキストだけです。start_workflow_editor や start_video_director と同じように、ほかのツールを呼び出すことも、何かを変更することもありません。generate_video、generate_speech、assemble_narrated_video など、レシピが求める操作は、通常のツール呼び出しです。それぞれに固有の権限が必要で、それぞれにクレジットがかかります。

このツールは、どのエディションでも権限が不要で、料金もかかりません。次の 3 種類の呼び出しに応答します。

呼び出し返されるもの
引数なしの get_recipeカタログです。各レシピの名前、説明、トリガーフレーズが含まれます。
recipe を指定した get_recipeそのレシピの完全な指示です。たとえば recipe: "video-explainer" と指定します。
recipe と file を指定した get_recipeレシピに同梱された参照ファイルです。たとえば file: "references/prompts.md" と指定します。

存在しないレシピやファイルを指定すると、有効なレシピ名の一覧を含むエラーが返されます。

カタログ

レシピ作れるものトリガーの例
camera-coverage1 枚のリファレンスフレームから作る、1 つのシーンの、編集でつなげられる 10 のカメラアングルです。クレジットを使う前に、編集できるショットリストを承認します。1 つの画像ノードが、すべてのショットにファンアウトします。「カメラカバレッジ」「ショットリスト」「同じシーンを別のアングルで」
image-editing-levers1 枚の高解像度画像の、並列の編集です。正確なテキストの指示、ピッカーで設定するルック、ライティングを合わせた背景の差し替え、任意の講評、コンタクトシートを含みます。「この画像を編集して」「ジャケットの色を変えて」「背景を削除して」
infinite-zoom複数の生成クリップをまたいで途切れずに続く、1 つのプッシュインです。各クリップは細部の中で終わり、次のクリップはその細部から始まり、フレーム単位でつながります。生成のクレジットを使わない、静止画のズーム版もあります。「無限ズーム」「エンドレスズーム」「細部にズームイン」
instagram-carousel1 つのアイデアから作る、完成した Instagram のカルーセルです。スライドごとに 1 枚ずつの、テキストを画像内に入れた 9:16 の画像と、導入テキスト、キャプションからなります。「インスタのカルーセル」「カルーセル投稿」「これをカルーセルにして」
multi-reference-control最大 5 つのリファレンスから構成する、1 枚の画像です。人物、衣服、場所など、リファレンスごとに異なる要素を取り入れます。「複数のリファレンスを組み合わせて」「ジャケットはこの画像から」
one-character-any-sceneリファレンストークンを使い、マスクやモデルの学習なしで、同じ人物をあらゆるシーン、衣装、背景に配置します。「同じキャラクターを別のシーンに」「背景はそのままで人物を変えて」
person-node-basics文章ではなく、年齢、体格、目、髪などの人物(Person)ピッカーの属性で作る、デザインされたキャラクターです。「人物を作って」「キャラクターの見た目をデザインして」「特定の顔」
podcast-editing長い収録を、文字起こしをもとに間を詰めるか、短いクリップのセットに切り分けます。apply_edl でレンダリングする前に調整できる、編集リストを使います。「ポッドキャストを編集して」「この収録を整えて」「切り抜きクリップのセット」
product-photoshoot1 枚の商品画像から作る、9 種類の広告スタイルによる完全な広告キャンペーンです。自分の商品写真から作るか、ルックのリファレンスを自分の商品向けに書き換えて作ります。「商品撮影」「自分の商品の広告」
scene-chain-reel複数のシーンから作る、シネマティックな縦型のリール動画です。まず、連続性のためにリファレンスをつなげながら静止画を作ります。すべてのフレームに 1 つのモーションプロンプトを使い、1 つの BGM を付けてから、トリミングとフォーマット調整を行います。「シネマティックなリール」「インスタのリール」「複数シーンの動画」
song-from-reference既存の曲に似た曲です。他人の曲は分析して、オリジナルの曲にします。Suno のカバーは、自分が権利を持つオーディオからだけ作ります。「似た曲」「この曲をカバーして」「このリンクから曲を作って」
suno-music-basicsジャンル、ムード、楽器編成、声など、音楽のピッカーを重ねてスタイルを決めた、曲やインストゥルメンタルです。「曲を作って」「インストゥルメンタルの曲」「動画用の音楽」
video-explainerナレーション付きの、フォトリアルではないアニメーションの解説動画です。固定した 1 つのビジュアルスタイル、無音のクリップとしてレンダリングした複数のナレーションブロック、1 つの声からなり、assemble_narrated_video で組み立てます。「解説動画」「アニメーションの解説動画」「仕組みを説明する動画」

Nodaro Cloud では、カタログに UGC の Web サイト動画も含まれます。クリエイターがカメラに向かって Web サイトについて話し、そのサイトのスクリーンショットがカードとして表示される動画です。このレシピは、UGC ビルダーのツールを使います。

アニメーション映像か、モーショングラフィックスか

Nodaro は、2 つの方法で解説動画を作れます。video-explainer レシピは、何よりも先に、どちらにするかを尋ねます。

video-explainer レシピ動画ディレクター
映像生成したアニメーション映像、イラストのシーンキネティックタイポグラフィ、図形、画像
進め方アシスタントがすべてのステップを実行し、各クリップと音声のテイクを確認できるcreate_explainer の 1 回の呼び出し、またはショットシーケンスのパイプラインを 1 ステップずつ
コスト10 秒のブロックごとの生成の料金で、長さに応じて増える動画 1 本あたり、決まった一連のステップの料金

モーショングラフィックスを選ぶと、レシピはそこで止まり、start_video_director に引き継ぎます。依頼の中ですでにスタイルが指定されている場合、レシピはこの質問を省略します。

自分のインスタンスにレシピを追加する

セルフホスティング環境と、公開リポジトリへのコントリビューションでは、レシピはバックエンドの skills/recipes ディレクトリにある、RECIPE.md ファイルを含むフォルダーです。レシピが file で読み込むファイル用に、references フォルダーを置くこともできます。サーバーは、起動時にカタログを読み込みます。

skills/recipes/my-recipe/
  RECIPE.md
  references/
    prompts.md

RECIPE.md は YAML フロントマターで始まり、その後に、アシスタントが受け取る指示が続きます。指示は、直接的なブリーフとして書きます。まずルール、次にフェーズを書き、ツール名とパラメーターは正確に記載します。

---
name: my-recipe
description: One line shown in the catalog
triggers: ["phrase one", "phrase two"]
version: 1
---

# My recipe

You are producing ONE ...
フィールド必須説明
nameはいフォルダー名と一致させます。get_recipe が読み込むのはフォルダー名で、2 つが一致しているかどうかはチェックされません。
descriptionはいカタログに表示する、1 行の説明です。
triggersはいユーザーが言いそうなフレーズです。フレーズの中にカンマを入れないでください。リストは、カンマで分割されます。
versionいいえ指示を大きく変えたときに上げる数値です。

フォルダー名は、ケバブケース(小文字、数字、ハイフン)にする必要があります。フィールドが欠けているレシピはカタログから除外されますが、ほかのレシピには影響しません。参照ファイルは、そのレシピ自身のフォルダー内からしか読み込めません。レシピをテストするには、まず引数なしで get_recipe を呼び出します。次にレシピの名前を指定して呼び出し、さらに各参照ファイルを指定して呼び出します。

よくある質問

最終更新

目次