# Folha de referência

> Crie um turnaround, painel de variações, folha de detalhes ou model sheet de um Personagem, Objeto ou Local e reutilize os quadros limpos como referências.

Source: https://nodaro.ai/pt-BR/docs/nodes/image/reference-sheet

O nó **Folha de referência** (Reference Sheet) monta uma model sheet de um Personagem, de um Objeto ou de um Local. Ele organiza vistas do assunto, como um turnaround, expressões ou detalhes em close, com uma paleta de cores e anotações, em um único canvas. Ele retorna a folha pronta, para pessoas lerem, e um conjunto limpo de quadros, para nós de imagem e de vídeo usarem como referências.

- Found in: Image › References
- Output: image
- API type: `reference-sheet`

## Quando usar
- Faça a model sheet de um personagem, com turnaround, expressões e paleta, para animação ou arte de jogos.
- Monte um cartão de referência de um produto ou de um adereço, para que ele fique igual em todas as tomadas.
- Exporte uma referência de local para manter a continuidade de cenário e de fundo.
- Conecte os quadros limpos 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) como uma referência com várias imagens.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Imagem › Referências › Folha de referência**.

### Conectar o assunto
Conecte um nó [**Personagem** (Character Asset)](https://nodaro.ai/docs/nodes/assets/character), [**Objeto/adereço** (Object/Props Asset)](https://nodaro.ai/docs/nodes/assets/object) ou [**Local** (Location Asset)](https://nodaro.ai/docs/nodes/assets/location) à entrada **Assunto**. A entidade precisa de uma imagem principal aprovada.

### Escolher a folha
Abra o painel de configurações. Escolha um **Tipo de folha** e um **Tema** e, depois, a **Proporção** e as opções de texto.

### Executar e confirmar
Clique em **Executar** no nó. Se faltarem na entidade quadros de que a folha precisa, o nó informa quantos vai gerar e os créditos estimados e pede que você confirme. Depois, ele gera esses quadros, reutiliza os que existem e compõe a folha.

Workflow: A saída Quadros alimenta o Gerar imagem como referências, e a saída Folha é salva como a entrega final.

- Personagem → Folha de referência (assunto)
- Folha de referência → Gerar imagem (referências)
- Folha de referência → Salvar no armazenamento

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Assunto** | Nós Personagem, Objeto/adereço e Local | A entidade a partir da qual a folha é montada. O nó lê os quadros salvos e a imagem principal dela. Obrigatória. |

A Folha de referência tem duas saídas:

| Saída | O que leva |
| --- | --- |
| **Folha** | A folha pronta, como uma única imagem: um pôster com títulos e rótulos, feito para pessoas. Baixe-a, mostre-a ou envie-a a qualquer lugar que aceite uma imagem. Como ela tem texto, não a use como referência de geração. |
| **Quadros** | O conjunto limpo de quadros: as imagens separadas dos quadros, sem títulos nem rótulos. Conecte-o à entrada de referências de um nó de imagem ou de vídeo para ter consistência com várias imagens. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Tipo de folha** | Quais seções a folha tem. Veja [Tipos de folha](#sheet-types). O padrão é **Turnaround**. |
| **Tema** | O tratamento visual: **Estúdio** (o padrão), **Cinematográfico**, **Desenho técnico** ou **Ilustrado**. O tema muda a moldura, as cores e a fonte, nunca o conteúdo. |
| **Proporção** | **Paisagem** (o padrão, com 1600 px de largura), **Quadrado** (1200 px de largura) ou **Story (9:16)** (900 px de largura). A altura cresce com as seções da folha. |
| **Texto de título e metadados** | Ativado por padrão. Quando desativado, o nome da entidade, os metadados e as anotações ficam ocultos. Os títulos das seções continuam. |
| **Rótulos dos quadros** | Ativado por padrão. Quando desativado, a legenda de cada quadro fica oculta. |

### Tipos de folha
| Tipo de folha | O que mostra |
| --- | --- |
| **Turnaround** | O assunto de vários ângulos, como de frente, de lado e de costas |
| **Painel de variações** | Uma grade de expressões, poses, materiais ou variações |
| **Detalhes** | Quadros de detalhes em close |
| **Referência completa** | Tudo: um cabeçalho, o turnaround, o painel, os detalhes, a paleta e as anotações |

### Temas
| Tema | Visual | Ideal para |
| --- | --- | --- |
| **Estúdio** | Limpo e neutro | Uma grade simples e limpa |
| **Cinematográfico** | Escuro, com uma linha de destaque embaixo de cada título | Apresentações de pitch |
| **Desenho técnico** | Uma grade de desenho técnico suave, marcas nos cantos e uma fonte monoespaçada | Documentação técnica e de entidades |
| **Ilustrado** | Uma página quente de livro de histórias, com uma faixa de cabeçalho e uma fonte serifada | Livros de histórias e bíblias de personagens |

## Como os quadros são feitos
Quando o nó é executado, ele trabalha nesta ordem:

1. Ele lista os quadros de que o tipo de folha escolhido precisa.
2. Ele reutiliza, de graça, todos os quadros que a entidade já tem.
3. Ele gera os quadros que faltam a partir da imagem principal da entidade, com o Nano Banana, a 11 créditos por quadro.
4. Ele extrai uma paleta de cores da imagem principal.
5. Ele compõe a folha e o conjunto limpo de quadros.

Quando você clica em **Executar** no nó, ele mostra primeiro quantos quadros vai gerar e os créditos estimados e pede que você confirme. A execução automática de um workflow ou a execução de um app não pode perguntar, então gera os quadros que faltam sem confirmação. Para controlar o custo das execuções automáticas, crie antes, no estúdio da entidade, os quadros que você quer.

Você também pode criar folhas na aba **Folha** do estúdio de uma entidade. O nó faz o mesmo no canvas, para que uma folha possa fazer parte de um workflow.

## Créditos
Uma folha custa uma taxa fixa de montagem de 44 créditos, mais 11 créditos para cada quadro que o nó precisa gerar. O nó gera todos os quadros que faltam com o Nano Banana, seja no canvas, em um workflow ou app, seja na aba **Folha** do estúdio da entidade. Os quadros que a entidade já tem não custam nada, qualquer que seja o modelo que os fez. Um quadro que você mesmo gera no estúdio é cobrado lá, pelo preço do modelo que você escolher.

| Exemplo | Cálculo | Créditos |
| --- | --- | --- |
| Turnaround que reutiliza 4 ângulos que a entidade já tem | 0 + 44 | 44 |
| Turnaround com 1 ângulo faltando e o resto reutilizado | 1 × 11 + 44 | 55 |
| 4 ângulos novos gerados | 4 × 11 + 44 | 88 |

O botão **Executar** mostra a taxa de montagem. A confirmação mostra quantos quadros serão gerados e o total estimado, quadros mais a taxa de montagem. Em uma edição sem créditos, o botão não mostra nenhuma taxa, e a confirmação mostra só o número de quadros. Se nenhum quadro puder ser gerado, a execução falha e a taxa de montagem é reembolsada, em vez de cobrar por uma folha vazia.

## Folhas animadas pela API
O painel de configurações cria folhas estáticas, como imagens PNG. Quando você cria o nó pela API ou no JSON do workflow, pode definir `flavour.outputFormat` como `motion`. O nó então renderiza a moldura, o texto e a paleta uma vez, coloca os clipes de movimento da entidade nos espaços dos quadros e exporta um MP4. A saída **Folha** passa a levar um vídeo.

- Uma folha animada só usa clipes de movimento que a entidade já tem, associados a cada quadro pelo nome. Um quadro sem clipe correspondente mantém o fundo estático. Gere antes os clipes no estúdio da entidade.
- O clipe mais curto define a duração da folha.
- Uma folha animada custa uma taxa fixa de montagem de 66 créditos. Os próprios clipes são pagos quando você os gera no estúdio.

## Solução de problemas
**A execução falha porque a entidade não tem uma imagem principal.** A entidade precisa de uma imagem principal salva. Aprove uma no estúdio da entidade e execute o nó de novo.

**A execução falha e nada é cobrado.** Quando nenhum quadro pode ser gerado, a folha não é composta, e a taxa de montagem de 44 créditos é reembolsada.

## Dicas
- **Use os Quadros, não a Folha.** Use **Quadros** como referência para outros nós. A saída **Folha** é o pôster para pessoas.
- **Crie os quadros antes para economizar créditos.** Gere ou ajuste os quadros que você quer no estúdio da entidade antes de executar a folha. O nó os reutiliza de graça e gera só o que falta.
- **Ajuste o tema ao público.** Escolha **Desenho técnico** para documentação técnica, **Cinematográfico** para apresentações de pitch, **Ilustrado** para livros de histórias e bíblias de personagens, e **Estúdio** para uma grade limpa.
- **Precisa de um único painel coeso?** O [**Painel de referência** (Reference Board)](https://nodaro.ai/docs/nodes/image/reference-board) desenha um painel completo em uma única passada de IA. Leia [Painéis de referência e grades de consistência](https://nodaro.ai/docs/guides/reference-boards) para escolher entre painéis e grades.

## Frequently asked questions

### Do que o nó “Folha de referência” precisa?

De um nó “Personagem”, “Objeto/adereço” ou “Local” com uma imagem principal aprovada, conectado à entrada “Assunto”. Sem uma imagem principal, a execução falha.

### Quantos créditos custa uma folha de referência?

Uma taxa fixa de montagem de 44 créditos, mais 11 créditos para cada quadro que o nó precisa gerar. Os quadros que a entidade já tem são reutilizados de graça, então um turnaround feito com quatro ângulos existentes custa 44 créditos.

### Qual é a diferença entre as saídas “Folha” e “Quadros”?

A “Folha” é o pôster pronto, com títulos e rótulos, feito para pessoas. Os “Quadros” são o conjunto de imagens de quadros limpas, sem texto, feitas para alimentar nós de imagem e de vídeo como referências.

### Qual é a diferença entre a “Folha de referência” e o “Painel de referência”?

A “Folha de referência” compõe os quadros que uma entidade já tem, ou gera antes os que faltam, e entrega cada quadro como uma imagem separada. O “Painel de referência” desenha um painel inteiro em uma única passada de IA e retorna uma única imagem.

### Por que o nó pede uma confirmação antes de ser executado?

O nó precisa gerar os quadros que faltam na entidade, e cada um custa créditos. Ele informa quantos vai gerar, e quanto custam, antes de começar. As execuções automáticas de workflows e as execuções de apps não podem perguntar, então geram os quadros sem confirmação.