# Recast

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

Source: https://nodaro.ai/ja/docs/mcp/recast

**Recast** は、1 回の依頼から完成した動画を作るための、MCP の制作ルートです。アシスタントは、映画を脚本の形をした JSON スクリプトとして書き、無料で検証して、実際の Recast プロジェクトとしてインポートします。このプロジェクトは [recast.nodaro.ai](https://recast.nodaro.ai) で確認でき、そこから再開もできます。レンダリングでは、クレジットを使うたびに、その前に料金が示されます。「X についての動画や映画、広告を作って」のような、最初から最後まで任せる依頼には、このルートを優先してください。キャンバス上のワークフローには、[ワークフローツール](https://nodaro.ai/docs/mcp/tools/projects-and-workflows)か [Film Director](https://nodaro.ai/docs/mcp/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`](https://nodaro.ai/docs/mcp/tools/analysis-and-edl#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_script` | `workflows:write` |
| `start_recast`、`resolve_recast_gate` | `workflows:execute` |
| `get_recast_status` | `workflows:read` |

各ツールのパラメーターは、[ツールリファレンス](https://nodaro.ai/docs/mcp/tools/recast)に記載されています。

## REST API から
同じルートは、REST でも使えます。`POST /v1/video-analysis/import/validate`、`POST /v1/video-analysis/import`、`GET /v1/video-analysis/authoring-skill` を使います。API リファレンスの [Recast](https://nodaro.ai/docs/developers/api/recast) を参照してください。

## Frequently asked questions

### Recast のルートとは何ですか？

AI アシスタントが、1 回の依頼から完成した動画を作るための方法です。アシスタントは脚本の形をした JSON スクリプトを書き、無料で検証し、実際の Recast プロジェクトとしてインポートしてレンダリングします。クレジットを使う前には、必ず料金を示します。

### Recast プロジェクトはどこで見られますか？

recast.nodaro.ai で見られます。ステータスの応答には、毎回そのプロジェクトへのリンクが含まれます。そこにあるフル機能のエディターでは、キャラクターの配役を変えたり、一部をやり直したり、インタラクティブな選択を行ったりできます。

### Recast の長さは、どこまでにできますか？

各シーンは最大 8 秒で、シーンは 0 秒目から隙間なく続きます。映画全体の長さは 4 秒からプラットフォームの実行上限までで、アスペクト比は 16:9 または 9:16 です。

### レンダリング中に会話を離れると、どうなりますか？

何も失われません。実行は実際の Recast プロジェクトなので、アシスタントがいなくても、アプリが実行を再開するか、安全に保留します。

### アシスタントが、スクリプトが自分のものかどうかの確認を求めるのはなぜですか？

作成した Recast は、ブランド名も含めて、書かれたとおりにレンダリングされます。インポートには、スクリプトがあなたの作品であること、または権利を持っていることを、あなた自身が確認する必要があります。アシスタントが、あなたの代わりに確認することは許されていません。