NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Vídeo

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.

cenacomposiçãoGerar cena 3DPrimeira marcaçãoEditar cena 3DAbaixar a câmeraRenderizar vídeoMP4 de massinha
Uma cena gerada é revisada com uma instrução de edição e depois exportada como um MP4 de massinha.

Entradas

EntradaAceitaO que faz
CenaA saída Composição do Gerar cena 3D, do Editar cena 3D ou do nó Renderização 3D ProA cena a mudar. Obrigatória.
ReferênciasNós de imagem e de vídeoOpcional. 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çãoO que faz
Mecanismo de criaçãoAparece 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 IAO 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ínioAparece 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çãoA mudança, com palavras simples.
ReferênciasUm papel para cada referência conectada: Aparência, Layout ou Movimento.
Texto antes e depoisTexto 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çãoEdições diretas
ComoEscreva a mudança e clique em ExecutarMude valores na prévia ou envie operações de edição pela API
Modelo de IASim, o modelo que você escolherNão
CréditosOs tokens que o modelo usou, pela tarifa dele, no Nodaro CloudGrátis
ResultadoUma nova revisãoUma 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çãoCréditos no Nodaro Cloud
Edições diretas e operações de edição da APIGrátis
Uma instrução de ediçãoOs 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ídeoO preço da Análise de vídeo para esse vídeo
Renderizar a nova revisão com o Renderizar vídeo55 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çãoCampos
set-objectobjectId, changes (qualquer campo do objeto, exceto o id)
add-objectobject
remove-objectobjectId
set-camerachanges
set-lightingchanges
set-backgroundcolor
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.

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.

Última atualização

Nesta página