3D 렌더링 Pro

3D 렌더링 Pro 노드는 설명으로 애니메이션 3D 장면을 작성하고, 호스팅된 빌드 엔진에서 한 번의 실행으로 렌더링합니다. 실행 한 번이 완성된 MP4, 렌더링에 쓰인 바로 그 장면, 샷마다 정지 이미지 한 장을 반환합니다. 3D 장면 생성과는 다른 노드입니다. 그 노드는 저렴하고 편집 가능한 클레이 프리비즈이며, MP4는 별도의 동영상 렌더링 실행에서 나옵니다.

3D 렌더링 Pro는 Nodaro Cloud에서만, 그리고 Cloud의 3D 엔진이 제공하는 동안에만 실행됩니다. 셀프 호스팅 에디션에서는 이 노드를 제공하지 않습니다.

사용 시기

• 나중에 렌더링할 프리비즈가 아니라, 설명에서 완성된 3D 샷을 한 단계로 얻고 싶을 때.
• 다시 작성하는 비용을 내지 않고 기존 장면을 다시 내보내고 싶을 때.
• 이후 생성에서 이미지 레퍼런스로 쓸 정지 이미지를 샷마다 한 장씩 얻고 싶을 때.
• 3D 장면 생성에서 제공하지 않는 넓은 21:9 프레임이 필요할 때.

사용 가능한 곳

• 노드 추가 메뉴. Nodaro Cloud에서 3D 엔진이 제공하는 동안 동영상 › 타이틀, 그래픽 및 자막 › 3D 렌더링 Pro에 있습니다. 엔진을 사용할 수 없으면 노드가 비활성화된 채 표시되는 것이 아니라 목록에 아예 나오지 않습니다.
• API와 SDK. GET /v1/3d-scene/capabilities가 pro.available을 알려 줍니다. 노드를 사용할 수 없는 곳에서는 GET /v1/nodes가 이 노드를 빼고, 요청은 503 SCENE_CAPABILITY_UNAVAILABLE로 거부됩니다. Basic 엔진으로 대체되는 일은 없습니다.
• MCP. pro_3d_render 도구는 노드를 실행할 수 있는 곳에서만 목록에 나오므로, 도구 목록에 있는지가 곧 확인 방법입니다.

이미 이 노드가 들어 있는 워크플로는 나중에 엔진이 꺼져도 저장된 장면과 동영상을 유지합니다. 새 실행만 거부됩니다.

빠른 시작

장면 소스

모든 실행에는 소스가 정확히 하나 있으며, 소스가 무엇이 일어나는지와 무엇에 비용을 내는지를 모두 정합니다.

편집 지시(선택 사항)가 비어 있어야 렌더링 전용 실행이 됩니다. API에서 단순히 내보내려면 editPrompt 필드를 빼세요. 빈 문자열은 다른 요청입니다.

네 번째 소스인, 페어링된 데스크톱 Blender에서 완료된 내보내기는 설치가 지원하는 경우 API로 사용할 수 있습니다.

입력

출력

동영상 노드는 컴포지션이 아니라 동영상에 연결하세요. 컴포지션은 동영상이 아니라 장면입니다.

정지 이미지는 두 번째 렌더링이 아니라 콘택트 시트입니다. 같은 실행에서 추가 비용 없이 나옵니다. 샷이 하나인 장면에는 프레임 0의 정지 이미지가 정확히 한 장 있습니다. 샷의 시작 프레임을 이미지 모델이나 동영상 모델에 넣거나, MP4를 넘겨 보지 않고 샷별로 블로킹을 검토하는 데 쓰세요.

정지 이미지는 모든 이미지 입력에서 작동합니다. 정지 이미지는 비공개로 저장됩니다. 샷 스틸 출력을 이미지 입력이나 레퍼런스 입력에 연결하면, Nodaro가 모델에 필요한 바로 그 정지 이미지를 잠시 읽을 수 있는 권한을 줍니다. 이 권한은 그 실행에만 유효하며 내 접근 권한을 기반으로 합니다. 링크는 몇 분 뒤에 만료되며 저장되지 않습니다.

설정

모델 설정이나 추론 설정은 없습니다. 플래너는 고정되어 있으며 Nodaro가 실행합니다. 스타일은 클레이입니다.

