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

Recast

AI アシスタントに映画を JSON のスクリプトとして書かせ、無料で検証し、Recast プロジェクトとしてインポートします。見積もられた料金を承認すると、レンダリングされます。

Nodaro Cloud で利用できます

Recast は、1 回の依頼から完成した動画を作るための、MCP の制作ルートです。アシスタントは、映画を脚本の形をした JSON スクリプトとして書き、無料で検証して、実際の Recast プロジェクトとしてインポートします。このプロジェクトは recast.nodaro.ai で確認でき、そこから再開もできます。レンダリングでは、クレジットを使うたびに、その前に料金が示されます。「X についての動画や映画、広告を作って」のような、最初から最後まで任せる依頼には、このルートを優先してください。キャンバス上のワークフローには、ワークフローツールか Film Director を使います。Recast は Nodaro Cloud の機能です。

作業の流れ

作成ガイドを読む

get_recast_authoring_skill は、スクリプト形式のガイドを返します。このガイドは、プラットフォーム自体が使うプランナーから生成されています。ドキュメントの形式、各フィールドの意味、使える値、制限、オーディオのルール、検証済みの作例が含まれます。無料です。

必要なだけ検証する

validate_recast_script は、スクリプトを無料でチェックします。各エラーを、その path の箇所で hint に従って修正し、valid が true になるまで繰り返します。

インポートする

import_recast_script は、Recast プロジェクトとそのワークフローを作成し、スクリプトを完了済みの分析として保存します。無料です。rights_attested: true が必要で、この値は、スクリプトがあなたの作品であることを、あなた自身が会話の中で確認したことを反映していなければなりません。recastId とプロジェクトのリンクが返されます。

見積もってからレンダリングする

confirm を付けない start_recast は、クレジットの見積もりだけを返します。あなたが料金を承認すると、アシスタントは confirm: true を付けてもう一度呼び出します。レンダリングはサーバー上で実行されます。ステータスが planned になったときに start_recast をもう一度呼び出すと、新たな料金なしで、実行がレンダリングに進みます。

レンダリングの進行を確認する

get_recast_status は、planning、planned、generating(全体のうち完了したパーツの数と、リアルタイムのプレビュー付き)、completed(結果の URL 付き)、failed のいずれかを報告し、常にプロジェクトへのリンクを含みます。MCP Apps を表示できるクライアントでは、進行状況バー、生成が進むにつれて伸びていくプレビュー、インタラクティブな選択肢のボタンを備えた、リアルタイムのカードが表示されます。

スクリプト

スクリプトは、meta、繰り返し登場する人物、物、場所のための slots、そして scenes の 3 つの部分でできています。基準になるのは作成ガイドです。アシスタントが最もよく必要とするルールは、次のとおりです。

  • visual は、シーンの画像を生成するプロンプトです。camera はカメラの動きだけを表します。shotType は、決まった値のリストから選びます。
  • 各シーンは最大 8 秒で、0 秒目から隙間なく続きます。映画全体の長さは、4 秒からプラットフォームの実行上限までです。
  • アスペクト比は、"16:9" または "9:16" です。
  • 歌われる歌詞は music レイヤーに入れます。speech には入れません。music レイヤーのないシーンは無音になります。

バリデーターは、video_analysis からエクスポートした完全な分析も受け付けます。この分析も、同じシーンごとの構造を持っています。

権利と忠実なレンダリング

作成した Recast は忠実にレンダリングされます。つまり、ブランド名も含めて、書かれたとおりにレンダリングされます。そのため、インポートには rights_attested: true が必要で、この値は、スクリプトがあなたの作品であること、または権利を持っていることを、あなた自身が明示的に確認したことに基づいていなければなりません。アシスタントは、あなたの代わりにこの値を設定してはいけません。

キャストを自分で選ぶ

レンダリングの前に自分で選ぶには、interactive: true を付けて実行を開始します。インタラクティブモードには追加料金がかかり、その分も見積もりに含まれます。実行は、ゲートごとに一時停止します。get_recast_status が候補を表示し、resolve_recast_gate が各選択を無料で記録して、実行を先に進めます。ゲートは、次の順番で開きます。

  1. キャスト:各要素のポートレートを、3 つの候補から 1 つ選びます。
  2. アイデンティティシート:人物について、実行で提示された場合に選びます。3 枚のシートはどれも選んだ顔を共有しているため、ここでの選択は、体型と服装についてです。
  3. シーンの静止画:各シーンの最初と最後のフレームを選びます。
  4. 音楽:音楽の区間ごとに、テイクを選びます。

finish_auto: true を指定すると、残りのすべてのゲートが、自動評価で最上位の候補に確定されます。誰も最後まで進めなかったインタラクティブな実行は、安全に保留され、期限が来ると自動で確定されます。

権限

ツール権限
get_recast_authoring_skill、validate_recast_scriptなし
import_recast_scriptworkflows:write
start_recast、resolve_recast_gateworkflows:execute
get_recast_statusworkflows:read

各ツールのパラメーターは、ツールリファレンスに記載されています。

REST API から

同じルートは、REST でも使えます。POST /v1/video-analysis/import/validate、POST /v1/video-analysis/import、GET /v1/video-analysis/authoring-skill を使います。API リファレンスの Recast を参照してください。

よくある質問

最終更新

目次