# Local

> Crie no Estúdio de locais um local reutilizável, com variações de hora do dia, clima, estação, ângulo e luz, e mantenha o mesmo lugar em toda tomada.

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

O nó **Local** (Location Asset) guarda um lugar reutilizável: um plano de estabelecimento aprovado, uma descrição escrita, variações de hora do dia, clima, estações, ângulos de câmera e iluminação, e clipes curtos de atmosfera. Você o cria no **Estúdio de locais**, 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 `@`, e todas as tomadas mostram o mesmo lugar.

- Found in: Assets › Places
- Output: data
- API type: `location`

## Quando usar
- Você quer que o mesmo cenário tenha a mesma aparência em todas as cenas de uma história.
- Você precisa de um plano de estabelecimento e de planos de corte de um lugar, como o crepúsculo, uma tempestade ou uma vista aérea.
- Você quer que os nós de imagem e de vídeo recebam automaticamente a descrição e as fotos de referência do lugar.
- Você quer clipes curtos de ambiente de um lugar, como uma névoa à deriva ou um dolly-in lento, para B-roll ou como quadros iniciais.

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

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

### Descrever o lugar e gerar a imagem principal
Digite um nome e uma descrição, e escolha a categoria e o estilo. Escolha quantos candidatos fazer e clique em **Gerar**. Com um candidato, o resultado vira a imagem principal. Com dois ou quatro, clique em **Aprovar** no que você quiser.

### Adicionar variações
Gere variações de hora do dia, clima, estação, ângulo e iluminação, ou clipes de movimento, nas páginas da barra lateral. Com o Bloqueio de estilo ativado, toda variação parte da imagem principal aprovada.

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

Workflow: Um local e um personagem alimentam uma imagem, e o local também ancora o vídeo feito a partir dela.

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

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

- A imagem principal aprovada, ou um espaço reservado até que uma seja aprovada.
- O nome do local, o estilo e a categoria dele, e **Estilo bloqueado** quando o Bloqueio de estilo está ativado.
- Seis contadores das variações: **Horários** (hora do dia), **Tempo**, **Estações**, **Ângulos**, **Iluminação** e **Movimento**. Um contador mostra um indicador de carregamento enquanto uma variação está sendo gerada.
- Um botão **Abrir estúdio**, que abre o Estúdio de locais.
- Um botão **Escolher existente**, que vira **Substituir** quando o nó já tem um local.

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

## Entradas e saídas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Prompt** | Nós de texto e seletores | Contexto extra para a imagem principal quando o nó a gera. |
| **Cinematografia** | Seletores de visual e de câmera, como **Iluminação** (Lighting), **Atmosfera** (Atmosphere) ou **Lente** (Lens) | O texto deles é adicionado à descrição do local quando o nó gera a imagem principal. |

| Saída | Transporta | Conecte a |
| --- | --- | --- |
| **Local** | A identidade do local: a imagem principal, a descrição canônica e o estado do Bloqueio de estilo | A entrada **Entidades** do Gerar imagem, do Gerar vídeo e de outros nós que aceitam locais |
| **Imagem** | O plano de estabelecimento como uma imagem simples, sem descrição | Qualquer entrada de imagem, como **Referências** ou **Quadro inicial** |

## Bloqueio de estilo
O **Bloqueio de estilo** é a chave de consistência mais importante de um local. Ele vem ativado por padrão. Ative ou desative-o no cabeçalho do estúdio ou no painel de configurações do nó.

| Bloqueio de estilo | Variações | Nós de imagem e de vídeo que usam o local |
| --- | --- | --- |
| **Ativado** (padrão) | Feitas a partir da imagem principal aprovada, então a mesma construção, os mesmos materiais e a mesma disposição aparecem em cada uma | Recebem a descrição canônica como está escrita |
| **Desativado** | Feitas só a partir de texto, então cada uma pode reinterpretar o lugar | Tratam a descrição como uma orientação flexível |

Mantenha o Bloqueio de estilo ativado num filme ou numa série. Desative-o só para mash-ups, visuais alternativos ou comparações A/B.

## O Estúdio de locais
O Estúdio de locais é um editor em tela cheia com uma barra lateral de páginas:

| Grupo | Páginas |
| --- | --- |
| **Recursos** | Referências |
| **Identidade** | Aparência |
| **Ambiente** | Hora do dia, Tempo, Estações |
| **Composição** | Ângulos, Iluminação |
| **Atmosfera** | Movimento |
| **Folha** | Folha, Painel |

O estúdio salva enquanto você trabalha. A geração roda no servidor: se você fechar o estúdio ou a aba enquanto uma variação está sendo gerada, o resultado ainda é adicionado ao local. Se o local foi alterado em outra aba, o estúdio pede que você recarregue a página, em vez de sobrescrever a versão mais recente.

