Edit 3D Scene

The Edit 3D Scene node makes a new version of an existing 3D scene. You describe the change in plain words, such as "Move the pillar back one meter and keep the suitcase path unchanged". An AI model applies it, and the objects you lock stay exactly as they are. Connect a scene from Generate 3D Scene to its Scene input, and export the result with Render Video.

When to use it

• The blocking is almost right, and you want to change the camera, one object or the timing without starting again.
• You want to try variations of one scene and keep each version.
• You want to add reference images or a video to guide a change.

Where it is available

Edit 3D Scene is in the node picker on every edition, under Video › Titles, Graphics & Captions. Code and AI assistants can run it through the API, the SDK and the edit_3d_scene MCP tool.

Quick start

Inputs

The output, Composition, is the new revision. Connect it to Render Video, or to another Edit 3D Scene.

Settings

Under the instruction, the panel says how many objects are locked. The locks are checked after the model answers: every locked object must come back unchanged.

Two ways to edit

Direct edits in the preview work on the frame you see. On an animated channel, a change updates or inserts a keyframe at the current frame. On a channel that is not animated, a change moves the object at every frame.

Every edit is checked against the whole scene: object ids, the hierarchy of objects and the animation frames. An edit can never leave a parent or a reference pointing at nothing. The scene you started from stays unchanged, and the new revision records it as its parent.

Revisions

• Nothing is overwritten. Each edit creates a new revision. The revision list keeps the earlier ones, so you can compare them or restore one.
• Your edits win. If a model edit finishes after you changed the scene by hand, your changes stay active. A notice offers Use the new one or Keep mine.
• Each MP4 uses one revision. Render Video exports the revision that is active when it runs.

An MP4 is not an editable scene. To work from a video, connect it as a reference to Generate 3D Scene and edit the scene it builds.

Credits

An edit instruction is charged like Generate 3D Scene authoring. The full rules are in How LLM calls are charged. Rendering is always a separate step. See What a 3D scene render costs. Community and Business editions do not use credit billing.

Tips

• Lock before you instruct. A locked object must come back unchanged, and Nodaro checks it after the model answers.
• Use direct edits for exact values. When you know the number, such as a camera height or an object's position, type it in the preview. It is instant and free.
• Compare before you render. Earlier revisions stay in the revision list, so you can compare versions and restore one before you export.
• Trim video references first. A video reference is used as a whole clip. Use Trim Video to keep only the part you need.

From the API

POST /v1/3d-scene/edit takes the scenePlan, the expectedRevisionId and either a prompt or a list of operations. A request based on an outdated revision is refused. A successful edit returns a job whose output_data.scenePlan holds the new revision, together with a changeSummary.

const edited = await client.nodes.runAndWait("edit-3d-scene", {
  scenePlan: scene.scenePlan,
  expectedRevisionId: scene.scenePlan.revisionId,
  operations: [{ op: "set-camera", changes: { focalLengthMm: 50 } }],
});

• Operations change exactly the fields you send. To change a keyed pose, include its keyframe changes.
• Locks. lockedObjectIds lists the objects that must come back unchanged.
• References. New references merge with the existing ones by id, and the same id replaces a reference. Send replaceReferences: true with the complete list to replace them all, or with an empty list to clear them.
• Advanced engines. A scene made by an advanced engine is edited on that engine, and asking for Basic is refused. An instruction edit on an advanced engine reports the same details as a new scene, including results delivered without the visual review's approval and drafts kept from failed runs. See 3D Render Pro.

AI assistants use the edit_3d_scene MCP tool, with locked_object_ids for the locks. See 3D scenes through MCP.