3D 장면 생성

3D 장면 생성 노드는 샷 설명을 텍스처 없는 클레이로 된, 편집 가능한 애니메이션 3D 장면으로 바꿉니다. 오브젝트와 카메라, 그리고 시간에 따른 움직임을 배치하므로, 최종 동영상에 크레딧을 쓰기 전에 프레이밍, 카메라 이동, 블로킹을 확인할 수 있습니다. 노드가 반환하는 것은 동영상이 아니라 장면입니다. 3D 장면 편집으로 편집하거나 동영상 렌더링으로 내보내세요.

사용 시기

• 샷을 미리 시각화하고 싶을 때. 피사체가 어디에 서는지, 무엇이 무엇 앞에 있는지, 카메라가 어떻게 움직이는지 확인합니다.
• 동영상 모델이 내 블로킹과 카메라 이동을 따르게 하는 레이아웃 레퍼런스가 필요할 때.
• 레퍼런스 이미지나 클립의 대략적인 레이아웃이나 움직임을 재구성한 뒤 조정하고 싶을 때.
• 최종 렌더링 전에 카메라 이동과 타이밍을 저렴하게 비교하고 싶을 때.

사용할 수 있는 곳

3D 장면 생성은 모든 에디션의 노드 추가 메뉴에서 동영상 › 타이틀, 그래픽 및 자막 아래에 있습니다. 코드와 AI 어시스턴트는 API, SDK, generate_3d_scene MCP 도구로 실행할 수 있습니다. 셀프 호스팅 설치에는 크레딧 과금이 없습니다.

빠른 시작

입력

출력인 컴포지션은 편집 가능한 장면입니다. 동영상 렌더링에 연결하거나, 3D 장면 편집 또는 3D 렌더링 Pro의 장면 입력에 연결하세요.

설정

역할은 레퍼런스가 무엇을 뜻하는지 모델에 알려 줍니다. 사물이 어떻게 생겼는지, 어디에 놓이는지, 어떻게 움직이는지입니다. 같은 사진도 세 역할에서는 서로 다른 세 가지 의미를 가집니다.

미리 보기와 리비전

장면에는 모든 오브젝트의 ID, 위치, 회전, 스케일, 크기와 카메라의 위치, 타깃, 렌즈, 그리고 조명과 키프레임이 저장됩니다. 설정 패널의 3D 미리 보기에서 장면을 재생하고 앞뒤로 움직여 보고, 오브젝트를 선택해 값을 직접 편집할 수 있습니다.

• 직접 편집은 무료입니다. 미리 보기에서 값을 바꾸면 모델 호출도 크레딧도 없이 장면의 새 리비전이 만들어집니다.
• 애니메이션 유무. 애니메이션이 없는 채널에서는 편집하면 모든 프레임에서 오브젝트가 움직입니다. 애니메이션이 있는 채널에서는 편집하면 현재 프레임에 키프레임이 기록됩니다.
• 모든 리비전이 보관됩니다. 리비전 목록에는 각 리비전의 출처가 표시됩니다. 생성됨, 모델 편집, 수동 편집 또는 연결된 장면에서 가져옴입니다. 어떤 리비전이든 복원하면 다시 활성 상태가 됩니다.
• 직접 편집이 우선합니다. 장면을 편집한 뒤에 생성이 끝나면 편집한 내용이 계속 적용됩니다. 알림에서 새 리비전 사용 또는 내 편집 유지를 고를 수 있습니다.
• 단위. 위치는 미터 단위이고 Y축이 위를 향하며, 회전은 라디안 단위이고, 프레임은 0부터 셉니다.

렌더링하는 MP4는 각각 특정 리비전 하나를 씁니다.

장면이 할 수 있는 것과 없는 것