기존 장면의 타이밍. 장면에는 이미 자체 길이, 프레임 레이트, 화면 비율이 있으며, 실행은 이를 유지합니다. 의도적으로 바꾸려면 이 장면의 타이밍 재설정을 체크하세요. 장면에 맞지 않는 변경은 조용히 적용되지 않고 거부됩니다.

결과를 동영상 레퍼런스로 사용

MP4는 3D 장면 생성의 렌더링처럼 레이아웃 레퍼런스입니다. 위치, 가림, 프레이밍, 카메라 움직임, 타이밍을 담고 있으며, 따로 말하지 않으면 동영상 모델이 따라 하는 회색 클레이 느낌도 담고 있습니다.

• Nodaro가 범위 지정 문구를 더합니다. 동영상 출력을 동영상 생성 노드의 동영상 레퍼런스 입력에 연결하세요. 그러면 Nodaro가 모델에게 레이아웃만 따라 하고 클레이 느낌은 무시하라고 알리는 문구를 더합니다. 샷이 여러 개인 장면에서는 이 문구가 컷 지점도 알려 줍니다.
• 인물마다 캐릭터 하나. 실사 표현은 레퍼런스로 지정한 대상마다 적용됩니다. 실제처럼 보여야 하는 인물마다 자기 캐릭터 레퍼런스를 주고, 장소나 스타일 이미지를 위해 레퍼런스 슬롯 두 개를 비워 두세요.
• 레퍼런스가 없는 인물은 알려 줍니다. 워크플로 실행에서 장면 속 사람이 캐릭터 레퍼런스보다 많으면, 클레이 인물을 원할 수도 있으므로 실행은 그대로 진행됩니다. 작업에는 scene3d_unreferenced_figures 경고가 기록되며, 레퍼런스가 없는 인물 수와 인물마다 레퍼런스 하나씩이 모델의 레퍼런스 한도에 들어가는지가 함께 담깁니다.
• 시작 프레임으로는 쓰지 마세요. 렌더링은 레퍼런스 입력에 연결하세요. 시작 프레임은 룩을 정하며, 범위 지정 문구가 거기에는 닿지 않습니다.

크레딧

3D 렌더링 Pro는 청구 가능한 작업 하나입니다. 새 장면은 장면 작성, 호스팅 빌드, 렌더링 비용을 냅니다. 편집 지시가 없는 기존 장면은 렌더링 비용만 냅니다. 수정 한도 안의 수정 패스마다 비용이 드는 작업입니다.

견적을 낸 다음 실행합니다. 가격은 배포마다 정하므로 고정 정가가 없습니다. 모든 실행은 먼저 견적을 내며, 견적은 청구액이 아니라 상한을 보여 줍니다. 캔버스에서 노드는 이를 최대 N크레딧으로 보여 줍니다. 실행이 쓰지 않은 허용량은 정산할 때 풀립니다. 가격이 설정되지 않은 설치에서는 아무것도 예약하기 전에 실행이 거부됩니다.

견적에는 수정 패스 외에 허용량 두 가지가 포함될 수 있습니다.

프레임 크기와 길이. 렌더링 단계는 출력 프레임당 가격이 매겨지므로, 장면이 길거나 프레임 레이트가 높을수록 비용이 더 듭니다. 프레임당 가격은 동영상 렌더링과 같은 프레임 크기 단계를 따릅니다. 가장 긴 변이 1920픽셀 이하인 프레임은 기본 요금입니다. 더 큰 프레임은 5.12메가픽셀까지 기본 요금의 1.5배, 그보다 크면 2.5배입니다.

동영상 렌더링으로, 또는 지시 없이 기존 장면으로 저장된 장면을 다시 렌더링하면 일반 렌더링으로 청구됩니다. 앞선 수정 패스처럼 실패 전에 완료된 작업은 평소처럼 청구됩니다.

실행이 통과하지 못할 때

시각 리뷰가 빌드된 장면을 확인하고, 수정 패스가 수정 한도가 남아 있는 동안 리뷰의 이의에 대응합니다. 실행은 다음 중 하나로 끝납니다.

승인 없이 장면이 전달되면 실행은 완료되고, MP4는 실제로 만들어지며, 크레딧이 청구됩니다. 그대로 쓰거나, 리뷰의 수정 의견을 편집 설명으로 삼으세요. 그 수정 의견을 편집 지시로 넣고 기존 장면을 실행하면 장면 작성 패스 비용을 한 번 더 냅니다. 오브젝트 이동, 색 바꾸기, 숨기기 같은 직접 편집은 무료입니다. 아무도 리뷰하지 않은 장면에는 참고할 수정 의견이 없고, 같은 작업을 다시 실행하면 새 장면을 작성하므로 MP4는 직접 판단하세요.

