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

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

O nó **Editar cena 3D** (Edit 3D Scene) cria uma nova versão de uma cena 3D existente. Você descreve a mudança com palavras simples, como “Move the pillar back one meter and keep the suitcase path unchanged”. Um modelo de IA aplica a mudança, e os objetos que você bloquear ficam exatamente como estão. Conecte uma cena do [**Gerar cena 3D** (Generate 3D Scene)](https://nodaro.ai/docs/nodes/video/generate-3d-scene) à entrada **Cena** dele e exporte o resultado 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: `edit-3d-scene`

## Quando usar
- A marcação está quase certa, e você quer mudar a câmera, um objeto ou o timing sem começar de novo.
- Você quer testar variações de uma cena e guardar cada versão.
- Você quer adicionar imagens de referência ou um vídeo para guiar uma mudança.

## Onde está disponível
O Editar 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 `edit_3d_scene`.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Títulos, gráficos e legendas › Editar cena 3D**.

### Conectar uma cena
Arraste da saída **Composição** do Gerar cena 3D, ou de outro Editar cena 3D, até a entrada **Cena**.

### Bloquear o que não pode mudar
Na lista de objetos da prévia, bloqueie todos os objetos que precisam voltar sem alterações.

### Escrever a mudança e executar
Em **Instrução de edição**, descreva a mudança, por exemplo `Move the camera lower and push the back wall two metres further away`. Clique em **Executar**. A nova revisão aparece na prévia.

Workflow: Uma cena gerada é revisada com uma instrução de edição e depois exportada como um MP4 de massinha.

- Gerar cena 3D → Editar cena 3D (cena)
- Editar cena 3D → Renderizar vídeo (composição)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Cena** | A saída **Composição** do Gerar cena 3D, do Editar cena 3D ou do nó **Renderização 3D Pro** (3D Render Pro) | A cena a mudar. Obrigatória. |
| **Referências** | Nós de imagem e de vídeo | Opcional. Mais orientação para a mudança: aparência, layout ou movimento. O conjunto das referências fica dentro dos limites do Gerar cena 3D: até 8, com no máximo 1 vídeo. |

A saída, **Composição**, é a nova revisão. Conecte-a ao [Renderizar vídeo](https://nodaro.ai/docs/nodes/video/render-video) ou a outro Editar cena 3D.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Mecanismo de criação** | Aparece só quando a sua instalação oferece um mecanismo avançado. Uma cena feita por um mecanismo avançado é editada nesse mecanismo: o Básico fica desativado para ela. |
| **Modelo de IA** | O modelo de linguagem que aplica a instrução. 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. |
| **Instrução de edição** | A mudança, com palavras simples. |
| **Referências** | Um papel para cada referência conectada: **Aparência**, **Layout** ou **Movimento**. |
| **Texto antes e depois** | Texto adicionado antes e depois da instrução na hora da execução. Veja [Texto antes e depois do prompt](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

Abaixo da instrução, o painel informa quantos objetos estão bloqueados. Os bloqueios são verificados depois que o modelo responde: cada objeto bloqueado precisa voltar sem alterações.

## Duas formas de editar
| | Instrução de edição | Edições diretas |
| --- | --- | --- |
| **Como** | Escreva a mudança e clique em **Executar** | Mude valores na prévia ou envie operações de edição pela API |
| **Modelo de IA** | Sim, o modelo que você escolher | Não |
| **Créditos** | 11, 33 ou 44 no Nodaro Cloud, conforme o nível do modelo | Grátis |
| **Resultado** | Uma nova revisão | Uma nova revisão |

As edições diretas na prévia valem para o quadro que você vê. Em um canal animado, uma mudança atualiza ou insere um quadro-chave no quadro atual. Em um canal que não é animado, uma mudança move o objeto em todos os quadros.

Toda edição é verificada em relação à cena inteira: os ids dos objetos, a hierarquia dos objetos e os quadros da animação. Uma edição nunca pode deixar um pai ou uma referência apontando para algo que não existe. A cena de onde você partiu fica inalterada, e a nova revisão a registra como a revisão de origem.

## Revisões
- **Nada é sobrescrito.** Cada edição cria uma nova revisão. A lista de revisões guarda as anteriores, para você compará-las ou restaurar uma delas.
- **As suas edições têm prioridade.** Se uma edição do modelo terminar depois que você mudou a cena à mão, as suas mudanças continuam ativas. Um aviso oferece **Usar a nova** ou **Manter a minha**.
- **Cada MP4 usa uma revisão.** O Renderizar vídeo exporta a revisão que está ativa quando ele é executado.

Um MP4 não é uma cena editável. Para trabalhar a partir de um vídeo, conecte-o como referência ao [Gerar cena 3D](https://nodaro.ai/docs/nodes/video/generate-3d-scene) e edite a cena que ele criar.

## Créditos
| Ação | Créditos no Nodaro Cloud |
| --- | --- |
| Edições diretas e operações de edição da API | Grátis |
| Uma instrução de edição | 11, 33 ou 44 para um modelo Econômico, Padrão ou Premium |
| Uma referência de vídeo | O preço da [**Análise de vídeo** (Video Analysis)](https://nodaro.ai/docs/nodes/video/video-analysis#credits) para esse vídeo |
| Renderizar a nova revisão com o Renderizar vídeo | 55 até 1920 pixels no lado mais longo, 83 até 5,12 megapixels, 138 acima disso |

A renderização é sempre uma etapa separada. Veja [Quanto custa a renderização de uma cena 3D](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs). As edições Community e Business não usam cobrança por créditos.

## Dicas
- **Bloqueie antes de dar a instrução.** Um objeto bloqueado precisa voltar sem alterações, e o Nodaro verifica isso depois que o modelo responde.
- **Use edições diretas para valores exatos.** Quando você sabe o número, como a altura da câmera ou a posição de um objeto, digite-o na prévia. É instantâneo e gratuito.
- **Compare antes de renderizar.** As revisões anteriores ficam na lista de revisões, então você pode comparar versões e restaurar uma antes de exportar.
- **Corte antes as referências de vídeo.** Uma referência de vídeo é usada como um clipe inteiro. Use o [**Cortar vídeo** (Trim Video)](https://nodaro.ai/docs/nodes/video/trim-video) para manter só a parte de que você precisa.

## Pela API
O `POST /v1/3d-scene/edit` recebe o `scenePlan`, o `expectedRevisionId` e um `prompt` ou uma lista de `operations`. Uma requisição baseada em uma revisão desatualizada é recusada. Uma edição bem-sucedida retorna um job cujo `output_data.scenePlan` traz a nova revisão, junto com um `changeSummary`.

| Operação | Campos |
| --- | --- |
| `set-object` | `objectId`, `changes` (qualquer campo do objeto, exceto o id) |
| `add-object` | `object` |
| `remove-object` | `objectId` |
| `set-camera` | `changes` |
| `set-lighting` | `changes` |
| `set-background` | `color` |

```typescript
const edited = await client.nodes.runAndWait("edit-3d-scene", {
scenePlan: scene.scenePlan,
expectedRevisionId: scene.scenePlan.revisionId,
operations: [{ op: "set-camera", changes: { focalLengthMm: 50 } }],
});
```

- **As operações mudam exatamente os campos que você envia.** Para mudar uma pose com quadros-chave, inclua as mudanças dos quadros-chave dela.
- **Bloqueios.** `lockedObjectIds` lista os objetos que precisam voltar sem alterações.
- **Referências.** As novas referências se juntam às existentes pelo id, e o mesmo id substitui uma referência. Envie `replaceReferences: true` com a lista completa para substituir todas, ou com uma lista vazia para removê-las.
- **Mecanismos avançados.** Uma cena feita por um mecanismo avançado é editada nesse mecanismo, e um pedido para usar o Básico é recusado. Uma edição por instrução em um mecanismo avançado informa os mesmos detalhes que uma cena nova, incluindo resultados entregues sem a aprovação da revisão visual e rascunhos mantidos de execuções que falharam. Veja [Renderização 3D Pro](https://nodaro.ai/docs/nodes/video/pro-3d-render#what-happens-when-a-run-does-not-pass).

Os assistentes de IA usam a ferramenta MCP `edit_3d_scene`, com `locked_object_ids` para os bloqueios. Veja [Cenas 3D pelo MCP](https://nodaro.ai/docs/mcp/3d-scenes).

## Frequently asked questions

### Editar uma cena 3D custa créditos?

As edições diretas na prévia e as operações de edição da API são gratuitas, porque nenhum modelo é executado. Uma instrução de edição aciona o modelo de IA e custa 11, 33 ou 44 créditos no Nodaro Cloud, para um modelo Econômico, Padrão ou Premium.

### Como mantenho um objeto exatamente como está?

Bloqueie-o na lista de objetos da prévia antes de executar a instrução. Depois que o modelo responde, o Nodaro verifica se todos os objetos bloqueados voltaram sem alterações.

### Posso editar um MP4 com o Editar cena 3D?

Não. Um MP4 não é uma cena editável. Para trabalhar a partir de um vídeo, conecte-o como referência ao Gerar cena 3D e edite a cena que ele criar.

### Posso voltar a uma versão anterior?

Sim. Cada edição cria uma nova revisão e mantém a antiga. Escolha qualquer revisão na lista de revisões para torná-la ativa de novo.

### O que acontece se uma edição do modelo terminar depois que eu mudei a cena à mão?

As suas edições continuam ativas. Um aviso oferece “Usar a nova” ou “Manter a minha”, então nada do que você fez à mão se perde.