• 단순한 형태. 기본 엔진은 사람을 나타내는 단순한 대역 인물을 포함해, 단순한 도형과 그룹으로 장면을 만듭니다. 세밀한 텍스처 모델이나 물리 시뮬레이션은 만들지 않습니다.
• 대략적인 재구성. 이미지는 그 안에 가려진 것을 보여 줄 수 없으므로, 가려진 형태는 추측합니다. 동영상 레퍼런스는 모션과 레이아웃의 안내로 읽힙니다.
• 클립 전체만. 동영상 레퍼런스는 전체가 분석됩니다. 클립의 일부를 쓰려면 먼저 동영상 자르기로 자른 다음 자른 클립을 레퍼런스로 쓰세요.

내보내기 전에 항상 미리 보기를 확인하세요.

렌더링을 동영상 레퍼런스로 사용

동영상 렌더링이 장면에서 내보내는 MP4는 레이아웃 레퍼런스입니다. 피사체의 위치, 무엇이 무엇 앞에 있는지, 프레이밍, 카메라 이동, 타이밍을 담고 있습니다. 텍스처 없는 회색 클레이라는 외관도 담고 있는데, 동영상 모델은 따로 지시하지 않으면 그 외관을 따라 합니다. 다음 두 규칙을 지키면 레이아웃은 살리고 클레이는 버릴 수 있습니다.

1. 클레이 렌더링은 반드시 범위를 정하는 문구와 함께 붙이세요. 동영상 렌더링 출력을 동영상 생성 노드의 동영상 레퍼런스 입력에 연결하면, Nodaro가 그 레퍼런스에 대한 문구를 알아서 추가합니다. 워크플로 실행에서도, 동영상 노드 자체의 실행에서도 추가합니다. 노드의 최종 프롬프트 미리 보기에서 문구가 보내지는 그대로 볼 수 있습니다. 클립에 대한 문구는 다음과 같습니다.

모델은 이 문구를 @video_1: 뒤에 이어지는 형태로 읽습니다. 카메라가 움직이지 않는 장면에서는 문구에서 카메라 모션 부분이 빠집니다. 렌더링에서 추출한 프레임을 이미지 레퍼런스로 연결하면 모션과 타이밍 부분이 빠집니다. 이미 그 레퍼런스의 범위를 정하고 있는 프롬프트는 그대로 두므로, 다시 실행해도 문구가 두 번 들어가지 않습니다.

2. 실제처럼 보여야 하는 인물마다 캐릭터 레퍼런스를 따로 주세요. 실사 표현은 프레임 전체가 아니라 레퍼런스가 있는 피사체마다 적용됩니다. 레이아웃 레퍼런스 하나와 캐릭터 하나만 있으면 그 캐릭터만 실제처럼 바뀌고, 나머지 인물은 모두 클레이 대역으로 남습니다. 인물마다 캐릭터 에셋을 하나씩 쓰면 모든 인물이 실제처럼 바뀌고 각자의 정체성을 유지합니다. 장소나 스타일 이미지를 위해 레퍼런스 슬롯 두 개는 비워 두세요.

원래의 외관 이미지도 최종 동영상 노드에 연결하세요. 클레이 렌더링은 블로킹과 카메라를, 이미지는 외관을 담당합니다. 렌더링은 시작 프레임이 아니라 반드시 레퍼런스 입력에 연결하세요. 시작 프레임은 외관을 결정하며, 범위를 정하는 문구가 시작 프레임에는 닿지 않기 때문입니다. 가이드가 있는 결과와 없는 결과를 비교하려면 프롬프트, 이미지, 모델, 설정을 똑같이 두고 클레이 동영상과 그 문구만 더하세요.

크레딧

Nodaro Cloud에서 장면 비용은 최대 세 부분의 합입니다.

기본 모델은 표준입니다. 이미지 레퍼런스만 있는 장면은 제작에 33크레딧이 들고, MP4를 한 번 내보내면 88크레딧이 듭니다. 추론 강도가 높으면 청구 등급이 올라갈 수 있습니다.

