Editar cena 3D

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) à entrada Cena dele e exporte o resultado com o Renderizar vídeo (Render Video).

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

Entradas

A saída, Composição, é a nova revisão. Conecte-a ao Renderizar vídeo ou a outro Editar cena 3D.

Configurações

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

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 e edite a cena que ele criar.

Créditos

A renderização é sempre uma etapa separada. Veja Quanto custa a renderização de uma cena 3D. 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) 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.

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.

Os assistentes de IA usam a ferramenta MCP edit_3d_scene, com locked_object_ids para os bloqueios. Veja Cenas 3D pelo MCP.