Gerar cena 3D

O nó Gerar cena 3D (Generate 3D Scene) transforma a descrição de uma tomada em uma cena 3D animada e editável, de massinha sem textura. Ele posiciona os objetos, a câmera e o movimento deles ao longo do tempo, para você conferir o enquadramento, os movimentos de câmera e a marcação antes de gastar créditos em um vídeo final. O nó retorna a cena, não um vídeo: edite-a com o Editar cena 3D (Edit 3D Scene) ou exporte-a com o Renderizar vídeo (Render Video).

Quando usar

• Você quer pré-visualizar uma tomada: onde ficam os assuntos, o que está na frente do quê e como a câmera se move.
• Você quer uma referência de layout que faça um modelo de vídeo seguir a sua marcação e o seu movimento de câmera.
• Você quer reconstruir o layout ou o movimento aproximado de uma imagem ou de um clipe de referência e depois ajustá-lo.
• Você quer comparar movimentos de câmera e timings gastando pouco, antes de uma renderização final.

Onde está disponível

O Gerar cena 3D está no menu Adicionar nó em todas as edições, em Vídeo › Títulos, gráficos e legendas. Código e assistentes de IA podem executá-lo pela API, pelo SDK e pela ferramenta MCP generate_3d_scene. Nas instalações self-hosted, não há cobrança por créditos.

Início rápido

Entradas

A saída, Composição, é a cena editável. Conecte-a ao Renderizar vídeo ou à entrada Cena do Editar cena 3D ou do nó Renderização 3D Pro (3D Render Pro).

Configurações

Um papel diz ao modelo o que uma referência significa: como as coisas são, onde elas ficam ou como elas se movem. A mesma imagem significa três coisas diferentes nos três papéis.

A prévia e as revisões

A cena guarda o id, a posição, a rotação, a escala e o tamanho de cada objeto, a posição, o alvo e a lente da câmera, a iluminação e os quadros-chave. A prévia 3D no painel de configurações permite reproduzir e percorrer a cena, selecionar objetos e editar os valores deles diretamente.

• As edições diretas são gratuitas. Mudar um valor na prévia cria uma nova revisão da cena, sem nenhuma chamada ao modelo e sem créditos.
• Animado ou não. Em um canal que não é animado, uma edição move o objeto em todos os quadros. Em um canal animado, uma edição grava um quadro-chave no quadro atual.
• Todas as revisões são mantidas. A lista de revisões mostra de onde cada uma veio: Geração, Edição do modelo, Edição manual ou Da cena conectada. Restaure qualquer revisão para torná-la ativa de novo.
• As suas edições têm prioridade. Se uma geração terminar depois que você editou a cena, as suas edições continuam ativas. Um aviso oferece Usar a nova ou Manter a minha.
• Unidades. As posições ficam em metros, com o Y apontando para cima, as rotações ficam em radianos, e os quadros são contados a partir de 0.

Cada MP4 que você renderiza usa uma revisão específica.

O que a cena consegue e não consegue fazer

• Geometria simples. O mecanismo Básico cria cenas com formas e grupos simples, incluindo figuras substitutas simples para pessoas. Ele não cria modelos detalhados com textura nem simulações de física.
• Reconstrução aproximada. Uma imagem não mostra o que está escondido nela, então a geometria oculta é deduzida. Uma referência de vídeo é lida como um guia de movimento e de layout.
• Só clipes inteiros. Uma referência de vídeo é analisada por inteiro. Para usar parte de um clipe, corte-o antes com o Cortar vídeo (Trim Video) e use o clipe cortado como referência.

Sempre confira a prévia antes de exportar.

Usar a renderização como referência de vídeo

O MP4 que o Renderizar vídeo exporta de uma cena é uma referência de layout. Ele traz onde os assuntos estão, o que está na frente do quê, o enquadramento, o movimento de câmera e o timing. Ele também traz um visual, a massinha cinza sem textura, e um modelo de vídeo copia esse visual, a menos que seja instruído a não fazer isso. Duas regras mantêm o layout e descartam a massinha.

1. Nunca anexe a renderização de massinha sem uma linha de escopo. Conecte a saída do Renderizar vídeo à entrada Refs. de vídeo de um nó Gerar vídeo (Generate Video), e o Nodaro adiciona sozinho a linha dessa referência. Ele faz isso em uma execução do workflow e no próprio Executar do nó de vídeo. A prévia do prompt Final do nó mostra a linha exatamente como ela é enviada. A linha de um clipe é:

