# Treinamento de personagens

> Treine um modelo personalizado com as imagens de um personagem para a semelhança mais fiel no Gerar imagem, por 1.650 créditos e em cerca de 15 minutos.

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

O **treinamento de personagens** ensina a um modelo de imagem personalizado um personagem específico, a partir das próprias imagens do personagem. Depois do treinamento, o nó [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image) desenha esse personagem com o modelo treinado dele, que dá a semelhança mais fiel que o Nodaro oferece. O treinamento custa 1.650 créditos e leva cerca de 15 minutos.

O treinamento de personagens funciona só no Nodaro Cloud. Nas edições self-hosted, a página **LoRA** não aparece no Estúdio de personagens.

## Imagens de referência ou modelo treinado
Sem treinamento, o nó Gerar imagem envia as imagens aprovadas do personagem ao modelo que você selecionou, como referências. Depois do treinamento, o nó Gerar imagem executa no lugar o próprio modelo treinado do personagem, um Flux LoRA. O modelo treinado aprendeu o personagem, então não precisa de imagens de referência.

| | Imagens de referência (todos os personagens) | Modelo treinado |
| --- | --- | --- |
| **Nós** | Todos os nós de imagem e vídeo que aceitam referências | Só o Gerar imagem |
| **Modelo** | O modelo que você seleciona no nó | O modelo treinado do personagem |
| **Preço por imagem** | O preço do modelo selecionado | 22 créditos |
| **Vários personagens em uma imagem** | Sim | Não. O nó volta a usar as imagens de referência |
| **Preparação** | Nenhuma | 1.650 créditos e cerca de 15 minutos |

