Papéis de referência

Um papel de referência diz ao modelo o que usar de uma referência: a identidade, a roupa, o fundo, o estilo e mais. Uma referência pode ser uma imagem comum ou uma entidade de personagem, local, objeto ou animal, conectada a um nó Gerar imagem (Generate Image) ou Gerar vídeo (Generate Video). O Nodaro escreve o papel de cada referência no prompt como uma expressão simples, para que o modelo saiba exatamente qual parte de qual imagem usar.

Como um papel aparece no prompt

Uma referência com papel vira uma expressão no prompt final:

Os papéis são os mesmos nos dois nós. Imagens comuns e entidades compartilham uma única sequência, então duas referências nunca recebem o mesmo nome.

Papéis padrão

Uma referência nova começa com o papel mais útil para o tipo dela, então funciona sem nenhuma configuração:

Escolher um papel

Clique na etiqueta de uma referência para abrir o menu de papéis dela. Os papéis mais úteis para aquele tipo aparecem primeiro, e o padrão fica em negrito. Personalizado… está sempre no final, para qualquer papel que não esteja na lista.

Dois papéis viram uma expressão mais completa, para que o prompt continue natural:

Ref only

Ref only envia a referência sem uma expressão sobre o que usar dela. Em um nó de imagem, o prompt diz só reference image A, e em um nó de vídeo, só @image_1, @video_1 ou @audio_1. O modelo vê a referência, mas não recebe instruções de como usá-la. Ref only é o padrão para imagens, vídeos e áudios comuns. Em uma entidade de personagem ou de local, você pode escolhê-lo de propósito; a etiqueta dela passa a mostrar um pequeno selo ref.

Papéis personalizados

Escolha Personalizado… e digite qualquer palavra, como dragon, hoodie ou Danny. Um papel personalizado pode ter até 32 caracteres, e os espaços viram hífens. Ele ocupa o lugar do papel na expressão: the hoodie from reference image A. Um nome próprio é usado como foi escrito: Danny from reference image A.

Combinar várias referências

Conecte várias referências, dê um papel a cada uma e descreva como elas se combinam:

A ordem das referências. As referências são numeradas em uma única sequência. As imagens conectadas a Referências vêm primeiro, depois as entidades conectadas a Entidades, cada uma na ordem em que aparece. A mesma numeração define o prompt e as imagens enviadas ao modelo, então a prévia do prompt final mostra exatamente o que é executado.

Mencionar uma referência pelo nome

Com uma menção @, você pode colocar uma referência exatamente no lugar dela na sua frase.

Personagens e locais

Digite @ no prompt e escolha o personagem ou o local. Uma menção também pode escolher qual imagem enviar, a variação, e o que usar dela, o papel:

No prompt, uma menção é uma etiqueta com dois controles. Clique na miniatura para trocar a imagem: mudar para outra imagem do mesmo personagem mantém o seu papel. Clique no rótulo para trocar o papel: isso mantém a imagem, e Padrão volta ao papel padrão.

Imagens comuns

Dê um Rótulo ao nó Enviar imagem (Upload Image). O rótulo vira o nome de menção da imagem, então um nó com o rótulo Town é @town:1.

As menções são opcionais. Uma imagem sem rótulo continua sendo enviada como antes; ela só não tem um nome para mencionar. Um rótulo que começa com um dígito, como 3D Render, não pode virar nome de menção, então troque o rótulo se quiser mencionar a imagem.

Criaturas e objetos

As entidades Animal/criatura e Objeto/adereço usam a mesma forma curta, com o próprio nome e os próprios papéis. Uma criatura chamada Nessie é @nessie:1, e @nessie:1:markings usa as marcas dela. O editor não sugere essas menções, então digite-as à mão.

A menção importa mais para criaturas e objetos. Uma criatura ou um objeto conectado que você não menciona continua adicionando a própria expressão, no final do prompt. Quando você o menciona, a expressão aparece uma vez, dentro da sua frase, e o modelo a liga ao que você escreveu:

Isso vira “A wide shot of the creature from reference image A rising from the lake”.

Quando dois tipos têm o mesmo nome, vale o primeiro tipo nesta ordem: personagem, local, imagem, criatura, objeto.

Bloquear a identidade de um assunto

Por padrão, o Nodaro não adiciona nenhuma instrução de identidade. As referências se comportam como imagens, e só o papel define o resultado. Quando um assunto não pode mudar, ative o bloqueio de identidade dessa referência. O bloqueio adiciona uma linha antes do resto do prompt:

• Por referência. O bloqueio vem desativado por padrão, e você o ativa em cada referência. O texto nativo é escrito para cada tipo, pessoa, rosto, criatura e local, e você pode substituí-lo pelo seu.
• Por menção. No menu de uma menção de personagem ou de local, ative Bloqueio de identidade. Essa menção passa a ter ~lock, como @kira:1:face~lock, mesmo quando o bloqueio da própria referência está desativado.
• Desativado em uma menção. Digite ~nolock depois de uma menção, como @kira:1:face~nolock. O bloqueio fica desativado nessa menção, mesmo quando o bloqueio da referência está ativado. Uma menção sem nenhum dos dois segue a configuração da referência.

Em um local, o bloqueio mantém o lugar em vez de um rosto:

Pela API

Código e assistentes de IA também podem definir o papel e o bloqueio de identidade de cada referência. Eles os enviam como referências estruturadas nas requisições de geração de imagem e de vídeo. Veja Executar um único nó e a Referência das ferramentas MCP.

Dicas

• Mencione criaturas e objetos. A menção coloca a expressão deles dentro da sua frase, onde o modelo consegue ligá-la à ação que você descreve.
• Bloqueie só o que não pode mudar. Com o bloqueio desativado, o seu prompt fica curto e você mantém controle total do texto. Ative-o para os assuntos cuja identidade precisa se manter.
• Ancore os assuntos recorrentes. Para um personagem que você usa em muitas tomadas, crie uma grade de consistência uma vez e conecte-a como referência.
• Confira o prompt final. Abra a visualização do prompt final no campo de prompt para ver todas as expressões que os seus papéis adicionam.