LAYOUT reference only — match its subject positions and blocking, its foreground occlusion, its framing, its camera angle, its camera motion and its timing. Ignore its untextured grey clay placeholder look, its flat placeholder colours, its materials, its lighting and its empty background; none of that is the target look. Take the look from the prompt and from the other references

O modelo lê essa linha como @video_1: seguido da linha. Em uma cena com a câmera parada, a linha omite a parte sobre o movimento de câmera. Para um quadro extraído da renderização e conectado como referência de imagem, ela omite as partes sobre o movimento e o timing. Um prompt que já define o escopo dessa referência fica como está, então executar de novo nunca duplica a linha.

2. Dê a cada figura que precisa parecer real a própria referência de personagem. O tratamento fotorrealista segue cada assunto referenciado, e não o quadro inteiro. Com uma referência de layout e um personagem, só esse personagem fica real, e todas as outras figuras continuam como substitutas de massinha. Com um Personagem (Character Asset) por figura, todas as figuras ficam reais e mantêm a identidade delas. Deixe dois espaços de referência livres para um local ou uma imagem de estilo.

Conecte também as suas imagens de aparência originais ao nó de vídeo final: a renderização de massinha fornece a marcação e a câmera, e as imagens fornecem o visual. Conecte a renderização a uma entrada de referência, nunca ao quadro inicial, porque um quadro inicial define o visual e nenhuma linha de escopo chega até ele. Para comparar um resultado guiado com um não guiado, mantenha idênticos o prompt, as imagens, o modelo e as configurações, e adicione só o vídeo de massinha com a linha dele.

Créditos

No Nodaro Cloud, uma cena custa a soma de até três partes:

O modelo padrão é do nível Padrão. Uma cena só com referências de imagem custa 33 créditos para ser criada, e 88 créditos com uma exportação em MP4. Um Esforço de raciocínio alto pode subir o nível cobrado.

Todas as proporções que este nó oferece renderizam em 1920 pixels ou menos, então as exportações dele custam 55 créditos. Um quadro maior só aparece quando uma cena é redimensionada no editor ou enviada pela API ou pelo MCP. Veja Quanto custa a renderização de uma cena 3D.

Reproduzir a prévia e editar valores são ações gratuitas. As edições Community e Business não usam cobrança por créditos.

Dicas

• Diga o que a câmera faz e quando. “Dolly right over four seconds” dá ao modelo um movimento e uma duração claros.
• Mantenha a previz curta. O padrão de 4 segundos a 24 fps é um beat de marcação, que é para isso que serve uma passada de previz.
• Bloqueie o que não pode mudar. Antes de pedir uma mudança ao Editar cena 3D, bloqueie os objetos que precisam ficar como estão.
• Precisa de uma tomada pronta em uma etapa? O nó Renderização 3D Pro cria e exporta uma cena mais detalhada em uma única execução, onde a sua instalação oferece esse nó.

Solução de problemas

A prévia diz que precisa de WebGL. A prévia 3D precisa de WebGL, e o navegador está com ele desativado. Ative o WebGL no navegador ou use um navegador compatível. A cena em si está intacta: você ainda pode renderizá-la em vídeo.

A prévia para ou perde o contexto gráfico. Os dados da cena não são afetados. Continue editando os valores no painel ou renderize a cena em vídeo.

Pela API

O POST /v1/3d-scene/generate retorna um jobId. Quando o job termina, o output_data.scenePlan dele traz a cena editável. Renderize-a com POST /v1/render-video/plan e 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 });

• Referências usam { id, url, kind, role }: kind é image ou video, e role é appearance, layout ou motion. Um objectId opcional liga uma referência a um objeto. Janelas de tempo parciais de um vídeo são recusadas antes de qualquer cobrança.
• Taxa de quadros. Pela API, fps pode ser qualquer valor de 15 a 60.
• Mecanismos. O GET /v1/3d-scene/capabilities lista os mecanismos avançados opcionais da instalação. Um pedido de um mecanismo indisponível é recusado; ele nunca volta para o Básico. Com um mecanismo avançado que aceita importações, inputAssets pode trazer até 8 modelos GLB existentes que as suas cenas guardaram.
• Resultados avançados. Uma cena de um mecanismo avançado também informa as suposições que fez e os reparos que executou. Ela pode ser entregue sem a aprovação da revisão visual, e uma execução que falha pode manter o rascunho que montou. O nó Renderização 3D Pro explica como ler esses resultados.

Os assistentes de IA usam as ferramentas MCP generate_3d_scene, edit_3d_scene e render_3d_scene. Veja Cenas 3D pelo MCP e a API de cenas 3D.