이 노드가 제공하는 화면 비율은 모두 1920픽셀 이하로 렌더링되므로, 내보내기 비용은 55크레딧입니다. 더 큰 프레임은 편집기에서 장면 크기를 바꾸거나 API나 MCP로 장면을 제공할 때만 나옵니다. 3D 장면 렌더링 비용을 참조하세요.

미리 보기 재생과 값 편집은 무료입니다. Community Edition과 Business 에디션에는 크레딧 과금이 없습니다.

팁

• 카메라가 무엇을 언제 하는지 말하세요. “4초 동안 오른쪽으로 돌리 이동”이라고 하면 모델이 이동과 길이를 분명히 알 수 있습니다.
• 프리비즈는 짧게 유지하세요. 기본값인 24fps의 4초는 블로킹 한 비트 분량으로, 프리비즈 작업에 딱 맞습니다.
• 바뀌면 안 되는 것은 잠그세요. 3D 장면 편집에 변경을 요청하기 전에 그대로 있어야 하는 오브젝트를 잠그세요.
• 한 번에 완성된 샷이 필요한가요? 설치에서 제공하는 경우 3D 렌더링 Pro는 더 정교한 장면을 한 번의 실행으로 제작하고 내보냅니다.

문제 해결

미리 보기에 WebGL이 필요하다고 표시됩니다. 3D 미리 보기에는 WebGL이 필요한데, 브라우저에서 WebGL이 꺼져 있습니다. 브라우저에서 WebGL을 켜거나 WebGL을 지원하는 브라우저를 쓰세요. 장면 자체는 온전하므로 그대로 동영상으로 렌더링할 수 있습니다.

미리 보기가 멈추거나 그래픽 컨텍스트를 잃습니다. 장면 데이터에는 영향이 없습니다. 패널에서 값을 계속 편집하거나 장면을 동영상으로 렌더링하세요.

API에서 사용

POST /v1/3d-scene/generate는 jobId를 반환합니다. 작업이 완료되면 output_data.scenePlan에 편집 가능한 장면이 담깁니다. POST /v1/render-video/plan과 planType: "3d-scene"으로 렌더링하세요.

const scene = await client.nodes.runAndWait("generate-3d-scene", {
  prompt: "A red suitcase rolls behind a central pillar and reappears. Dolly right over four seconds.",
  durationSeconds: 4,
  fps: 24,
  aspectRatio: "16:9",
  references: [{ id: "suitcase-appearance", kind: "image", role: "appearance", url: appearanceImageUrl }],
});
const video = await client.nodes.runAndWait("render-video", { planType: "3d-scene", plan: scene.scenePlan });

• 레퍼런스는 { id, url, kind, role } 형식입니다. kind는 image 또는 video이고, role은 appearance, layout 또는 motion입니다. 선택 사항인 objectId로 레퍼런스를 특정 오브젝트 하나에 연결합니다. 동영상의 일부 시간 구간만 지정하면 청구 전에 거부됩니다.
• 프레임 레이트. API에서는 fps를 15~60 사이의 어떤 값으로도 정할 수 있습니다.
• 엔진. GET /v1/3d-scene/capabilities는 설치에서 쓸 수 있는 선택적 고급 엔진을 나열합니다. 사용할 수 없는 엔진을 요청하면 거부되며, 기본 엔진으로 대체되지 않습니다. 가져오기를 지원하는 고급 엔진에서는 inputAssets로 내 장면에 보관된 기존 GLB 모델을 최대 8개 가져올 수 있습니다.
• 고급 결과. 고급 엔진의 장면은 엔진이 세운 가정과 실행한 복구도 보고합니다. 시각 검토의 승인 없이 전달될 수 있으며, 실패한 실행은 만들어 둔 초안을 보관할 수 있습니다. 3D 렌더링 Pro에서 이런 결과를 읽는 방법을 설명합니다.

AI 어시스턴트는 generate_3d_scene, edit_3d_scene, render_3d_scene MCP 도구를 씁니다. MCP로 다루는 3D 장면과 3D 장면 API를 참조하세요.