3D 장면 편집

3D 장면 편집 노드는 기존 3D 장면의 새 버전을 만듭니다. “기둥을 1미터 뒤로 옮기고 여행 가방의 경로는 그대로 두세요”처럼 바꿀 내용을 평범한 말로 설명하세요. AI 모델이 변경을 적용하고, 잠근 오브젝트는 그대로 유지됩니다. 3D 장면 생성의 장면을 장면 입력에 연결하고, 결과는 동영상 렌더링으로 내보내세요.

사용 시기

• 블로킹은 거의 맞는데, 처음부터 다시 하지 않고 카메라, 오브젝트 하나 또는 타이밍만 바꾸고 싶을 때.
• 한 장면의 변형을 여러 개 시도하고 각 버전을 남겨 두고 싶을 때.
• 레퍼런스 이미지나 동영상을 더해 변경 방향을 잡고 싶을 때.

사용할 수 있는 곳

3D 장면 편집은 모든 에디션의 노드 추가 메뉴에서 동영상 › 타이틀, 그래픽 및 자막 아래에 있습니다. 코드와 AI 어시스턴트는 API, SDK, edit_3d_scene MCP 도구로 실행할 수 있습니다.

빠른 시작

입력

출력인 컴포지션은 새 리비전입니다. 동영상 렌더링이나 다른 3D 장면 편집에 연결하세요.

설정

지시 아래에는 잠긴 오브젝트 수가 표시됩니다. 잠금은 모델이 응답한 후 확인됩니다. 잠긴 오브젝트는 모두 변경 없이 돌아와야 합니다.

두 가지 편집 방법

미리 보기의 직접 편집은 지금 보고 있는 프레임에 적용됩니다. 애니메이션이 있는 채널에서는 값을 바꾸면 현재 프레임의 키프레임이 업데이트되거나 새로 삽입됩니다. 애니메이션이 없는 채널에서는 값을 바꾸면 모든 프레임에서 오브젝트가 움직입니다.

모든 편집은 장면 전체와 대조해 검사됩니다. 오브젝트 ID, 오브젝트 계층 구조, 애니메이션 프레임을 확인합니다. 편집 때문에 부모나 레퍼런스가 아무것도 가리키지 않게 되는 일은 없습니다. 시작한 장면은 바뀌지 않으며, 새 리비전은 그 장면을 부모로 기록합니다.

리비전

• 아무것도 덮어쓰지 않습니다. 편집할 때마다 새 리비전이 만들어집니다. 리비전 목록에 이전 리비전이 남아 있으므로 비교하거나 복원할 수 있습니다.
• 직접 편집이 우선합니다. 장면을 직접 바꾼 뒤에 모델 편집이 끝나면 직접 바꾼 내용이 계속 적용됩니다. 알림에서 새 리비전 사용 또는 내 편집 유지를 고를 수 있습니다.
• MP4 하나는 리비전 하나를 씁니다. 동영상 렌더링은 실행 시점에 활성 상태인 리비전을 내보냅니다.

MP4는 편집 가능한 장면이 아닙니다. 동영상을 바탕으로 작업하려면 그 동영상을 3D 장면 생성에 레퍼런스로 연결하고, 3D 장면 생성이 만든 장면을 편집하세요.

크레딧

렌더링은 항상 별도 단계입니다. 3D 장면 렌더링 비용을 참조하세요. Community Edition과 Business 에디션에는 크레딧 과금이 없습니다.

팁

• 지시하기 전에 잠그세요. 잠긴 오브젝트는 변경 없이 돌아와야 하며, Nodaro가 모델 응답 후 이를 확인합니다.
• 정확한 값은 직접 편집으로 넣으세요. 카메라 높이나 오브젝트 위치처럼 숫자를 알고 있다면 미리 보기에 입력하세요. 즉시 적용되고 무료입니다.
• 렌더링하기 전에 비교하세요. 이전 리비전이 리비전 목록에 남아 있으므로, 내보내기 전에 버전을 비교하고 하나를 복원할 수 있습니다.
• 동영상 레퍼런스는 먼저 자르세요. 동영상 레퍼런스는 클립 전체로 사용됩니다. 동영상 자르기로 필요한 부분만 남기세요.

API에서 사용

POST /v1/3d-scene/edit는 scenePlan, expectedRevisionId, 그리고 prompt나 operations 목록 중 하나를 받습니다. 오래된 리비전을 기준으로 한 요청은 거부됩니다. 편집에 성공하면 작업이 반환되며, 그 작업의 output_data.scenePlan에 새 리비전이 changeSummary와 함께 담깁니다.

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

• 연산은 보낸 필드만 정확히 바꿉니다. 키프레임이 있는 포즈를 바꾸려면 그 키프레임 변경도 함께 보내세요.
• 잠금. lockedObjectIds에는 변경 없이 돌아와야 하는 오브젝트를 나열합니다.
• 레퍼런스. 새 레퍼런스는 ID 기준으로 기존 레퍼런스와 병합되며, 같은 ID의 레퍼런스는 교체됩니다. 모두 교체하려면 전체 목록과 함께 replaceReferences: true를 보내고, 모두 지우려면 빈 목록과 함께 보내세요.
• 고급 엔진. 고급 엔진으로 만든 장면은 그 엔진에서 편집되며, 기본 엔진을 요청하면 거부됩니다. 고급 엔진의 지시 편집은 새 장면과 같은 세부 정보를 보고합니다. 시각 검토의 승인 없이 전달된 결과와 실패한 실행에서 보관된 초안도 여기에 포함됩니다. 3D 렌더링 Pro를 참조하세요.

AI 어시스턴트는 edit_3d_scene MCP 도구를 쓰며, 잠금에는 locked_object_ids를 씁니다. MCP로 다루는 3D 장면을 참조하세요.