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.
O nó Editar cena 3D cria uma nova versão de uma cena 3D existente. Você descreve a mudança com palavras simples, como “Mova o pilar um metro para trás e mantenha inalterado o caminho da mala”. 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 à entrada Cena dele e exporte o resultado com o Renderizar vídeo.
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.
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 | 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 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 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. |
| 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. |
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 | Os tokens que o modelo usou, pela tarifa dele, no Nodaro Cloud | 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 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 | Os tokens que o modelo de IA usou, pela tarifa do modelo. O botão Executar mostra uma estimativa (≈ e um número) de uma edição típica. |
| Uma referência de vídeo | O preço da Análise de vídeo 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 |
Uma instrução de edição é cobrada como a criação de cena do Gerar cena 3D. Uma ediçã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. As regras completas estão em Como as chamadas de LLM são cobradas. 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 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 uma tarefa 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 |
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.
lockedObjectIdslista 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: truecom 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.
Perguntas frequentes
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. No Nodaro Cloud, a chamada é cobrada pelos tokens que usou, pela tarifa do modelo.
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.
Páginas relacionadas
Gerar cena 3D
Renderizar vídeo
Renderização 3D Pro
Cenas 3D
Última atualização
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.
Renderização 3D Pro
Crie uma cena 3D animada a partir de um briefing e renderize-a em uma execução, em um mecanismo hospedado: MP4, cena editável e uma imagem fixa por tomada.