Predefinições

Uma predefinição é um conjunto salvo, com nome, das configurações de um nó: o prompt, o modelo, a proporção, a voz e todos os outros parâmetros. Você salva uma configuração uma vez e a carrega em qualquer nó do mesmo tipo com um clique. O Nodaro traz predefinições de fábrica para os nós mais usados, e você pode salvar, organizar e compartilhar as suas.

Como funciona

Todo nó com configurações tem predefinições, e um novo tipo de nó as recebe automaticamente. Os nós sem configurações, como uma nota adesiva, e os nós de entidade, como Personagem (Character), Local (Location) e Objeto/adereço (Object), não têm menu de predefinições.

Usar uma predefinição

O menu de predefinições fica em dois lugares: no topo do painel de configurações, abaixo do nome do nó, e no próprio nó, na barra de ferramentas que aparece quando você passa o mouse sobre ele. Até você escolher uma predefinição, o menu mostra PREDEFINIÇÃO.

Depois que você aplica uma predefinição, o nome dela aparece no menu. Quando você altera uma das configurações dela, um * aparece ao lado do nome, para você saber que o nó não corresponde mais à predefinição. Não é possível aplicar uma predefinição enquanto o nó está em execução.

Tudo o que há no menu de predefinições

Marcadores e valores padrão

Os prompts de fábrica usam a mesma sintaxe das variáveis de prompt. Um marcador com valor padrão, como {brand || a modern tech startup}, dá um resultado sensato mesmo quando você executa a predefinição sem alterações. Há três formas de preenchê-lo:

1. Execute como está. Cada marcador usa o valor padrão.
2. Digite por cima. Substitua o marcador inteiro pelas suas palavras, como “a family bakery”.
3. Conecte um nó com o mesmo nome. Um nó Texto (Text) com o rótulo “brand” preenche {brand} na execução, para que nós anteriores ou as pessoas que usam o seu app possam defini-lo.

O que uma predefinição salva

Uma predefinição salva a configuração reutilizável do nó: o prompt, o modelo, a proporção, a resolução, a qualidade, a seed, a voz, o estilo, as configurações numéricas e o texto antes e depois do nó.

Uma predefinição nunca salva:

• Resultados. Imagens e vídeos gerados e estados de execução são resultados, não configurações.
• O rótulo do nó. Aplicar uma predefinição nunca renomeia o seu nó.
• Conexões. As conexões pertencem a um workflow, então uma predefinição as deixa como estão.
• Planos gerados. O plano criado por um nó Gráficos animados (Motion Graphics), Composição de camadas (Composite), Efeitos de vídeo (After Effects), Título 3D (3D Title) ou Sobreposição Lottie (Lottie Overlay) é um resultado. Aplicar uma predefinição apaga esse plano, para que uma animação antiga nunca apareça com configurações novas.

Uma predefinição aplica o modelo junto com as configurações desse modelo. Quando você aplica uma predefinição feita para outro modelo, qualquer configuração que não sirva para o novo modelo é ajustada automaticamente.

Texto antes e depois. Uma predefinição que traz conteúdo de prompt, seja um prompt ou um texto antes e depois, substitui o texto antes e depois do nó. Uma predefinição que só altera configurações não mexe no seu prompt nem no seu texto antes e depois. Guarde o texto reutilizável de uma predefinição no texto antes e depois dela, para que o campo de prompt fique livre para o seu assunto.

Organizar suas predefinições

Clique em Gerenciar predefinições… para abrir a caixa de diálogo de gerenciamento das suas predefinições:

• Nova pasta cria uma pasta recolhível, e Nova seção cria um título sempre aberto no nível superior.
• O menu Nível superior em uma linha move uma predefinição para uma pasta ou uma seção.
• Mover para cima e Mover para baixo mudam a ordem de pastas, seções e predefinições.
• Descrição (opcional) adiciona uma descrição curta, que aparece sob o nome e entra na pesquisa.
• adicionar tag… adiciona tags, que a pesquisa do menu também considera.
• Renomeie pastas e predefinições ali mesmo. Excluir uma pasta devolve as predefinições dela ao nível superior, então nenhuma predefinição se perde.

No menu de predefinições, suas pastas e seções aparecem na ordem que você definiu, em Minhas predefinições. A faixa Favoritos no topo reúne tanto predefinições de fábrica quanto as suas.

Predefinições de fábrica para imagens

Gerar imagem (Generate Image) tem o maior catálogo de fábrica. Cada predefinição escolhe o melhor modelo e a melhor proporção para a tarefa dela, por exemplo um modelo bom em escrever texto, para logotipos e miniaturas.

As pastas Assunto estilizado e Edições também estão em Modificar imagem (Modify Image).

Predefinições de fábrica para vídeo

As predefinições de Gerar vídeo (Generate Video) giram em torno do trabalho de câmera. Cada uma escolhe um modelo adequado, uma proporção e uma duração que o modelo aceita, e adiciona um prompt negativo ajustado contra distorção, cintilação e deformação. As predefinições para redes sociais usam 9:16.

Predefinições de fábrica para outros nós

Junção contínua (tomada única) corrige o pequeno salto entre clipes que continuam um ao outro, como clipes feitos a partir de um storyboard de quadros iniciais e finais. Ela mantém um corte seco, corta 4 quadros do fim de cada clipe e 3 do início, e faz um fade cruzado no áudio.

As predefinições de Gráficos animados sobrescrevem o prompt e as configurações de canvas do nó e apagam qualquer plano que o nó já tenha feito. As predefinições de Sobreposição Lottie escrevem os parâmetros delas como marcadores, como {start time || 1 second} e {corner || bottom-right}. Elas não definem a duração do nó, então a sobreposição continua acompanhando o seu vídeo.

Formato do arquivo exportado

Um arquivo exportado é um JSON com versão:

{
  "kind": "nodaro.node-presets",
  "version": 1,
  "exportedAt": "2026-06-05T12:00:00.000Z",
  "presets": [
    {
      "nodeType": "generate-image",
      "name": "Cinematic Portrait",
      "description": "Moody, shallow-depth portrait look.",
      "data": { "provider": "nano-banana-pro", "aspectRatio": "9:16" }
    }
  ]
}

Quando você importa uma predefinição cujo nome já existe para aquele nó, o Nodaro mantém as duas e adiciona “(imported)” ao nome da nova. A importação nunca sobrescreve uma predefinição.

Pela API

Você cria e edita predefinições no editor. Código e assistentes de IA podem lê-las:

• REST: GET /v1/node-presets lista as suas predefinições, GET /v1/node-preset-groups lista as suas pastas e seções, e GET /v1/node-presets/factory?nodeType=generate-image lista o catálogo de fábrica de um nó. Os tokens OAuth precisam do escopo presets:read. Veja Predefinições.
• SDK: client.presets.list(), client.presets.listGroups() e client.presets.listFactory(nodeType).
• CLI: nodaro presets list, com --factory e --node-type, além de nodaro presets groups e nodaro presets export.
• MCP: a ferramenta list_node_presets.

O data de uma predefinição são as configurações do nó: mescle-o aos dados de um nó quando você criar um workflow por código.