# Recast

> JSON で書いた映画のスクリプトを、レンダリングされた Recast プロジェクトにする 6 つの Recast ツールのパラメーターです。無料の検証、見積もり、キャスティングを扱います。

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

**Recast のツール**は、1 つの JSON スクリプトとして書いた映画を、実際の Recast プロジェクトにします。このプロジェクトは Nodaro でレンダリングされ、[recast.nodaro.ai](https://recast.nodaro.ai) で開けます。このページでは、各ツールのパラメーターを説明します。作業の流れとスクリプトの形式は [Recast](https://nodaro.ai/docs/mcp/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` をもう一度呼び出して、レンダリングを開始します。

## Frequently asked questions

### Recast のスクリプトの検証やインポートに、クレジットはかかりますか？

いいえ。validate_recast_script と import_recast_script は無料です。クレジットが使われるのは、ユーザーが見積もりの料金を承認した後に、confirm を true にして start_recast を呼び出したときだけです。

### rights_attested は何を意味しますか？

スクリプトがユーザー自身の作品であること、またはユーザーが権利を持っていることを、ユーザーが会話の中で確認したという記録です。作成した Recast は、ブランド名も含めて、書かれたとおりにレンダリングされます。そのため、アシスタントは、ユーザーに確認せずにこの値を設定してはいけません。

### ユーザーは、レンダリングの前にキャストを選べますか？

はい。interactive を true にして実行を開始します。実行は、キャスト、アイデンティティシート、シーンの静止画、音楽の各ゲートで一時停止し、ユーザーは 3 つの候補から 1 つを選びます。インタラクティブモードには追加料金がかかり、その分は見積もりに含まれます。

### ユーザーは、Recast をどこで確認、編集できますか？

recast.nodaro.ai で確認、編集できます。get_recast_status は、常にプロジェクトへのディープリンクを返します。プロジェクトでは、キャストの差し替え、撮り直し、インタラクティブな選択ができます。