Nodaro ドキュメントRecast
JSON で書いた映画のスクリプトを、レンダリングされた Recast プロジェクトにする 6 つの Recast ツールのパラメーターです。無料の検証、見積もり、キャスティングを扱います。
Nodaro Cloud で利用できます
Recast のツールは、1 つの JSON スクリプトとして書いた映画を、実際の Recast プロジェクトにします。このプロジェクトは Nodaro でレンダリングされ、recast.nodaro.ai で開けます。このページでは、各ツールのパラメーターを説明します。作業の流れとスクリプトの形式は Recast で説明しているので、先に読んでください。
Recast のツールは、Nodaro Cloud にしかありません。
| ツール | 権限 | クレジット |
|---|---|---|
get_recast_authoring_skill | 不要 | 無料 |
validate_recast_script | 不要 | 無料 |
import_recast_script | workflows:write | 無料 |
start_recast | workflows:execute | 見積もりの料金。confirm: true のときだけ |
resolve_recast_gate | workflows:execute | 無料 |
get_recast_status | workflows:read | 無料 |
get_recast_authoring_skill
JSON で書く映画の作成ガイドを返します。ドキュメントの形式（meta、slots、scenes）、各フィールドの意味、使える値、制限、オーディオのルール、検証済みの作例が含まれます。このガイドは、プラットフォーム自体が使うプランナーから生成されます。
このツールにパラメーターはありません。
validate_recast_script
作成したスクリプトを、無料で何度でもチェックします。課金されることはなく、何も保存しません。
| パラメーター | 型 | 説明 |
|---|---|---|
script | object | 必須。作成したスクリプト、またはエクスポートした完全な分析です。 |
戻り値：valid、errors、warnings です。各エラーには、path、message、そして多くの場合 hint があります。エラーを 1 つずつ修正し、valid が true になるまで呼び出しを繰り返します。
import_recast_script
検証済みのスクリプトを、Recast プロジェクトにします。プロジェクトとそのワークフローを作成し、スクリプトを完了済みの分析として保存します。インポートは無料です。
| パラメーター | 型 | 説明 |
|---|---|---|
script | object | 必須。検証済みのスクリプトです。 |
rights_attested | boolean | 必須で、true だけを指定できます。スクリプトがユーザー自身の作品であること、またはユーザーが権利を持っていることを、ユーザーが会話の中で確認した後にだけ設定します。 |
戻り値：recastId、jobId、warnings、そしてプロジェクトへのリンクである appUrl です。
start_recast
インポートした Recast の見積もりを出し、レンダリングします。confirm を付けない場合は、料金だけを返します。ユーザーがその料金を承認した後に confirm: true を付けると、プランとレンダリングを購入します。実行中にもう一度呼び出すと、planned の実行を新たな料金なしでレンダリングに進めるか、進行状況を報告します。
| パラメーター | 型 | 説明 |
|---|---|---|
recast_id | string | 必須。import_recast_script で取得した recastId です。 |
confirm | boolean | ユーザーが見積もりのクレジットを承認した後にだけ、true にします。 |
interactive | boolean | レンダリングの前に、ユーザーがキャストを選べるようにします。要素ごとに 3 つの候補があり、3 つから 1 つを選ぶゲートが開きます。見積もりに追加料金が加わるため、確定する前にユーザーに確認してください。 |
resolution | string | 出力の解像度です。デフォルトは 720p です。 |
segment_pack | string | シーンをパートにまとめる方法です。scenes-max（デフォルト。つなぎ目が最も少なく、最も安価）か scenes（パートが短くなる）です。 |
anchor_mode | string | パートのつなぎ方です。progressive（各パートの開始フレームが、前のレンダリングから続く）か none（フレームによる条件付けなし。見積もりから開始フレームの追加料金がなくなる）です。サーバーのデフォルトを使う場合は省略します。 |
provider | string | 動画モデルを上書きします。サーバーのデフォルトを使う場合は省略します。 |
戻り値：見積もり、または実行の状態です。
resolve_recast_gate
インタラクティブなゲートでのユーザーの選択を記録し、実行を先に進めます。選択そのものは無料です。追加料金は、start_recast で承認済みです。選択肢は、get_recast_status が表示する候補の、0 から始まるインデックスで指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
recast_id | string | 必須。対象の Recast です。 |
picks | object | キャストまたはアイデンティティシートのゲートで使います。各スロットの ID を、選んだ候補のインデックスに対応付けます。 |
gate | string | picks がどのゲートへの回答かを示します。cast（デフォルト）か sheet です。 |
segment, anchor_start, anchor_end | integer | シーンの静止画のゲートで使います。対象のシーンと、選んだ最初と最後のフレームです。 |
section, music_pick | integer | 音楽のゲートで使います。音楽の区間と、選んだテイクです。 |
finish_auto | boolean | このゲートと残りのすべてのゲートを、自動評価で最上位の候補に確定します。そのため、実行は自動で最後まで進みます。 |
ゲートは、キャスト、人物のアイデンティティシート、シーンの静止画、音楽の順に開きます。シートのゲートでは、3 枚のシートが、キャストのゲートで選んだ顔を共有しています。そのため、ここで選ぶのは体型と服装だけです。
get_recast_status
Recast の進行状況を返します。blueprint ready、planning、planned、generating（全体のうち完了したセグメントの数と、リアルタイムのプレビュー付き）、completed（結果の URL 付き）、failed のいずれかです。recast.nodaro.ai のプロジェクトへのリンクが、常に含まれます。MCP Apps を表示できるクライアントでは、リアルタイムのカードが表示されます。カードには、進行状況バー、生成が進むにつれて伸びていくプレビュー、ボタンとして並ぶゲートの候補があります。
| パラメーター | 型 | 説明 |
|---|---|---|
recast_id | string | 必須。対象の Recast です。 |
ステータスが planned の場合は、start_recast をもう一度呼び出して、レンダリングを開始します。
よくある質問
関連ページ
Recast
Recast
スタジオプロダクション
分析と編集リスト
最終更新