NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Vídeo

Gerar cena 3D

Descreva uma tomada e receba uma cena 3D de massinha animada e editável para previz, com objetos, câmera e timing, e renderize como referência de layout.

O nó Gerar cena 3D 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 ou exporte-a com o Renderizar vídeo.

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 tempos 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 auto-hospedadas, não há cobrança por créditos.

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Vídeo › Títulos, gráficos e legendas › Gerar cena 3D.

Descrever a tomada

No painel de configurações, escreva em Cena os objetos, o movimento deles, a posição e o movimento da câmera e o timing. Por exemplo: A red suitcase rolls behind a central pillar and reappears. Dolly right over four seconds.

Adicionar referências, se você tiver

Conecte até 8 imagens e no máximo 1 vídeo à entrada Referências. Para cada uma, escolha um papel em Referências: Aparência, Layout ou Movimento.

Executar e conferir a prévia

Clique em Executar. A prévia 3D aparece no painel de configurações. Reproduza a prévia, percorra a linha do tempo e ajuste objetos ou a câmera diretamente.

Renderizar

Conecte a saída Composição ao Renderizar vídeo e execute-o para obter um MP4 de massinha.

referênciascomposiçãorefs. de vídeoEnviar imagemReferência de aparênciaGerar cena 3DDolly para a direita, 4 sRenderizar vídeoMP4 de massinhaPersonagemGerar vídeo
Uma cena de previz em massinha é renderizada e orienta o layout e a câmera do vídeo final, enquanto o personagem fornece o visual.

Entradas

EntradaAceitaO que faz
ReferênciasNós de imagem e de vídeoOpcional. Até 8 referências, com no máximo 1 vídeo. As imagens orientam a aparência e o layout. Um vídeo orienta o movimento e o layout.

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.

Configurações

ConfiguraçãoO que faz
Mecanismo de criaçãoAparece só quando a sua instalação oferece um mecanismo avançado. Básico é o padrão. Avançado — hospedado cria cenas mais detalhadas e é cobrado à parte. Avançado — Blender local só aparece onde a instalação aceita um desktop pareado. Os mecanismos avançados usam um planejador fixo, então as configurações do modelo ficam ocultas.
Modelo de IAO modelo de linguagem que planeja a cena. O padrão é o Claude Sonnet 5.5. A chamada é cobrada pelos tokens que usou, pela tarifa do modelo.
Esforço de raciocínioAparece nos modelos que raciocinam. Um nível não tem preço próprio: um nível mais alto costuma escrever mais tokens, e esses tokens são cobrados.
CenaA descrição da tomada: os objetos, o movimento deles, a câmera e o timing.
ReferênciasUm papel para cada referência conectada: Aparência (o padrão para imagens), Layout ou Movimento (o padrão para um vídeo).
FPS24 (o padrão), 30 ou 60 quadros por segundo.
Duração (s)De 1 a 60 segundos. O padrão é 4.
Proporção16:9 (o padrão), 9:16, 1:1 ou 4:5.
Texto antes e depoisTexto adicionado antes e depois da descrição da cena na hora da execução. Veja Texto antes e depois do prompt.

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 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, 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 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:

ParteCréditos
Criar a cenaOs tokens que o modelo de IA usou, pela tarifa do modelo
Uma referência de vídeo, quando houverO preço da Análise de vídeo para esse vídeo
Exportar um MP4 com o Renderizar vídeo55 até 1920 pixels no lado mais longo, 83 até 5,12 megapixels, 138 acima disso

A criação é uma chamada ao modelo de IA. A chamada é cobrada pelos tokens que realmente usou, pela tarifa do modelo selecionado. Os tokens são o seu prompt, as descrições das referências, o texto de alguma análise de vídeo e o plano da cena que o modelo escreve. As regras completas estão em Como as chamadas de LLM são cobradas.

  • Antes da execução, o botão Executar mostra uma estimativa (≈ e um número) de uma cena típica com o modelo selecionado. O Gemini 3.6 Flash custa menos que o padrão, o Claude Sonnet 5.5, e o Claude Opus 5.5 custa mais.
  • Um trabalho mais longo custa mais. Um prompt longo, muitas referências ou uma passada de correção usam mais tokens.
  • O Esforço de raciocínio não tem preço próprio. Em um modelo Claude, qualquer esforço executa a chamada no próprio serviço da Anthropic, pela tarifa desse serviço.
  • Falhas. Uma falha que o fabricante do modelo cobrou é cobrada por esse uso. Uma falha que não foi cobrada é reembolsada. Uma execução que não pôde entrar na fila para começar não é removida: ela aparece como falha, os créditos dela são reembolsados, e você pode executá-la de novo.

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 para a direita ao longo de quatro segundos” dá ao modelo um movimento e uma duração claros.
  • Mantenha a previz curta. O padrão de 4 segundos a 24 fps é um momento 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 a tarefa termina, o output_data.scenePlan dela 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.

Perguntas frequentes

Onde encontro o Gerar cena 3D?

No menu “Adicionar nó”, em Vídeo › Títulos, gráficos e legendas, em todas as edições. Código e assistentes de IA também podem executá-lo pela API, pelo SDK e pela ferramenta MCP generate_3d_scene.

O Gerar cena 3D gera um vídeo?

Não. Ele cria uma cena 3D editável. Conecte-o ao Renderizar vídeo para exportar um MP4, que custa 55 créditos no Nodaro Cloud em qualquer proporção que o nó oferece.

Quantos créditos o Gerar cena 3D custa?

No Nodaro Cloud, criar uma cena é uma chamada ao modelo de IA, cobrada pelos tokens que usou, pela tarifa do modelo. O botão Executar mostra uma estimativa de uma cena típica antes da execução. Uma exportação em MP4 acrescenta 55 créditos, uma referência de vídeo acrescenta uma cobrança da Análise de vídeo, e as edições na prévia são gratuitas.

Ele consegue reconstruir uma cena a partir de uma foto ou de um vídeo?

De forma aproximada. As imagens orientam a aparência e o layout, e um vídeo orienta o movimento e o layout. A cena usa formas simples e figuras substitutas, então não recupera geometria oculta nem texturas detalhadas.

Como uso a renderização de massinha com um modelo de vídeo?

Conecte o MP4 renderizado à entrada “Refs. de vídeo” de um nó “Gerar vídeo”. O Nodaro adiciona uma linha que diz ao modelo para copiar só o layout, a câmera e o timing, e ignorar o visual de massinha. Dê a cada figura que precisa parecer real a própria referência de personagem.

Última atualização

Nesta página