# Personagem

> Crie no Estúdio de personagens um personagem reutilizável, com retrato, expressões, poses, clipes e voz, e mantenha o mesmo rosto em imagens e vídeos.

Source: https://nodaro.ai/pt-BR/docs/nodes/assets/character

O nó **Personagem** (Character Asset) guarda um personagem reutilizável: um retrato aprovado, uma descrição escrita, conjuntos de expressões, poses, ângulos, variações de iluminação e clipes de movimento, e uma voz. Você cria o personagem no **Estúdio de personagens**, em tela cheia, ou escolhe um que já tem. Conecte o nó ao [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image) ou ao [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video), ou mencione-o com `@` num prompt, e todas as gerações mostram a mesma pessoa.

- Found in: Assets › Characters
- Output: data
- API type: `character`

## Quando usar
- Você quer a mesma pessoa em todas as cenas de uma história, de um vídeo explicativo ou de um anúncio.
- Você precisa de um elenco de vários personagens que continuem distintos em muitas tomadas.
- Você quer uma biblioteca de expressões, um conjunto de poses ou uma folha de turnaround para um personagem.
- Você quer reutilizar um personagem em vários workflows, ou partir de um da Galeria pública.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Entidades › Personagens › Personagem**. Para reutilizar um personagem que você já tem, clique em **Escolher existente** no nó e pule para a última etapa.

### Abrir o Estúdio de personagens
Clique em **Estúdio** no nó, ou em **Abrir estúdio de personagens** no painel de configurações. O estúdio abre na página **Perfil**.

### Descrever o personagem e gerar um retrato
Digite um nome e uma descrição, e escolha o gênero e o estilo. Se quiser, defina os **Seletores** e adicione **Referências** antes, porque eles moldam o primeiro retrato. Gere o retrato e aprove o que você quer manter.

### Adicionar variações
Gere expressões, poses, ângulos, variações de iluminação ou clipes de movimento nas páginas de **Identidade** e **Visuais**. Todos eles partem do retrato aprovado.

### Usar o personagem
Feche o estúdio. Conecte a saída **Personagem** do nó à entrada **Entidades** do Gerar imagem ou do Gerar vídeo, ou digite `@` e o nome do personagem no prompt deles.

Workflow: Um personagem alimenta uma imagem e o vídeo feito a partir dela, então a mesma pessoa aparece nos dois.

- Texto → Gerar imagem (prompt)
- Personagem → Gerar imagem (entidades)
- Gerar imagem → Gerar vídeo (quadro inicial)
- Texto → Gerar vídeo (prompt)
- Personagem → Gerar vídeo (entidades)

## O nó no canvas
O nó é um resumo compacto do personagem. Ele mostra:

- O retrato aprovado, o nome do personagem, e o estilo e o gênero dele.
- Um menu de papel, ao lado do nome do personagem, e um menu **Bloqueio de identidade**. Veja [Papel e bloqueio de identidade](#role-and-identity-lock).
- O número de expressões, poses e clipes de movimento.
- Se uma voz e uma personalidade estão definidas.
- Um botão **Estúdio**, que abre o Estúdio de personagens.
- Um botão **Escolher existente**, que vira **Substituir** quando o nó já tem um personagem. Veja [Escolher um personagem existente](#choose-an-existing-character).

Toda a edição acontece no Estúdio de personagens. O painel de configurações mostra um resumo, um botão **Abrir estúdio de personagens**, a linha **Escolher na biblioteca ou na galeria** e o menu **Bloqueio de identidade**.

## Entradas e saídas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Prompt** | Nós de texto e seletores | Contexto extra para o retrato quando o nó o gera. |
| **Entidades** | Outros nós Personagem, **Criar rosto** (Create Face), **Local** (Location Asset), **Objeto/adereço** (Object/Props Asset) e **Animal/criatura** (Animal/Creature Asset), nós de texto e seletores de assunto | Características a trazer para o retrato deste personagem. Veja [Aproveitar características de outras entidades](#borrow-features-from-other-assets). |

| Saída | Transporta | Conecte a |
| --- | --- | --- |
| **Personagem** | A identidade do personagem: o retrato aprovado, a descrição, o papel e o bloqueio de identidade | A entrada **Entidades** do Gerar imagem, do Gerar vídeo e de outros nós que aceitam personagens |
| **Imagem** | O retrato como uma imagem simples, sem identidade nem descrição | Qualquer entrada de imagem, como **Referências** ou **Quadro inicial** |

## Papel e bloqueio de identidade
Quando o personagem chega a um modelo de imagem ou de vídeo, a imagem dele é descrita ao modelo com uma expressão curta, como *the person from reference image A*. Dois menus no nó definem os padrões dessa expressão.

| Menu | Opções | O que faz |
| --- | --- | --- |
| Papel, o menu ao lado do nome | `ref-only`, `person` (padrão), `face`, `clothes`, `hair`, `pose`, `expression`, `style` ou **Personalizado…** | Qual parte da imagem o modelo deve usar. `person` significa o assunto inteiro. Um papel personalizado, como `earrings`, é usado do jeito que você o digita. `ref-only` anexa a imagem sem nenhuma expressão. |
| **Bloqueio de identidade** | **Desativado** (padrão), **Suave**, **Rígido** | Com que intensidade o modelo precisa manter o rosto. **Desativado** não adiciona nenhuma instrução de identidade. **Suave** pede ao modelo que preserve a semelhança geral. **Rígido** diz a ele para reproduzir o rosto exatamente. |

Os dois padrões valem nos nós de imagem e de vídeo, seja o personagem mencionado com `@`, anexado pela entrada **Entidades** ou adicionado como referência extra, e também nas execuções pela API, pelo SDK e pelo MCP. Cada linha de bloqueio cita a imagem de referência dela, então uma cena com vários personagens continua clara.

Uma única menção pode substituir os padrões. Escolha outro papel na etiqueta da menção, ou adicione `~lock` ou `~nolock` à menção, por exemplo `@maya:1:face~lock`. Leia [Papéis de referência](https://nodaro.ai/docs/guides/reference-roles) para ver todos os papéis e a sintaxe completa das menções.

## O Estúdio de personagens
O Estúdio de personagens é um editor em tela cheia com uma barra lateral de páginas em quatro grupos. Ele salva enquanto você trabalha: um indicador **Salvando… / Salvo** mostra o estado, e não há botão Salvar.

| Grupo | Páginas |
| --- | --- |
| **Recursos** | Referências, Seletores, LoRA (Nodaro Cloud) |
| **Identidade** | Perfil, Aparência |
| **Visuais** | Expressões, Poses, Movimentos, Vídeos de emoção, Folha, Painel |
| **Personagem** | Voz, Personalidade |

A geração roda no servidor. Se você fechar o estúdio, a aba ou o navegador enquanto uma imagem ou um clipe está sendo gerado, o resultado ainda é adicionado ao personagem, e o espaço reservado dele reaparece quando você abre o estúdio de novo.

### Perfil
A página **Perfil** guarda o retrato e a identidade principal. Ela tem o nome, a descrição, o gênero (masculino, feminino ou outro), o estilo (realista, anime, 3D estilo Pixar ou ilustração), a roupa base, o modelo de imagem e um prompt inicial que enquadra o retrato.

Gere o retrato aqui. Quando uma execução faz vários candidatos, escolha o que vai ficar e aprove-o. Aprovar um retrato também escreve a **descrição canônica** do personagem, uma descrição visual detalhada que é enviada com o personagem nas gerações seguintes. Sem ela, o rosto varia mais entre as cenas.

### Referências
A página **Referências** guarda fotos reais da pessoa, até sete, uma por enquadramento: rosto de frente, lado esquerdo, lado direito, 3/4 à esquerda, 3/4 à direita, corpo de frente e outro. As fotos dão aos modelos mais detalhes para reproduzir, então as imagens geradas ficam mais próximas da pessoa real.

### Seletores
A página **Seletores** tem dois seletores estruturados cujas escolhas são adicionadas automaticamente aos prompts do retrato e das variações do próprio personagem:

- **Pessoa**: atributos de aparência, como cabelo, olhos, porte físico, idade, etnia, pele e rosto. É o mesmo catálogo do seletor [**Pessoa** (Person)](https://nodaro.ai/docs/nodes/creative-controls/person).
- **Figurino**: arquétipo, parte de cima, parte de baixo, agasalhos, calçados, chapéus, acessórios, paleta de cores, material e época.

Os seletores afetam só o retrato e as variações deste personagem. Você não os conecta a nada.

### LoRA
A página **LoRA** treina um modelo do personagem a partir das imagens do próprio personagem. Ela só está disponível no Nodaro Cloud e fica oculta nas instalações self-hosted.

1. A página mostra todas as imagens elegíveis: o retrato, as fotos de referência, as expressões, as poses, os ângulos da cabeça e do corpo e as variações de iluminação. Todas vêm selecionadas. Desmarque as que você não quer.
2. Mantenha pelo menos 4 imagens selecionadas. Um contador mostra quantas estão selecionadas.
3. Clique em **Treinar modelo de alta fidelidade**. O botão mostra o preço em créditos, e o treinamento leva cerca de 15 minutos.

Quando o treinamento dá certo, a página mostra a palavra de ativação do modelo. **Treinar novamente** substitui o modelo usando as imagens selecionadas no momento, e **Remover** o exclui. Leia [Treinamento de personagens](https://nodaro.ai/docs/guides/character-training) para saber como um personagem treinado é usado nas gerações.

### Aparência
A página **Aparência** faz variações de ângulo e de iluminação do retrato aprovado, em três seções:

| Seção | Predefinições |
| --- | --- |
| **Ângulos da cabeça** | de frente, 3/4 à esquerda, perfil esquerdo, perfil direito, 3/4 à direita, de trás, em enquadramento de cabeça e ombros |
| **Ângulos do corpo** | os mesmos ângulos, de corpo inteiro, em pé de forma natural e com os braços relaxados |
| **Variações de iluminação** | luz do dia, noite, luz dramática |

### Expressões e poses
As páginas **Expressões** e **Poses** fazem imagens fixas do personagem a partir do retrato aprovado.

| Página | Predefinições |
| --- | --- |
| **Expressões** | expressão neutra, sorrindo, com raiva, com surpresa, com tristeza, falando, rindo, com nojo, com medo, sorriso de canto, chorando |
| **Poses** | em pé, caminhando, posição sentada, correndo, de cócoras, apontando, postura de luta, pulando, virando |

Cada página tem uma barra de geração com chips de predefinição, um campo para o seu próprio prompt, um menu de modelos e um botão **Gerar**. **Gerar tudo** coloca na fila todas as predefinições que ainda faltam e pede uma confirmação antes quando iniciaria 4 gerações ou mais. Cada botão e cada chip mostra o custo em créditos para o modelo escolhido.

O menu de modelos oferece [Nano Banana Pro](https://nodaro.ai/docs/models/image/nano-banana-pro) (padrão), [Nano Banana 2](https://nodaro.ai/docs/models/image/nano-banana-2), [GPT Image 2](https://nodaro.ai/docs/models/image/gpt-image-2), [GPT Image 2.5 Flare](https://nodaro.ai/docs/models/image/gpt-image-2-5-flare), [GPT Image 2.5 Sunburst](https://nodaro.ai/docs/models/image/gpt-image-2-5-sunburst) e Seedream 4.5.

### Movimentos
A página **Movimentos** faz clipes de vídeo curtos do personagem em movimento, a partir do retrato aprovado. Ela precisa de um retrato aprovado antes. As predefinições são caminhando, correndo, acenando, sentando, postura de luta, pulando, dando meia-volta, dançando e gesticulando ao falar.

Os clipes usam modelos de imagem para vídeo: [Kling 2.6](https://nodaro.ai/docs/models/video/kling-2-6), [Kling 2.5 Turbo Pro](https://nodaro.ai/docs/models/video/kling-2-5-turbo-pro), [Kling 3.0](https://nodaro.ai/docs/models/video/kling-3-0), [Wan 2.6 I2V](https://nodaro.ai/docs/models/video/wan-2-6-i2v) e [Wan 2.7 I2V](https://nodaro.ai/docs/models/video/wan-2-7-i2v). Um clipe custa o mesmo que a mesma geração de imagem para vídeo nesse modelo. Os clipes de movimento não têm a ação de refinar nem **Gerar tudo**.

### Ações em cada cartão
| Ação | O que faz |
| --- | --- |
| Nome | Clique no nome do cartão para editá-lo. O nome é a tag dessa expressão, pose ou clipe. |
| **Gerar igual novamente** | Executa de novo a mesma variação e substitui o cartão. |
| **Adicionar variação** | Executa de novo a mesma variação e adiciona o resultado como um novo cartão, para você comparar. |
| **Refinar** | Altera uma imagem existente com um prompt, como “a wider smile”, e substitui o cartão ou adiciona o resultado como um novo cartão. Só para imagens. |
| **Excluir** | Remove o cartão. |
| **Importar** | Adiciona uma imagem ou um vídeo que você já tem, sem gerar. Todas as páginas visuais têm essa ação. |

### Vídeos de emoção
A página **Vídeos de emoção** mostra clipes de vídeo de referência do personagem, agrupados por emoção, quando o personagem tem algum.

### Folha
A página **Folha** monta uma folha de turnaround, de expressões ou de referência a partir das imagens do personagem. Veja o nó [**Folha de referência** (Reference Sheet)](https://nodaro.ai/docs/nodes/image/reference-sheet).

### Painel
A página **Painel** faz painéis de identidade. Um painel de identidade é uma única imagem densa em 4K que combina de 2 a 12 imagens do próprio personagem, como o retrato, expressões, poses, ângulos, iluminação, figurino, closes, folhas e fotos de referência. Um painel é a referência de imagem única mais forte para as gerações seguintes.

- **Novo painel** abre uma janela de seleção com todas as imagens do personagem, agrupadas por tipo. Selecione de 2 a 12 imagens. Um número em cada uma mostra o lugar dela no painel. **Gerar** faz o painel pelo preço em 4K do nó [**Colagem de imagens** (Image Collage)](https://nodaro.ai/docs/nodes/image/image-collage).
- **Duplicar** reabre a janela de seleção com as mesmas imagens selecionadas, para você testar uma variação. A cópia recebe um novo nome, como “Vestido de gala 2”, e nunca substitui a original.
- Para **renomear** um painel, clique na legenda dele. Pressione Enter ou clique fora para salvar, e Esc para cancelar.
- **Excluir** remove um painel depois da sua confirmação.
- **Cancelar**, num painel em geração, interrompe a geração e reembolsa os créditos dele.

Um personagem pode ter até 12 painéis. No menu de menções `@`, os painéis de um personagem aparecem primeiro, marcados como “painel”.

### Voz
A página **Voz** dá uma voz ao personagem:

- **Explorar**: as vozes prontas, a biblioteca pública de vozes e as vozes personalizadas que você já tem, com pesquisa e prévia.
- **Criar a partir de texto**: descreva uma voz, como “um velho contador de histórias, de voz calorosa e rouca”, e ouça-a. Uma voz criada assim serve só para ouvir e não é salva para reutilização.
- Adicione **traços de voz**, como “grave, calma, sotaque britânico”, à voz escolhida.
- **Fala**: digite uma frase e clique em **Falar** para ouvir o personagem dizê-la. Com um retrato aprovado, **Falar + sincronização labial do retrato** também faz um clipe curto do retrato dizendo a frase.

**Falar** custa o mesmo que o [**Texto para fala** (Text to Speech)](https://nodaro.ai/docs/nodes/audio/text-to-speech). O clipe com sincronização labial é cobrado por segundo de saída, pela tarifa do nó [**Sincronização labial** (Lip Sync)](https://nodaro.ai/docs/nodes/video/lip-sync).

### Personalidade
A página **Personalidade** guarda quatro anotações sobre o personagem: **Humor / temperamento**, **Estilo de fala**, **Estilo de movimento** e **Notas de comportamento**. Elas são salvas com o personagem para a sua consulta. Os outros nós não as leem.

## Aproveitar características de outras entidades
A entrada **Entidades** do nó Personagem traz características de outras entidades para o retrato deste personagem. Para cada nó Personagem, Criar rosto, Local, Objeto/adereço ou Animal/criatura conectado a ela, o nó mostra uma linha **Injetar no retrato** com um menu de características:

**Full likeness** (semelhança completa; padrão), **Hair** (cabelo), **Skin tone** (tom de pele), **Face** (rosto), **Style** (estilo), **Outfit** (roupa) ou **Personality** (personalidade).

Por exemplo, conecte um primeiro personagem e escolha **Hair** para dar a um segundo personagem o mesmo cabelo. A característica escolhida é tirada da descrição da entidade conectada quando o retrato é gerado. Os nós de texto e os seletores de assunto conectados a **Entidades** adicionam as palavras deles ao prompt do retrato.

## Escolher um personagem existente
Em vez de criar um personagem, você pode usar um que já tem. Clique em **Escolher existente** no nó, ou em **Escolher na biblioteca ou na galeria** no painel de configurações. A janela de seleção tem duas abas:

- **Minha biblioteca**: os personagens que você salvou.
- **Galeria pública**: personagens compartilhados com todos. Ao escolher um, ele é copiado primeiro para a sua biblioteca, e o nó usa a sua cópia. A Galeria pública está disponível no Nodaro Cloud e na Business edition.

Quando o nó já tem um personagem, os botões passam a mostrar **Substituir**, para você trocar por outro personagem. O nó recebe o personagem inteiro: o retrato, todas as variações, a voz e a personalidade, então os nós conectados a ele passam a usar o novo personagem na hora.

- Se você escolher um personagem da galeria que já copiou antes, a janela de seleção pergunta se você quer usar a sua cópia ou **Fazer nova cópia**, para que as cópias não se acumulem.
- Para remover um personagem de **Minha biblioteca**, passe o cursor sobre o cartão dele e clique no ícone de lixeira. O personagem é arquivado e pode ser restaurado, e os nós que já o usam continuam funcionando.

Leia [Biblioteca da comunidade](https://nodaro.ai/docs/guides/community-library) para saber como funcionam os personagens compartilhados.

## Créditos
As gerações no estúdio são cobradas pelo preço do modelo que você escolhe, e todo botão **Gerar** e todo chip de predefinição mostram esse preço.

- Um clipe de movimento custa o mesmo que a mesma geração de imagem para vídeo nesse modelo.
- Um painel custa o preço em 4K do nó Colagem de imagens.
- **Falar + sincronização labial do retrato** é cobrado por segundo de saída.
- Treinar um LoRA custa créditos.

## Dicas
- **Defina os Seletores e as Referências antes do primeiro retrato.** As escolhas deles moldam já o primeiro retrato, que fica mais perto do que você quer.
- **Aprove o retrato primeiro.** Todas as expressões, poses, ângulos e clipes partem dele, e os clipes de movimento precisam dele.
- **Escreva uma descrição detalhada.** Fale do rosto, do porte físico, do cabelo e das roupas. Os seletores cuidam da parte estruturada.
- **Compare antes de substituir.** Use **Adicionar variação** para manter o cartão atual e tentar de novo ao lado dele.
- **Refine em vez de gerar de novo.** Use **Refinar** para mudar uma coisa, como “a wider smile”, sem começar do zero.
- **Mantenha um estilo por projeto.** Use o mesmo estilo em todos os personagens de um projeto, para que pareçam do mesmo universo.
- **Treine quando tiver imagens variadas.** No Nodaro Cloud, treine um LoRA com as imagens mais limpas e fiéis ao personagem, no mínimo 4.

## Pela API
Todas as operações do estúdio também estão disponíveis para código e para assistentes de IA: criar um personagem, gerar e aprovar o retrato, adicionar variações e clipes de movimento, e arquivá-lo ou restaurá-lo. Veja [Personagens](https://nodaro.ai/docs/developers/api/characters) e as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Frequently asked questions

### Como mantenho o mesmo personagem em todas as imagens e vídeos?

Aprove um retrato no Estúdio de personagens e conecte o nó Personagem à entrada Entidades do Gerar imagem ou do Gerar vídeo, ou mencione-o com @ no prompt. O Nodaro envia a imagem aprovada e a descrição do personagem em todas as execuções.

### O que o Bloqueio de identidade faz?

Ele define com que intensidade os modelos de imagem e de vídeo precisam manter o rosto do personagem. Desativado, o padrão, não adiciona nenhuma instrução de identidade. Suave pede ao modelo que preserve a semelhança geral. Rígido diz a ele para reproduzir o rosto exatamente.

### Posso usar um personagem que outra pessoa criou?

Sim, no Nodaro Cloud e na Business edition. Clique em Escolher existente no nó e abra a aba Galeria pública. Primeiro o personagem é copiado para a sua biblioteca, e o nó usa a sua cópia.

### Como dou uma voz ao meu personagem?

Abra a página Voz do Estúdio de personagens e escolha uma voz da biblioteca de vozes, ou descreva uma para criá-la. Digite uma frase em Fala para ouvir o personagem dizê-la, ou para fazer um clipe curto do retrato com sincronização labial.

### Posso treinar um modelo do meu personagem?

No Nodaro Cloud, sim. A página LoRA do Estúdio de personagens treina um modelo do personagem a partir de pelo menos 4 imagens do próprio personagem. O treinamento custa créditos.

### O que acontece se eu fechar o estúdio enquanto as imagens são geradas?

Nada se perde. A geração continua no servidor, e cada imagem ou clipe concluído é adicionado ao personagem, mesmo se você fechar a aba ou recarregar a página.