# Estúdio de personagens

> Monte um personagem reutilizável no Estúdio de personagens: gere e aprove um retrato, crie ângulos, expressões, poses e movimentos e dê uma voz a ele.

Source: https://nodaro.ai/pt-BR/docs/guides/character-studio

O **Estúdio de personagens** é o editor em tela cheia onde você monta uma entidade de personagem: o retrato, as imagens e os clipes, a voz e a personalidade dela. Você monta um personagem uma vez. Depois, todos os nós de imagem ou vídeo a que você o conecta trabalham a partir das mesmas imagens aprovadas, então a pessoa tem a mesma aparência em todas as tomadas.

## Abrir o estúdio
1. Pressione Tab no canvas e escolha **Entidades › Personagens › Personagem**.
2. Clique em **Estúdio** no nó. Você também pode selecionar o nó e clicar em **Abrir estúdio de personagens** no painel de configurações.

O estúdio abre em tela cheia na página **Perfil**. Feche o estúdio para voltar ao canvas. O nó [**Personagem** (Character Asset)](https://nodaro.ai/docs/nodes/assets/character) passa a mostrar um resumo do personagem.

## O que cada página faz
A barra lateral agrupa as páginas na ordem em que você costuma trabalhar: as fontes, a identidade, os visuais e a voz do personagem.

| Grupo | Página | O que você faz lá |
| --- | --- | --- |
| **Recursos** | **Referências** | Envie fotos reais da pessoa, uma por ângulo. |
| | **Seletores** | Escolha detalhes estruturados de aparência e de figurino. |
| | **LoRA** | Treine um modelo personalizado com as imagens do personagem. Só no Nodaro Cloud; veja [Treinamento de personagens](https://nodaro.ai/docs/guides/character-training). |
| **Identidade** | **Perfil** | Defina o nome, o retrato, a descrição, o estilo e o bloqueio de identidade. |
| | **Aparência** | Gere ângulos da cabeça, ângulos do corpo e variações de iluminação. |
| **Visuais** | **Expressões** | Gere o rosto com emoções diferentes. |
| | **Poses** | Gere o corpo inteiro em posturas diferentes. |
| | **Movimentos** | Gere clipes curtos de vídeo do personagem em movimento. |
| | **Vídeos de emoção** | Reproduza os clipes de referência guardados para cada emoção. |
| | **Folha** | Monte um turnaround ou uma folha de referência completa. |
| | **Painel** | Monte um painel de identidade denso com as imagens do personagem. |
| **Personagem** | **Voz** | Escolha uma voz e ouça o personagem falar. |
| | **Personalidade** | Escreva notas sobre temperamento, fala e movimento. |

Um número ao lado de uma página conta as imagens ou os clipes dela. Uma marca de seleção mostra que **Voz** ou **Personalidade** está preenchida.

## Montar um personagem passo a passo
### Adicione primeiro as fotos de referência e os seletores
Em **Referências**, envie fotos reais da pessoa. Em **Seletores**, escolha os atributos de aparência e o figurino. Os dois são adicionados a todos os retratos e imagens que o estúdio gera, então o primeiro retrato já fica mais perto do que você quer.

### Preencha o perfil
Em **Perfil**, dê um nome ao personagem e descreva o rosto, o corpo, o cabelo e a roupa. Escolha o estilo e o modelo de imagem.

### Gere e aprove um retrato
Escolha 1, 2 ou 4 **Candidatos** e clique em **Gerar**. Clique no candidato que você quer para aprová-lo. O retrato é a âncora de todas as outras imagens do personagem.

### Monte o conjunto-âncora de identidade
Em **Aparência**, gere os cinco ângulos da cabeça. Todas as imagens que você gerar depois usam esses ângulos como referência, então o rosto continua o mesmo.

### Adicione expressões, poses e movimento
Gere as expressões, as poses e os clipes de que a sua história precisa. Depois, conecte o nó Personagem aos seus nós de imagem e vídeo, como descrito em [Personagens consistentes](https://nodaro.ai/docs/guides/consistent-characters).

Workflow: Um nó Personagem dá ao nó Gerar imagem as imagens aprovadas, preenche a voz do nó Texto para fala e dá ao nó Sincronização labial o retrato.

- Personagem → Gerar imagem (entidades)
- Personagem → Texto para fala
- Texto para fala → Sincronização labial (áudio)
- Personagem → Sincronização labial (retrato)

## Referências e seletores
**Referências** tem sete espaços para fotos reais: **Rosto**, **3/4 E**, **Perfil E**, **Perfil D**, **3/4 D**, **Corpo** e **outro**. Clique em um espaço para enviar uma foto. Os seis espaços com nome guardam uma foto cada, e um novo envio substitui a foto anterior. O espaço **outro** guarda quantas fotos você adicionar.

As fotos reais dão informações extras aos modelos, então as imagens geradas ficam mais perto da pessoa real. O Nodaro envia cada foto para as gerações em que ela se encaixa. Por exemplo, a foto **Rosto** orienta as expressões, e a foto **Corpo** orienta as poses, os ângulos do corpo e os movimentos. Depois que você troca as fotos, a próxima geração usa as novas.

**Seletores** tem dois seletores estruturados. As escolhas deles são salvas com o personagem e adicionadas aos prompts do retrato e das imagens dele, sem nenhuma conexão.

- **Atributos de aparência** — cabelo, olhos, porte físico, idade, etnia, pele, rosto e mais. É 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, agasalho, calçado, chapéu, acessórios, paleta de cores, material e época.

Os seletores e as fotos de referência afetam só as gerações do próprio personagem. Eles não são enviados para outros nós.

## A página Perfil
### Gerar e aprovar o retrato
1. Escolha quantos **Candidatos** gerar: 1, 2 ou 4. O botão **Gerar** mostra o custo total em créditos. Cada candidato custa uma imagem no modelo escolhido.
2. Clique em **Gerar**. Com um candidato, o resultado vira o retrato quando fica pronto.
3. Com dois ou quatro candidatos, clique no que você quer (**Clique para aprovar**). A aprovação interrompe os candidatos que ainda estão sendo gerados.

A aprovação não custa créditos. Ela também escreve a **Descrição canônica**: uma descrição visual do personagem, com 80 a 120 palavras. O estúdio a adiciona a todas as imagens que gera, e os nós de imagem e vídeo conectados podem adicioná-la aos prompts deles. Abra a descrição para ler ou editar, com até 4.000 caracteres. Clique em **Gerar a descrição novamente a partir do retrato atual** para reescrevê-la a partir do retrato atual. Isso custa 8 créditos.

Os candidatos que você gerou, mas não aprovou, ficam em uma faixa **Candidatos anteriores** por 7 dias, até 5 deles. Aprove um deles depois, se mudar de ideia. Passe o mouse sobre o retrato aprovado para ampliá-lo ou copiar a URL dele.

### Campos de identidade
| Campo | O que faz |
| --- | --- |
| **Nome do personagem** | O nome do personagem. Ele também vira o nome que você menciona: `Maya Chen` é `@maya-chen:1`. Um personagem novo começa como “Untitled character”, então renomeie-o. |
| **Descrição da aparência** | O rosto, o tipo físico, o cabelo e a roupa, com as suas palavras. |
| Gênero | **masculino**, **feminino** ou **outro**. |
| Estilo | **realista**, **anime**, **3D estilo Pixar** ou **ilustração**. Use o mesmo estilo para todos os personagens de um projeto. |
| **Roupa base** | A roupa habitual do personagem, em texto livre. Ela é combinada com o seletor **Figurino**. |
| **Bloqueio de identidade** | Com que intensidade as gerações mantêm o rosto: **Desativado**, **Suave** ou **Rígido**. **Desativado** é o padrão. Veja [Bloqueio de identidade](https://nodaro.ai/docs/guides/consistent-characters#lock-the-identity). |
| **URL da imagem de referência** | O endereço do retrato. Cole a URL de uma imagem que você já tem para usá-la como retrato. |
| Modelo de imagem | O modelo do retrato. O [Nano Banana Pro](https://nodaro.ai/docs/models/image/nano-banana-pro) é o padrão. |
| **Prompt base** | Uma descrição curta da identidade para o retrato, como traços físicos, comportamento e características marcantes. Até 4.000 caracteres. |

## Aparência: ângulos e iluminação
A página **Aparência** tem três seções. Aprove um retrato primeiro, porque os ângulos são gerados a partir dele.

| Seção | Predefinições | Enquadramento |
| --- | --- | --- |
| **Ângulos da cabeça** | de frente, 3/4 à esquerda, perfil esquerdo, perfil direito, 3/4 à direita | Cabeça e ombros |
| **Ângulos do corpo** | de frente, 3/4 à esquerda, perfil esquerdo, perfil direito, 3/4 à direita, de trás | Corpo inteiro, em pé e natural, com os braços ao lado do corpo |
| **Variações de iluminação** | luz do dia, noite, luz dramática | O mesmo personagem sob luzes diferentes |

A caixa no topo conta o **Conjunto-âncora de identidade**: os cinco ângulos da cabeça. Depois que você os gera, todas as imagens que o estúdio cria usam esses ângulos como referência. Monte o conjunto antes das expressões e das poses, e os rostos ficam iguais em todas elas.

## Expressões e poses
**Expressões** mostra o rosto com emoções diferentes. **Poses** mostra o corpo inteiro em posturas diferentes.

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

A barra na parte de baixo de cada página funciona do mesmo jeito:

- Clique em uma predefinição para gerá-la. Cada predefinição mostra o custo em créditos.
- Escolha o modelo: [Nano Banana Pro](https://nodaro.ai/docs/models/image/nano-banana-pro) (o 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) ou Seedream.
- **Gerar tudo** coloca na fila todas as predefinições que ainda faltam. O estúdio pede confirmação quando quatro ou mais gerações começariam.
- **Prompt personalizado**, no topo da página, gera qualquer outra variação a partir das suas palavras.
- **Referências reais** anexa fotos reais a uma predefinição, por exemplo um rosto real rindo para **rindo**.
- **Importar** adiciona uma imagem que você já tem a partir da URL dela, sem geração.

### Trabalhar com os cards
Passe o mouse sobre um card para ver as ações dele.

| Ação | O que faz |
| --- | --- |
| **Gerar igual novamente** | Cria uma nova versão da mesma variação e substitui o card. |
| **Adicionar variação** | Cria uma nova versão e mantém o card antigo, para você comparar os dois. |
| **Refinar com img2img** | Altera a imagem com um prompt, como “more intense smile”. Escolha **Substituir** ou **Adicionar como nova**. |
| Renomear | Clique no nome para editá-lo. O nome é a tag que identifica a variação, por exemplo em `@maya:1:smile`. |
| **Definir como padrão para este nó “Personagem”** | Torna esta imagem o padrão do nó. O nó a mostra, e os nós conectados a recebem no lugar do retrato. Clique de novo para desfazer. |
| **Adicionar como nó no canvas** | Coloca a imagem no canvas como um nó próprio. |
| Ampliar, copiar URL, excluir | Veja a imagem em tela cheia, copie o endereço dela ou remova-a. |

Cada nova geração, variação e refinamento custa o mesmo que uma nova imagem no modelo escolhido.

## Movimentos
**Movimentos** reúne clipes curtos de vídeo do personagem, animados a partir das imagens dele. Gere um retrato primeiro; sem ele, **Gerar** fica desativado.

- **Predefinições**: caminhando, correndo, acenando, sentando, postura de luta, pulando, dando meia-volta, dançando, gesticulando ao falar.
- **Modelos**: [Kling 2.6](https://nodaro.ai/docs/models/video/kling-2-6) (o padrão), [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).
- **Custo**: um clipe custa o mesmo que uma execução de imagem para vídeo no mesmo modelo.

Uma imagem de corpo inteiro se anima muito melhor do que um retrato de cabeça e ombros. Por isso, o Nodaro anima o ângulo do corpo **de frente** quando o personagem tem um. Quando o personagem ainda não tem ângulos do corpo, o estúdio primeiro gera um ângulo do corpo de frente e depois o anima.

Os cards de movimento têm **Gerar igual novamente** e **Adicionar variação**, mas não têm refinamento nem **Gerar tudo**. **Importar** adiciona um clipe que você já tem a partir da URL dele.

**Vídeos de emoção** reproduz os clipes de referência guardados para cada emoção, como *angry* ou *happy*. A página só reproduz clipes; ela não os cria.

## Folhas e painéis
**Folha** monta uma folha de referência com as imagens do personagem. Escolha uma predefinição:

| Predefinição | Quadros |
| --- | --- |
| **Studio · Main** | Um turnaround limpo para referência de vídeo com IA: a cabeça de frente, os dois perfis e de trás, e o corpo de frente, de lado e de trás. 7 quadros. |
| **Studio · Extended** | Um turnaround completo que adiciona os ângulos 3/4, de cima e de baixo. 15 quadros. |

Em **Adicionar painéis**, adicione faixas de **Expressions**, **Poses**, **Wardrobe**, **Detail** e **Palette**. Uma folha tem no máximo 24 quadros, então um painel fica desativado quando passaria do limite. Você também pode mudar o **Tema**, a **Proporção**, **Título / metadados** e **Rótulos dos quadros**.

1. Clique em **Preparar *N* ângulos**, onde *N* é o número de quadros que faltam. Só esses quadros são gerados, e eles ficam salvos no personagem para serem reaproveitados. A linha acima do botão mostra quantos quadros são reaproveitados e quanto custa o restante.
2. Clique em **Montar folha** para montar a folha. A opção fica disponível quando não falta nenhum quadro.

Abra uma folha em tela cheia, copie a URL dela ou clique em **Definir como miniatura** para usá-la como miniatura do nó. O nó [**Folha de referência** (Reference Sheet)](https://nodaro.ai/docs/nodes/image/reference-sheet) monta o mesmo tipo de folha no canvas.

**Painel** combina de 2 a 12 imagens do personagem em um único painel de identidade denso, em 4K. Um painel é a âncora de imagem única mais forte que você pode dar a um modelo.

1. Clique em **Novo painel**. Todas as imagens do personagem aparecem, agrupadas por tipo.
2. Selecione de 2 a 12 imagens. Um número em cada uma mostra a posição dela no painel.
3. Clique em **Gerar**. Um painel custa o mesmo que uma [**Colagem de imagens** (Image Collage)](https://nodaro.ai/docs/nodes/image/image-collage) em 4K.

Um personagem guarda até 12 painéis. **Duplicar** reabre a janela de seleção com as mesmas imagens selecionadas e salva o resultado com um novo nome. Clique no nome de um painel para renomeá-lo. **Cancelar**, em um painel que ainda está sendo gerado, reembolsa os créditos dele. No menu de menções `@`, os painéis de um personagem aparecem primeiro. Para painéis e grades feitos no canvas, leia [Painéis de referência e grades de consistência](https://nodaro.ai/docs/guides/reference-boards).

## Voz e personalidade
**Voz** dá ao personagem uma voz que outros nós reaproveitam.

- **Explorar** — escolha uma voz do ElevenLabs entre as vozes prontas, a biblioteca pública ou as suas próprias vozes personalizadas. Pesquise e ouça uma prévia de cada uma.
- **Criar a partir de texto** — descreva uma voz, escreva uma frase de prévia com pelo menos 100 caracteres e clique em **Ouvir prévia** para ouvi-la. Uma voz criada assim serve só para ouvir; ela não é salva.
- **Características da voz** — descreva a voz selecionada em texto livre, por exemplo “grave, calma, sotaque britânico”.
- **Fala** — digite uma frase e clique em **Falar** para ouvir o personagem dizê-la. Com um retrato aprovado, **Falar + sincronização labial do retrato** renderiza um clipe curto do personagem falando. **Falar** custa o mesmo que uma execução de [**Texto para fala** (Text to Speech)](https://nodaro.ai/docs/nodes/audio/text-to-speech), e o clipe com sincronização labial custa o mesmo que uma execução de [**Sincronização labial** (Lip Sync)](https://nodaro.ai/docs/nodes/video/lip-sync).

Conecte o personagem a um nó Texto para fala, e a voz do personagem preenche esse nó quando o workflow é executado. Uma voz definida no próprio nó Texto para fala sempre prevalece.

**Personalidade** tem quatro campos de texto: **Humor / temperamento**, **Estilo de fala**, **Estilo de movimento** e **Notas de comportamento**. Eles são salvos com o personagem, mas não são adicionados aos prompts.

## Salvamento e versões
- **O salvamento é automático.** O cabeçalho mostra **Salvando…** e **Salvo**. Não existe botão de salvar.
- **As gerações terminam sem você.** Cada imagem ou clipe é adicionado ao personagem quando fica pronto, mesmo que você feche o estúdio ou atualize a página.
- **As versões ficam lado a lado.** **Adicionar variação** mantém todas as versões de uma variação, e **Candidatos anteriores** mantém os retratos não aprovados por 7 dias.

## O nó Personagem no canvas
O nó é um card de resumo compacto:

- O retrato, ou a imagem que você definiu como padrão, com o nome, o estilo e o gênero.
- Um menu **Papel**: a parte do personagem que os nós conectados usam por padrão. Veja [Papéis de referência](https://nodaro.ai/docs/guides/reference-roles).
- Uma linha **Bloqueio de identidade**: **Desativado**, **Suave** ou **Rígido**.
- Contagens de **Expressões**, **Poses** e **Movimentos**, e marcas para **Voz** e **Personalidade**.
- **Estúdio**, que abre o estúdio, e **Escolher existente**, que vincula outro personagem.
- No Nodaro Cloud, um selo **Treinando…** enquanto um modelo é treinado e um selo verde **Treinado** quando ele fica pronto.

Passe o mouse sobre a imagem para escolher o formato dela: `1:1`, `3:4`, `16:9` ou `9:16`. O formato também define a proporção das próximas gerações do personagem.

O nó tem duas saídas. **Personagem** leva a identidade completa: as imagens, a descrição canônica, o papel e o bloqueio de identidade. **Imagem** é só a imagem, para qualquer entrada que aceite uma imagem.

O painel de configurações acrescenta **Inserir a descrição da identidade nos prompts dos nós seguintes**. Quando essa opção está ativada, os nós de imagem e vídeo conectados adicionam a descrição canônica aos prompts deles. Ela precisa de uma descrição canônica, então aprove um retrato primeiro.

## Usar um personagem que você já tem
Clique em **Escolher existente** no nó ou em **Choose from Library / Gallery** no painel de configurações.

- **Minha biblioteca** lista os seus próprios personagens.
- **Galeria pública** lista personagens compartilhados pela comunidade. Escolher um deles primeiro o copia para a sua biblioteca e depois conecta o nó à cópia. A aba aparece em instalações com vários usuários, como o Nodaro Cloud.
- Se você já copiou um personagem da galeria, a janela de seleção pergunta se você quer usar a sua cópia ou **Fazer nova cópia**.

Depois que um personagem está vinculado, os botões passam a mostrar **Substituir** e **Replace from Library / Gallery**. A substituição traz todas as imagens, os clipes, a voz e a personalidade do novo personagem, então os nós conectados passam a usá-lo na hora.

## Excluir e restaurar um personagem
Na aba **Minha biblioteca**, passe o mouse sobre um personagem e clique em **Excluir da biblioteca**. O personagem é arquivado, não destruído. Os nós que já o usam continuam funcionando.

Um personagem arquivado pode ser restaurado com a API, o SDK ou a CLI. Se outro personagem ativo tiver o mesmo nome, o personagem restaurado recebe “(restored)” no fim do nome. No Nodaro Cloud, excluir um personagem também cancela um treinamento em andamento, reembolsa esse treinamento e exclui o modelo treinado.

## Dicas
- **Defina os seletores e as referências antes do primeiro retrato.** Eles moldam o retrato, e todas as imagens seguintes seguem o retrato.
- **Aprove antes de expandir.** As imagens geradas antes de um retrato aprovado são menos consistentes, e os movimentos precisam de um retrato aprovado.
- **Dê nomes às variações com cuidado.** Os nomes são as tags que você menciona, como `@maya:1:smile`.
- **Refine em vez de gerar de novo.** Use **Refinar com img2img** com **Adicionar como nova** para mudar um detalhe e manter o original.
- **Mantenha um estilo por projeto.** Misturar estilos entre personagens quebra o visual de uma história.

## Por código e agentes
Tudo no estúdio também está disponível para código e assistentes de IA. A API REST, o SDK e a CLI criam personagens, geram e aprovam retratos, adicionam imagens e clipes, e arquivam e restauram personagens. Veja [Personagens](https://nodaro.ai/docs/developers/api/characters).

As ferramentas MCP incluem `create_character`, `update_character`, `generate_character`, `approve_portrait`, `recaption_character`, `generate_character_motion`, `list_characters` e `get_character`. As ferramentas MCP não excluem nem restauram personagens. Veja as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Frequently asked questions

### Como abro o Estúdio de personagens?

Adicione um nó Personagem ao canvas e clique em “Estúdio” no nó. Você também pode selecionar o nó e clicar em “Abrir estúdio de personagens” no painel de configurações. O estúdio abre na página “Perfil”.

### Por que ainda não consigo gerar expressões, poses ou movimentos?

Eles são gerados a partir do retrato do personagem. Gere um retrato na página “Perfil” e aprove-o primeiro. Até lá, o estúdio pede que você abra o “Perfil”.

### Preciso salvar meu personagem?

Não. O Estúdio de personagens salva enquanto você digita, e o cabeçalho mostra “Salvando…” e “Salvo”. As imagens e os clipes são adicionados ao personagem quando terminam, mesmo que você feche o estúdio durante uma geração.

### Qual é a diferença entre “Gerar igual novamente” e “Adicionar variação”?

“Gerar igual novamente” cria uma nova versão da mesma imagem e substitui o card. “Adicionar variação” cria uma nova versão e mantém o card antigo ao lado, para que você possa comparar os dois.

### O que acontece quando eu excluo um personagem?

“Excluir da biblioteca” arquiva o personagem. Os nós que já o usam continuam funcionando. Um personagem arquivado pode ser restaurado com a API, o SDK ou a CLI.