Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa
Entidades

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.

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) ou ao Gerar vídeo (Generate Video), ou mencione-o com @ num prompt, e todas as gerações mostram a mesma pessoa.

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.

promptentidadesquadro inicialpromptentidadesPersonagemMayaTexto@maya no mercadoGerar imagemTextoEla se vira e sorriGerar vídeo
Um personagem alimenta uma imagem e o vídeo feito a partir dela, então a mesma pessoa aparece nos dois.

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

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

EntradaAceitaO que faz
PromptNós de texto e seletoresContexto extra para o retrato quando o nó o gera.
EntidadesOutros 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 assuntoCaracterísticas a trazer para o retrato deste personagem. Veja Aproveitar características de outras entidades.
SaídaTransportaConecte a
PersonagemA identidade do personagem: o retrato aprovado, a descrição, o papel e o bloqueio de identidadeA entrada Entidades do Gerar imagem, do Gerar vídeo e de outros nós que aceitam personagens
ImagemO retrato como uma imagem simples, sem identidade nem descriçãoQualquer 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.

MenuOpçõesO que faz
Papel, o menu ao lado do nomeref-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 identidadeDesativado (padrão), Suave, RígidoCom 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 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.

GrupoPáginas
RecursosReferências, Seletores, LoRA (Nodaro Cloud)
IdentidadePerfil, Aparência
VisuaisExpressões, Poses, Movimentos, Vídeos de emoção, Folha, Painel
PersonagemVoz, 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).
  • 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

Disponível em Nodaro Cloud

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 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çãoPredefinições
Ângulos da cabeçade frente, 3/4 à esquerda, perfil esquerdo, perfil direito, 3/4 à direita, de trás, em enquadramento de cabeça e ombros
Ângulos do corpoos mesmos ângulos, de corpo inteiro, em pé de forma natural e com os braços relaxados
Variações de iluminaçãoluz 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áginaPredefinições
Expressõesexpressão neutra, sorrindo, com raiva, com surpresa, com tristeza, falando, rindo, com nojo, com medo, sorriso de canto, chorando
Posesem 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 (padrão), Nano Banana 2, GPT Image 2, GPT Image 2.5 Flare, 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, Kling 2.5 Turbo Pro, Kling 3.0, Wan 2.6 I2V e 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çãoO que faz
NomeClique no nome do cartão para editá-lo. O nome é a tag dessa expressão, pose ou clipe.
Gerar igual novamenteExecuta de novo a mesma variação e substitui o cartão.
Adicionar variaçãoExecuta de novo a mesma variação e adiciona o resultado como um novo cartão, para você comparar.
RefinarAltera 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.
ExcluirRemove o cartão.
ImportarAdiciona 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).

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).
  • 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). O clipe com sincronização labial é cobrado por segundo de saída, pela tarifa do nó Sincronização labial (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 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 e as ferramentas MCP.

Perguntas frequentes

Última atualização

Nesta página