Treine um personagem quando ele tiver uma boa variedade de imagens fiéis ao personagem e você precisar da semelhança mais fiel dele em muitas imagens. Para vídeo, o método continua sendo as imagens de referência do personagem; leia [Personagens consistentes](https://nodaro.ai/docs/guides/consistent-characters).

## Do que o treinamento precisa
- **Pelo menos 4 imagens.** O treinamento usa o retrato, as fotos de referência, as expressões, as poses, os ângulos da cabeça, os ângulos do corpo e as variações de iluminação do personagem. Os clipes de movimento e as folhas não são usados.
- **No máximo 20 imagens.** Quando você seleciona mais, o Nodaro usa as 20 primeiras, na ordem acima.
- **Imagens limpas e fiéis ao personagem.** O modelo aprende tudo o que você dá a ele, inclusive um rosto que saiu diferente. Desmarque qualquer imagem que não se pareça com o personagem.

Monte o personagem no [Estúdio de personagens](https://nodaro.ai/docs/guides/character-studio) primeiro. O retrato, os cinco ângulos da cabeça e algumas expressões mostram o rosto de vários lados para o treinamento.

## Treinar um personagem
### Abra a página LoRA
Abra o personagem no Estúdio de personagens e escolha **LoRA**, em **Recursos**.

### Escolha as imagens de treinamento
Em **Imagens de treinamento**, todas as imagens do personagem vêm selecionadas. Clique em uma imagem para deixá-la de fora ou use **Selecionar tudo** e **Limpar**. O contador mostra quantas estão selecionadas, e **Treinar modelo de alta fidelidade** fica desativado até você selecionar pelo menos 4.

### Inicie o treinamento
Clique em **Treinar modelo de alta fidelidade**. O Nodaro reserva 1.650 créditos e começa o treinamento.

### Aguarde cerca de 15 minutos
A página mostra **Treinando… (~15 min)**, e o nó no canvas mostra **Treinando…**. Você pode fechar o estúdio e continuar trabalhando.

### Confira o resultado
Quando o treinamento dá certo, um selo verde **Treinado** aparece na página LoRA, no nó **Personagem** (Character Asset) e na lista de menções `@`. A página LoRA também mostra a palavra-gatilho e a data do treinamento.

## Usar o personagem treinado
Conecte o nó Personagem à entrada **Entidades** de um nó Gerar imagem e mencione o personagem no prompt.

```
@maya:1 reading on a night train, soft window light
```

Quando o nó usa esse único personagem treinado, o Nodaro executa o modelo treinado em vez do modelo selecionado em **Provedor**.

- **O preço é de 22 créditos por imagem.** Ele substitui o preço do modelo selecionado.
- **A palavra-gatilho é adicionada para você.** O Nodaro a coloca no início do prompt e remove os tokens de menção `@`. Não a digite.
- **As imagens de referência não são enviadas.** O modelo treinado trabalha só a partir do prompt, então as outras imagens de referência do nó não são usadas nessa execução.
- **Dois ou mais personagens usam referências.** Quando a imagem usa mais de um personagem, o nó executa o modelo selecionado com as imagens de referência de todos os personagens.
- **Os outros nós não mudam.** O [**Modificar imagem** (Modify Image)](https://nodaro.ai/docs/nodes/image/modify-image) e todos os nós de vídeo sempre usam as imagens de referência do personagem.

Workflow: Um personagem treinado mencionado no prompt faz o nó Gerar imagem executar o modelo treinado dele; depois, o resultado vira o primeiro quadro de um vídeo.

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

Para levar a semelhança treinada para o vídeo, gere primeiro a imagem fixa com o nó Gerar imagem e depois use-a como quadro inicial do nó [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video).

## Treinar novamente, cancelar ou remover
| Ação | Quando | O que acontece |
| --- | --- | --- |
| **Cancelar** | Enquanto o modelo é treinado | O treinamento para e os créditos são reembolsados. Clique em **Treinar modelo de alta fidelidade** para começar de novo. |
| **Treinar novamente** | Depois de um treinamento bem-sucedido | Treina de novo com as imagens selecionadas e substitui o modelo atual. Custa 1.650 créditos a cada vez. |
| **Remover** | Depois de um treinamento bem-sucedido | Exclui o modelo treinado. O nó Gerar imagem volta a usar as imagens de referência. |
| **Tentar novamente** | Depois de um treinamento com falha | Inicia um novo treinamento. A página mostra por que o último falhou, e um treinamento com falha é reembolsado. |

Excluir o personagem também cancela um treinamento em andamento, reembolsa esse treinamento e exclui o modelo treinado.

## Créditos
| Ação | Créditos |
| --- | --- |
| Treinamento | 1.650 |
| Novo treinamento | 1.650 |
| Cada imagem do modelo treinado | 22, em vez do preço do modelo selecionado |
| Um treinamento que falha ou é cancelado | Reembolsado |

Veja [Créditos](https://nodaro.ai/docs/concepts/credits) para saber como o Nodaro reserva e reembolsa créditos.

## Dicas
- **Faça uma curadoria antes de treinar.** Desmarque as imagens desfocadas ou com o rosto diferente; o modelo também aprende com elas.
- **Cubra os ângulos.** O retrato, os cinco ângulos da cabeça e algumas expressões ensinam o rosto de vários lados.
- **Mantenha um personagem por imagem.** O modelo treinado só é executado quando a imagem usa um único personagem.
- **Mantenha as referências prontas para vídeo.** O treinamento só muda o nó Gerar imagem, então mantenha as imagens do personagem fiéis a ele para o trabalho com vídeo.

## Por código e agentes
A API REST inicia um treinamento, lê o status dele e remove o modelo treinado. O status é um destes: `untrained`, `queued`, `training`, `succeeded`, `failed` ou `cancelled`. Iniciar um treinamento é limitado a 3 requisições por minuto por token. Veja [Treinamento de personagem](https://nodaro.ai/docs/developers/api/character-training).

Uma chamada `POST /v1/generate-image` executa o modelo treinado quando o prompt dela menciona um único personagem treinado conectado ao nó. Veja as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools) para gerar imagens a partir de um assistente de IA.

## Frequently asked questions

### Quanto custa o treinamento de personagem?

O treinamento custa 1.650 créditos, e cada novo treinamento custa 1.650 créditos de novo. Cada imagem gerada com o modelo treinado custa 22 créditos, em vez do preço do modelo selecionado no nó. Um treinamento com falha ou cancelado é reembolsado.

### Quantas imagens preciso para treinar um personagem?

Pelo menos 4. O Nodaro treina com até 20 das imagens que você selecionar, escolhidas nesta ordem: o retrato, as fotos de referência, as expressões, as poses, os ângulos da cabeça, os ângulos do corpo e as variações de iluminação.

### Quanto tempo leva o treinamento de personagem?

Cerca de 15 minutos. Você pode fechar o estúdio e continuar trabalhando. O nó Personagem mostra “Treinando…” até o modelo ficar pronto.

### Quais nós usam o modelo treinado?

Só o Gerar imagem. Os outros nós de imagem e vídeo, como Modificar imagem e Gerar vídeo, continuam usando as imagens de referência do personagem.

### Posso usar dois personagens treinados em uma imagem?

Não com os modelos treinados deles. Quando um nó Gerar imagem usa dois ou mais personagens, ele executa o modelo selecionado com as imagens de referência dos personagens.

### Posso treinar um personagem em uma instalação self-hosted?

Não. O treinamento de personagens funciona só no Nodaro Cloud, e a página LoRA fica oculta no Estúdio de personagens nas outras edições.