# Papéis de referência

> Dê a cada referência um papel, como rosto, roupa, fundo ou estilo, bloqueie a identidade quando precisar e mencione as referências pelo nome no prompt.

Source: https://nodaro.ai/pt-BR/docs/guides/reference-roles

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)](https://nodaro.ai/docs/nodes/image/generate-image) ou [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/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:

| Nó | A expressão | Como as referências são nomeadas |
| --- | --- | --- |
| Gerar imagem | `the {role} from reference image A` | Por letra: A, B, C |
| Gerar vídeo | `the {role} from @image_1` | Por número: `@image_1`, `@image_2` |

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:

| Origem conectada | Papel padrão |
| --- | --- |
| [**Personagem** (Character Asset)](https://nodaro.ai/docs/nodes/assets/character) | person |
| [**Local** (Location Asset)](https://nodaro.ai/docs/nodes/assets/location) | location |
| [**Objeto/adereço** (Object/Props Asset)](https://nodaro.ai/docs/nodes/assets/object) | object |
| [**Animal/criatura** (Animal/Creature Asset)](https://nodaro.ai/docs/nodes/assets/creature) | creature |
| [**Criar rosto** (Create Face)](https://nodaro.ai/docs/nodes/assets/create-face) | face |
| Imagem comum ou enviada | Ref only |
| Vídeo ou áudio | Ref only |

## 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.

| Origem | Papéis que você pode escolher |
| --- | --- |
| **Personagem** | Ref only, **person**, face, clothes, hair, pose, expression, style |
| **Local** | Ref only, **location**, background, atmosphere, as-is, empty background, layout, lighting, style |
| **Objeto** | **object**, shape, material, color, texture, style |
| **Animal ou criatura** | **creature**, anatomy, markings, pose, color, style |
| **Imagem comum** | **Ref only**, object, person, face, clothes, background, style, pose, texture |

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

| Papel | Vira |
| --- | --- |
| as-is | `reference image A, used as-is` |
| empty background | `the background from reference image A (without its foreground objects)` |

### 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 portrait of the person from reference image A wearing the clothes from reference image B, standing in the background from reference image C, lit by the lighting from reference image D.
```

Workflow: Um personagem fornece a pessoa, uma foto fornece a roupa e outra fornece o fundo.

- Enviar imagem → Gerar imagem (referências)
- Enviar imagem → Gerar imagem (referências)
- Personagem → Gerar imagem (entidades)

**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**:

| Menção | O que faz |
| --- | --- |
| `@abi:1:walking:clothes` | Envia a imagem de Abi andando e adiciona `the clothes from reference image A` |
| `@abi:1:walking:ref-only` | Envia a imagem de Abi andando apenas como `reference image A` |
| `@library:1:weather/rain:lighting` | Envia a variação chuvosa do local e usa a iluminação dela |

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)](https://nodaro.ai/docs/nodes/image/upload-image). O rótulo vira o nome de menção da imagem, então um nó com o rótulo `Town` é `@town:1`.

| Menção | O que faz |
| --- | --- |
| `@town:1` | Coloca `reference image A` exatamente onde você digitou |
| `@town:1:background` | Coloca `the background from reference image A` |
| `@town:1:signage` | Usa uma palavra personalizada qualquer como papel |
| `@town:1~lock` ou `@town:1~nolock` | Ativa ou desativa o bloqueio de identidade nesta menção |

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:

```
A wide shot of @nessie:1 rising from the lake
```

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:

```
Lock the exact identity of the person in reference image A — face, bone structure, skin tone, all unique features.
```

- **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:

```
Lock the exact look of reference image A — match the location's architecture, layout, and lighting.
```

## 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ó](https://nodaro.ai/docs/developers/api/nodes) e a [Referência das ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## 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](https://nodaro.ai/docs/guides/reference-boards) 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.

## Frequently asked questions

### O que é um papel de referência?

Um papel é um rótulo curto que diz ao modelo qual parte de uma referência usar, como o rosto, as roupas, o fundo ou o estilo. O Nodaro o escreve no prompt como uma expressão do tipo “the clothes from reference image B”.

### Por que a minha referência de imagem comum não tem papel?

Imagens, vídeos e áudios comuns começam como Ref only. O modelo recebe a referência sem instruções sobre o que usar dela. Clique na etiqueta da referência para escolher um papel, como background ou style.

### O que o bloqueio de identidade faz?

Ele adiciona ao prompt uma linha que pede ao modelo que mantenha a identidade exata do assunto daquela referência, como o rosto e a estrutura óssea de uma pessoa. Ele vem desativado por padrão. Ative-o em cada referência que não pode mudar.

### Como menciono uma imagem enviada no prompt?

Dê um rótulo ao nó Enviar imagem, como Town. A imagem passa a ter um nome de menção, @town:1, e @town:1:background diz ao modelo para usar o fundo dela.

### Os papéis funcionam nos nós de imagem e de vídeo?

Sim. Os papéis são os mesmos em Gerar imagem e em Gerar vídeo. Só muda a forma como uma referência é nomeada no prompt: uma letra nos nós de imagem e um número nos nós de vídeo.