Nodaro DocsRecast
Parameters of the six recast tools that turn a movie script written as JSON into a rendered recast project, with free validation, a quote and casting.
Available on Nodaro Cloud
The recast tools turn a movie written as one JSON script into a real recast project that renders on Nodaro and opens at recast.nodaro.ai. This page lists each tool's parameters. Recast explains the loop and the script format; read it first.
The recast tools exist only on Nodaro Cloud.
| Tool | Permission | Credits |
|---|---|---|
get_recast_authoring_skill | none | Free |
validate_recast_script | none | Free |
import_recast_script | workflows:write | Free |
start_recast | workflows:execute | The quoted price, only with confirm: true |
resolve_recast_gate | workflows:execute | Free |
get_recast_status | workflows:read | Free |
get_recast_authoring_skill
Returns the authoring guide for a movie written as JSON: the document format (meta, slots, scenes), what each field means, the allowed values, the limits, the audio rules and a validated worked example. The guide is generated from the planner the platform itself uses.
This tool has no parameters.
validate_recast_script
Checks an authored script, free, as many times as you need. It never charges and saves nothing.
| Parameter | Type | Notes |
|---|---|---|
script | object | Required. The authored script, or a full exported analysis. |
Returns: valid, errors and warnings. Each error has a path, a message and usually a hint. Fix each one and call again until valid is true.
import_recast_script
Turns a validated script into a recast project: it creates the project and its workflow, and stores the script as a completed analysis. Importing is free.
| Parameter | Type | Notes |
|---|---|---|
script | object | Required. The validated script. |
rights_attested | boolean | Required, and only true. Set it only after the user confirmed in the conversation that the script is their own work or that they hold the rights. |
Returns: recastId, jobId, warnings and appUrl, the link to the project.
start_recast
Quotes and renders an imported recast. Without confirm, it returns only the price. With confirm: true, after the user accepted that price, it buys the plan and the render. Called again while a run is in progress, it moves a planned run to rendering at no new charge, or reports the progress.
| Parameter | Type | Notes |
|---|---|---|
recast_id | string | Required. The recastId from import_recast_script. |
confirm | boolean | true only after the user accepted the quoted credits. |
interactive | boolean | Lets the user choose the cast before the render: 3 candidates per element and a pick-one-of-three gate. It adds a surcharge to the quote, so ask before you confirm. |
resolution | string | The output resolution. Default 720p. |
segment_pack | string | How scenes are grouped into parts: scenes-max (default, the fewest joins and the cheapest) or scenes (shorter parts). |
anchor_mode | string | How parts connect: progressive (each part's start frame follows from the previous render) or none (no frame conditioning; the quote drops the start-frame surcharge). Leave it out for the server default. |
provider | string | A video model override. Leave it out for the server default. |
Returns: the quote, or the state of the run.
resolve_recast_gate
Records the user's choice at an interactive gate and moves the run on. The choice itself is free: the surcharge was accepted with start_recast. Options are 0-based indexes into the candidates that get_recast_status shows.
| Parameter | Type | Notes |
|---|---|---|
recast_id | string | Required. The recast. |
picks | object | The cast or identity sheet gate: each slot id mapped to the chosen candidate index. |
gate | string | Which gate picks answers: cast (default) or sheet. |
segment, anchor_start, anchor_end | integer | The scene stills gate: the scene, and the chosen opening and closing frames. |
section, music_pick | integer | The music gate: the stretch of music, and the chosen take. |
finish_auto | boolean | Resolves this gate and every remaining one with the top candidate of the automatic critic, so the run finishes on its own. |
The gates open in this order: the cast, then the identity sheets for people, then the scene stills, then the music. On the sheet gate, the three sheets share the face chosen at the cast gate, so the choice is about the body and the clothes only.
get_recast_status
Returns the progress of a recast: blueprint ready, planning, planned, generating (segments done out of the total, with a live preview), completed (with the result URL) or failed. It always includes the link to the project at recast.nodaro.ai. In clients that display MCP Apps, it shows a live card with a progress bar, the growing preview, and the gate candidates as buttons.
| Parameter | Type | Notes |
|---|---|---|
recast_id | string | Required. The recast. |
When the status is planned, call start_recast again to begin rendering.
Frequently asked questions
Related
Recast
Recast
Studio productions
Analysis and edit lists
Last updated on
Studio productions
Parameters of every studio production tool, from free plan validation to frame, motion, voice and soundtrack generation, with scopes and quotes.
3D scenes
Parameters of the four 3D scene tools that author an editable clay scene from a prompt, revise it, render it to MP4, or produce a finished shot in one job.