실행이 실패했지만 초안이 남으면 MP4는 없지만, 초안은 일반 장면 리비전입니다.

• 그대로 렌더링하세요. 지시 없이 기존 장면으로 실행하세요. 그 실행은 렌더링 비용만 내며, 실행 자체의 확인이 초안을 다시 판정하지 않습니다.
• 직접 고치세요. 직접 편집은 다른 장면처럼 초안에도 적용되며 장면 작성 비용이 들지 않습니다.
• 초안에서 다시 작성하세요. 편집 지시와 함께 기존 장면으로 실행하세요.

초안을 유지하는 데는 비용이 들지 않습니다. 캔버스에서 노드는 페이지를 새로 고친 뒤에도 초안과 실패를 함께 보여 주므로, 장면이 있다고 해서 실행이 통과했다는 뜻은 아닙니다. 실행 중에 내가 한 편집이 여전히 우선하며, 도착한 초안은 리비전 기록에 남습니다.

계획 오류

팁

• 먼저 프리비즈, 그다음 Pro. 3D 장면 생성과 3D 장면 편집으로 샷을 저렴하게 잡은 다음, 최종 버전을 여기서 렌더링하세요.
• 장면 작성 없이 다시 내보내세요. 같은 장면을 다시 내보내려면 지시 없이 기존 장면을 쓰거나, 컴포지션을 동영상 렌더링에 연결하세요.
• 초안에서는 한도를 낮추세요. 수정 한도를 0이나 1로 두면 비용이 드는 수정 작업이 줄어듭니다.
• 정지 이미지를 쓰세요. 샷마다의 정지 이미지는 이미지 생성이나 동영상 생성에 바로 쓸 수 있는 이미지 레퍼런스입니다.

API에서 사용

API는 비용이 드는 작업 하나에 호출 두 번을 씁니다. POST /v1/pro-3d-render/quote는 요청을 받아 quoteId와 상한인 maxCredits를 반환합니다. 견적을 내는 것만으로는 아무것도 예약하거나 쓰지 않습니다. 이어서 POST /v1/pro-3d-render가 같은 본문과 quoteId, 그리고 8~255자의 Idempotency-Key 헤더를 받아 jobId를 반환합니다. 두 호출 사이에 본문이 바뀌면 거부되며, 만료된 견적도 거부됩니다. 시간 초과된 제출을 다시 시도할 때는 같은 Idempotency-Key를 재사용하세요.

const caps = await client.scene3d.capabilities();
if (!caps.pro?.available) return; // this install cannot run it

// Author a new scene and render it: quotes and runs in one call.
const shot = await client.scene3d.renderProAndWait({
  source: {
    kind: "prompt",
    prompt: "A red suitcase rolls behind a central pillar and reappears. Dolly right over thirty seconds.",
    references: [{ id: "look", kind: "image", role: "appearance", url: appearanceImageUrl }],
  },
  durationSeconds: 30,
  fps: 24,
  aspectRatio: "21:9",
  maxRepairPasses: 2,
});

// Later: render the same revision again, with no authoring charge.
await client.scene3d.renderProAndWait({
  source: { kind: "scene", revisionId: shot.sceneRevisionId, sourceJobId: shotJobId },
});

• 완료된 작업에는 videoUrl, scenePlan, sceneRevisionId, shotStills(샷마다 { shotIndex, frame, assetId, url } 하나), validation, 그리고 프레임 크기, 프레임 레이트, 프레임 수, 길이가 담긴 metadata가 있습니다.
• 승인되지 않은 전달에는 metadata.review가 더해집니다. 두 경우 모두 passed인 validation.status 대신, 이 필드와 그 verdict인 refused 또는 unavailable을 확인하세요.
• 초안이 있는 실패한 작업에도 scenePlan, sceneRevisionId, 그리고 status가 failed인 validation이 있습니다.
• 프레임 레이트. API에서는 fps를 15~60의 어떤 값으로든 정할 수 있습니다.

AI 어시스턴트는 같은 매개변수로 견적을 내고 제출하는 pro_3d_render MCP 도구를 씁니다. 모든 필드, 경고 코드, 오류는 MCP로 3D 장면 사용과 3D 장면 API를 참고하세요.