### Aparência
A página **Aparência** guarda a identidade do local e a imagem principal dele:

- **Nome**, **Descrição**, **Categoria** e **Estilo**. As categorias são interno, externo, urbano, natureza, fantasia, ficção científica, histórico, futurista e outro. Os estilos são realista, anime, 3D estilo Pixar e ilustração.
- **Gerar** faz imagens principais candidatas. Escolha 1, 2 ou 4 candidatos. Com 1, o resultado vira a imagem principal diretamente. Com 2 ou 4, cada candidato aparece com **Aprovar** e **Descartar**.
- **Imagem principal** mostra o plano de estabelecimento aprovado.
- **Descrição canônica** mostra a descrição visual detalhada escrita automaticamente quando você aprova a imagem principal, com cerca de 80 a 120 palavras. O estúdio mostra a descrição, mas não permite editá-la. Se a escrita da descrição falhar, a imagem principal continua definida, e a API de [Locais](https://nodaro.ai/docs/developers/api/locations) pode escrever a descrição de novo.

Os candidatos anteriores continuam disponíveis: o estúdio mostra os mais recentes, até 5, e a imagem principal atual não muda até você aprovar outra.

### Referências
A página **Referências** guarda um painel de inspiração com até 20 fotos de referência. Dê um tipo a cada foto: **wide-angle reference**, **interior reference**, **exterior reference**, **detail reference**, **mood-board reference** ou **reference**. O tipo diz ao modelo para que serve cada foto, por exemplo uma referência em grande angular ou um detalhe.

As fotos acompanham o local. Todo nó de imagem e de vídeo que usa o local as recebe como referências extras. Para deixá-las de fora num nó, remova-as das referências injetadas desse nó com o botão ×.

Antes de adicionar a primeira foto, confirme que você tem os direitos sobre as fotos e que as pessoas que aparecem nelas concordaram com o uso como referência. Para um lugar pouco conhecido ou fantástico, de 3 a 6 fotos dão ao modelo contexto suficiente para acertar logo na primeira vez.

### Variações de ambiente e de composição
As cinco páginas de variações têm o mesmo layout: as variações feitas até agora, uma fileira de chips de predefinição, um campo para o seu próprio prompt e um botão **Gerar tudo**. Esse botão coloca na fila todas as predefinições que faltam.

| Página | Predefinições |
| --- | --- |
| **Hora do dia** | amanhecer, manhã, meio-dia, tarde, hora dourada, crepúsculo, hora azul, noite, meia-noite |
| **Tempo** | céu limpo, céu nublado, chuva fraca, chuva forte, tempestade, neve, nevasca, nevoeiro, névoa leve |
| **Estações** | primavera, verão, outono, inverno |
| **Ângulos** | plano geral, plano médio, primeiro plano, vista aérea, ângulo baixo, altura dos olhos, visão de pássaro, ângulo holandês |
| **Iluminação** | luz natural suave, sol forte, luz dourada, hora azul, luz neon, à luz de velas, luz cinematográfica, claro-escuro dramático |

Clique num chip de predefinição para gerar essa variação, ou digite a sua, como “after a sandstorm”. O nome de cada variação é a tag que você usa para escolhê-la depois.

### Movimento
A página **Movimento** faz clipes de atmosfera curtos e em loop a partir da imagem principal aprovada, como uma névoa à deriva, um dolly-in lento ou um sobrevoo de drone. Ela precisa de uma imagem principal aprovada antes.

- **Predefinições**: dolly-in lento, pan lento à esquerda, pan lento à direita, câmera subindo, sobrevoo de drone, deriva suave, paralaxe e câmera fixa com atmosfera.
- **Seu próprio prompt**: descreva o que se move e como, por exemplo “fog rolls in from the left while light beams shift slowly”.
- **Modelos**: [Kling 2.6](https://nodaro.ai/docs/models/video/kling-2-6) (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), [Wan 2.7 I2V](https://nodaro.ai/docs/models/video/wan-2-7-i2v) e [Seedance 2](https://nodaro.ai/docs/models/video/seedance-2).
- A página não tem configuração de proporção: todos os clipes são `16:9`, o formato de um plano de estabelecimento cinematográfico.

Um clipe custa o mesmo que a mesma geração de imagem para vídeo nesse modelo.

### Folha e Painel
A página **Folha** monta folhas de referência a partir das imagens do local, como um turnaround, uma folha de variações ou uma folha de detalhes. Veja o nó [**Folha de referência** (Reference Sheet)](https://nodaro.ai/docs/nodes/image/reference-sheet). A página **Painel** combina várias imagens do local numa única imagem de painel.

## Usar o local num prompt
Conecte o local à entrada **Entidades**, ou mencione-o com `@` e o nome dele no prompt de um nó de imagem ou de vídeo. Uma menção também pode escolher uma variação e um papel:

- `@oldlibrary:1` usa a imagem principal.
- `@oldlibrary:1:weather/rain` usa a variação de chuva.
- `@oldlibrary:1:weather/rain:lighting` usa só a iluminação da variação de chuva.

O papel padrão de um local é `location`. Outros papéis incluem `background`, `atmosphere`, `layout`, `lighting` e `style`. Adicione `~lock` a uma menção para fazer o modelo reproduzir exatamente a arquitetura, a disposição e a iluminação do lugar. Leia [Papéis de referência](https://nodaro.ai/docs/guides/reference-roles) para ver todos os papéis.

## Escolher um local existente
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 locais que você salvou.
- **Galeria pública**: locais 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 local, os botões passam a mostrar **Substituir**. O nó recebe o local inteiro, com a imagem principal e todas as variações e clipes. Se você escolher um local 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**.

## Excluir e restaurar
Excluir um local o arquiva. Um local arquivado some das suas listas, mas os nós que já o usam continuam funcionando, e você pode restaurá-lo.

- Para remover um local de **Minha biblioteca**, passe o cursor sobre o cartão dele na janela de seleção e clique no ícone de lixeira.
- A página **Biblioteca de locais** lista os seus locais ativos e arquivados. **Restaurar** traz de volta um local arquivado. Se o nome dele já estiver em uso, “(restored)” é adicionado ao nome.
- **Excluir permanentemente**, num local arquivado, remove o local de vez. Para confirmar, digite o nome exato do local.

## Créditos
As gerações no estúdio são cobradas pelo preço do modelo que você escolhe. Um clipe de movimento custa o mesmo que a mesma geração de imagem para vídeo nesse modelo.

## Dicas
- **Aprove a imagem principal primeiro.** Todas as variações, todos os clipes e a descrição canônica partem dela.
- **Faça vários candidatos para lugares incomuns.** Para um lugar fantástico ou pouco conhecido, gere 2 ou 4 candidatos e escolha o melhor.
- **Deixe a descrição se escrever sozinha.** A descrição automática acerta as palavras que os modelos entendem bem, como arquitetura, vegetação, luz e escala.
- **Adicione um painel de inspiração para lugares pouco conhecidos.** De 3 a 6 fotos de referência levam a primeiros resultados mais fiéis.
- **Mantenha um estilo por projeto.** Use o mesmo estilo em todos os locais de um projeto.
- **Faça um clipe de cada local para onde você corta.** Um drift ou um dolly de 5 segundos funciona como quadro inicial para nós de vídeo e como preenchimento entre as cenas.

## 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 local, gerar e aprovar a imagem principal, adicionar variações e clipes de atmosfera, e arquivá-lo ou restaurá-lo. Veja [Locais](https://nodaro.ai/docs/developers/api/locations) e as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Frequently asked questions

### Como mantenho o mesmo lugar em todas as tomadas?

Aprove uma imagem principal no Estúdio de locais e mantenha o Bloqueio de estilo ativado. Depois, conecte o nó Local à entrada Entidades do Gerar imagem ou do Gerar vídeo, ou mencione-o com @ no prompt. A imagem principal e a descrição do local são enviadas em todas as execuções.

### O que o Bloqueio de estilo faz?

Com o Bloqueio de estilo ativado, o padrão, toda variação é feita a partir da imagem principal aprovada, então a mesma construção, os mesmos materiais e a mesma disposição aparecem em cada uma. Com ele desativado, cada variação é gerada só a partir de texto e pode reinterpretar o lugar.

### Posso mostrar o local à noite ou na chuva?

Sim. As páginas Hora do dia, Tempo, Estações e Iluminação fazem variações da imagem principal aprovada, como noite, tempestade, inverno ou neon. Você pode escolher uma variação numa menção no prompt, por exemplo @oldlibrary:1:weather/rain.

### O que são os clipes de movimento de atmosfera?

Clipes de vídeo curtos, em loop, feitos a partir da imagem principal, como um dolly-in lento, uma névoa à deriva ou um sobrevoo de drone. Use-os como quadros iniciais para nós de vídeo ou como B-roll entre as cenas.

### Por que preciso confirmar o consentimento antes de adicionar fotos de referência?

As fotos de referência podem mostrar pessoas. Antes de adicionar a primeira foto, você confirma que tem os direitos sobre as fotos e que as pessoas que aparecem nelas concordaram com o uso como referência.