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.
Entradas
| Entrada | Aceita | O que faz |
|---|---|---|
| Referências | Nós de imagem e de vídeo | Opcional. 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ção | O que faz |
|---|---|
| Mecanismo de criação | Aparece 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 IA | O 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ínio | Aparece 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. |
| Cena | A descrição da tomada: os objetos, o movimento deles, a câmera e o timing. |
| Referências | Um papel para cada referência conectada: Aparência (o padrão para imagens), Layout ou Movimento (o padrão para um vídeo). |
| FPS | 24 (o padrão), 30 ou 60 quadros por segundo. |
| Duração (s) | De 1 a 60 segundos. O padrão é 4. |
| Proporção | 16:9 (o padrão), 9:16, 1:1 ou 4:5. |
| Texto antes e depois | Texto 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:
| Parte | Créditos |
|---|---|
| Criar a cena | Os tokens que o modelo de IA usou, pela tarifa do modelo |
| Uma referência de vídeo, quando houver | O preço da Análise de vídeo para esse vídeo |
| Exportar um MP4 com o Renderizar vídeo | 55 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éimageouvideo, eroleéappearance,layoutoumotion. UmobjectIdopcional 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,
fpspode ser qualquer valor de 15 a 60. - Mecanismos. O
GET /v1/3d-scene/capabilitieslista 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,inputAssetspode 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.
Páginas relacionadas
Editar cena 3D
Renderizar vídeo
Renderização 3D Pro
Gerar vídeo
Cenas 3D
Última atualização
Sobreposição em vídeo
Mostre até 20 camadas de imagem ou vídeo com tempo marcado sobre um vídeo, com layouts empilhados e picture-in-picture, prévia ao vivo e áudio mantido.
Editar cena 3D
Altere uma cena 3D de massinha com uma instrução ou edições diretas gratuitas, bloqueie os objetos fixos e guarde cada revisão para comparar ou restaurar.