# 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.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/generate-3d-scene

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)](https://nodaro.ai/docs/nodes/video/edit-3d-scene) ou exporte-a com o [**Renderizar vídeo** (Render Video)](https://nodaro.ai/docs/nodes/video/render-video).

- Found in: Video › Titles, Graphics & Captions
- Output: data
- API type: `generate-3d-scene`

## 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
### 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](https://nodaro.ai/docs/nodes/video/render-video) e execute-o para obter um MP4 de massinha.

Workflow: 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.

- Enviar imagem → Gerar cena 3D (referências)
- Gerar cena 3D → Renderizar vídeo (composição)
- Renderizar vídeo → Gerar vídeo (refs. de vídeo)
- Personagem → Gerar vídeo

## 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](https://nodaro.ai/docs/nodes/video/render-video) ou à entrada **Cena** do [Editar cena 3D](https://nodaro.ai/docs/nodes/video/edit-3d-scene) ou do nó [**Renderização 3D Pro** (3D Render Pro)](https://nodaro.ai/docs/nodes/video/pro-3d-render).

## 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 4.6**. O nível do modelo (**Econômico**, **Padrão** ou **Premium**) define o preço. |
| **Esforço de raciocínio** | Aparece nos modelos que raciocinam. **Muito alto** e **Máximo** podem cobrar um nível acima. |
| **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](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/assets/character) 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 | 11 com um modelo Econômico, 33 com um modelo Padrão, 44 com um modelo Premium |
| Uma referência de vídeo, quando houver | O preço da [**Análise de vídeo** (Video Analysis)](https://nodaro.ai/docs/nodes/video/video-analysis#credits) 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 |

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](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs).

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](https://nodaro.ai/docs/nodes/video/edit-3d-scene), bloqueie os objetos que precisam ficar como estão.
- **Precisa de uma tomada pronta em uma etapa?** O nó [Renderização 3D Pro](https://nodaro.ai/docs/nodes/video/pro-3d-render) 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"`.

```typescript
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](https://nodaro.ai/docs/nodes/video/pro-3d-render#what-happens-when-a-run-does-not-pass) 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](https://nodaro.ai/docs/mcp/3d-scenes) e a [API de cenas 3D](https://nodaro.ai/docs/developers/api/3d-scenes).

## Frequently asked questions

### 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 custa 11, 33 ou 44 créditos para um modelo Econômico, Padrão ou Premium. O modelo padrão é do nível Padrão, então uma cena custa 33 créditos, ou 88 com uma exportação em MP4. Uma referência de vídeo acrescenta a 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.