# Locais

> Monte no Estúdio de locais um lugar para todas as cenas, com imagem principal aprovada, variações de hora do dia, tempo e ângulo e clipes de movimento.

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

Um **local** é um lugar reutilizável, como uma rua ou um cômodo, que tem a mesma aparência em todas as imagens e vídeos de um projeto. Você o cria uma vez no Estúdio de locais a partir de uma imagem principal aprovada e depois adiciona variações, como noite, chuva ou uma vista aérea. Conecte o nó [**Local** (Location Asset)](https://nodaro.ai/docs/nodes/assets/location) onde quer que a cena aconteça, e todas as tomadas partem do mesmo lugar.

## O que um local guarda
| Parte | O que é |
| --- | --- |
| **Imagem principal** | O plano de estabelecimento aprovado. Todas as variações e os clipes de movimento são feitos a partir dela. |
| **Descrição canônica** | Uma descrição de 80 a 120 palavras, escrita a partir da imagem principal quando você a aprova. Os nós conectados a adicionam aos prompts deles. |
| **Variações** | Imagens do mesmo lugar em outros horários, com outras condições do tempo e em outras estações, de outros ângulos e com outra luz. |
| **Clipes de movimento** | Vídeos curtos feitos a partir da imagem principal, como névoa à deriva ou um dolly-in lento. |
| **Fotos de referência** | Até 20 fotos de como o lugar deve ser. |
| **Bloqueio de estilo** | Mantém todas as variações ancoradas na imagem principal. Ativado por padrão. |

## Criar um local
### Adicione o nó e abra o estúdio
Pressione Tab no canvas e escolha **Entidades › Locais › Local**. Clique em **Abrir estúdio** no nó, ou selecione o nó e clique em **Abrir estúdio de locais** no painel de configurações.

### Adicione fotos de referência
Em **Referências**, adicione fotos de como o lugar deve ser. Elas importam mais para lugares desconhecidos ou imaginários, que o modelo não conhece. De três a seis fotos costumam bastar.

### Dê um nome ao lugar e descreva-o
Em **Aparência**, digite um **Nome** e uma **Descrição** do que torna o lugar único. Por exemplo: “Neon-soaked alley with mismatched vending machines, wet concrete and a tangle of overhead cables.”

### Gere e aprove a imagem principal
Escolha 1, 2 ou 4 **Candidatos** e clique em **Gerar**. Com um candidato, o resultado vira a imagem principal automaticamente. Com dois ou quatro, clique em **Aprovar** no que você quer ou em **Descartar** nos que não quer.

### Salve
Clique em **Salvar** no cabeçalho para manter o nome, a descrição e o Bloqueio de estilo. As imagens e os clipes gerados são salvos no local automaticamente, mesmo que você feche o estúdio.

A aprovação não custa créditos e escreve a **Descrição canônica**. A descrição aparece abaixo da imagem principal. Para um lugar desconhecido ou imaginário, gere 2 ou 4 candidatos, porque o primeiro raramente é o certo.

## Fotos de referência
Cada foto de referência tem um tipo que diz ao modelo para que a foto serve.

| Tipo | Quando usar |
| --- | --- |
| **wide-angle reference** | Uma vista mais ampla do mesmo lugar. |
| **interior reference** | O interior, quando a imagem principal mostra o exterior. |
| **exterior reference** | O exterior, quando a imagem principal mostra o interior. |
| **detail reference** | Um detalhe marcante, como uma estátua, uma placa, uma planta ou um material. |
| **mood-board reference** | O clima, a paleta ou a estética que você quer. |
| **reference** | Qualquer outra coisa. |

Escolha o tipo, cole a URL da foto e clique em **Adicionar**. Um local guarda até 20 fotos, e você pode adicionar várias do mesmo tipo. Antes da primeira foto, marque a caixa que confirma que você tem os direitos sobre as fotos e que as pessoas que aparecem nelas deram consentimento. A página passa então a mostrar a data do seu consentimento.

As fotos de referência acompanham o local. Todos os nós que usam o local as recebem como referências extras.

## Variações: hora, tempo, estações, ângulos e luz
Cada página de variações mostra o mesmo lugar com um tipo de mudança.

| 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 em uma predefinição para gerar essa variação. Uma predefinição que você já gerou aparece como concluída.
- **Gerar tudo** gera todas as predefinições que ainda faltam na página.
- Digite em **Prompt personalizado (texto livre)** e clique em **Gerar** para qualquer outra variação, por exemplo “flooded street after a storm”.
- Pesquise as variações pelo nome, selecione várias e exclua todas de uma vez.

Cada variação custa uma imagem no modelo de imagem do local. Dê nomes às variações com cuidado: o nome é o que você menciona, como em `@old-library:1:weather/rain`.

## Bloqueio de estilo
O Bloqueio de estilo é a principal chave de consistência de um local. Ele vem ativado em todo local novo.

| | Bloqueio de estilo ativado (padrão) | Bloqueio de estilo desativado |
| --- | --- | --- |
| **Variações** | Geradas a partir da imagem principal aprovada. O mesmo prédio, os mesmos materiais e a mesma disposição. | Geradas só a partir de texto. O modelo pode reinterpretar o lugar a cada vez. |
| **Outros nós** | Recebem a descrição canônica como contexto fixo. | Recebem a descrição canônica como orientação flexível. |
| **Quando usar** | Tudo o que precisa parecer o mesmo lugar em todas as tomadas. | Designs alternativos, misturas e comparações A/B. |

Ative ou desative o Bloqueio de estilo no cabeçalho do estúdio ou no painel de configurações do nó. O nó mostra “Estilo bloqueado” ao lado do estilo quando ele está ativado.

## Clipes de movimento
A página **Movimento** transforma a imagem principal aprovada em clipes curtos de ambiente: névoa à deriva, movimentos lentos de câmera, paralaxe e sobrevoos. Use um clipe como plano de estabelecimento ou como B-roll entre as cenas.

- **Aprove uma imagem principal primeiro.** Até lá, **Gerar** fica desativado.
- **Predefinições**: dolly-in lento, pan lento à esquerda, pan lento à direita, câmera subindo, sobrevoo de drone, deriva suave, paralaxe, câmera fixa com atmosfera.
- **Prompt personalizado**: 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) (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), [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`, como um plano de estabelecimento cinematográfico.
- **Custo**: um clipe custa o mesmo que uma execução de imagem para vídeo no modelo escolhido.

## Usar um local nas suas cenas
Conecte a saída **Local** do nó Local à entrada **Entidades** de um nó [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image) ou [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video). O nó recebe a imagem principal, as fotos de referência e a descrição canônica.

Workflow: Um local e um personagem alimentam o mesmo nó de imagem; depois, a imagem vira o primeiro quadro de um vídeo.

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

Para colocar o local exatamente onde você quer na frase, mencione-o no prompt. O nome da menção vem do nome do local: “Old Library” vira `@old-library:1`.

| Menção | O que o nó envia |
| --- | --- |
| `@old-library:1` | A imagem principal, como “the location from reference image A”. |
| `@old-library:1:background` | A imagem principal, usada só pelo fundo. |
| `@old-library:1:weather/rain` | A variação com chuva em vez da imagem principal. |
| `@old-library:1:weather/rain:lighting` | A variação com chuva, usada só pela iluminação. |
| `@old-library:1~lock` | Adiciona uma linha que pede ao modelo para reproduzir exatamente a arquitetura, a disposição e a iluminação. |

Uma variação é escrita como página e nome, por exemplo `weather/rain`, `seasons/winter`, `angles/aerial` ou `lighting/neon`. Os espaços de um nome viram hífens, como em `weather/light-rain`. O jeito mais fácil é digitar `@` e escolher a variação no menu, que lista todas as variações de todos os locais conectados.

Os papéis de um local são **location** (local, o padrão), **background** (fundo), **atmosphere** (atmosfera), **as-is** (como está), **empty background** (fundo vazio), **layout** (disposição), **lighting** (iluminação) e **style** (estilo). **empty background** aproveita o fundo sem os objetos que estão na frente dele. **as-is** usa a imagem sem uma frase de papel. Leia [Papéis de referência](https://nodaro.ai/docs/guides/reference-roles) para ver a sintaxe completa.

A saída **Imagem** do nó é a imagem principal como uma imagem simples. Use essa saída quando quiser só a imagem, sem a descrição nem as variações.

No painel de configurações de um nó de imagem ou vídeo, a lista **Referências injetadas** mostra todas as imagens que o nó vai enviar. Remova ali as imagens do local de um nó, sem desconectá-lo.

## Usar um local 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 locais.
- **Galeria pública** lista locais compartilhados pela comunidade. Escolher um deles primeiro o copia para a sua biblioteca. A aba aparece em instalações com vários usuários, como o Nodaro Cloud.

Escolher ou substituir um local traz a imagem principal, todas as variações e todos os clipes de movimento dele, então os nós conectados passam a usá-lo na hora.

## Excluir e restaurar um local
Na aba **Minha biblioteca** da janela de seleção de entidades, passe o mouse sobre um local e clique em **Excluir da biblioteca**. O local é arquivado, e os nós que o usam continuam funcionando.

A página **Biblioteca de locais**, em `app.nodaro.ai/library/locations`, lista os seus locais em duas abas: **Ativos** e **Arquivados**. Um local arquivado tem **Restaurar** e uma exclusão permanente. Para excluir permanentemente, digite o nome exato do local para confirmar. Isso remove o local e as imagens dele de vez.

Se o nome de um local restaurado já estiver em uso, “(restored)” é adicionado a ele.

## Dicas
- **Aprove antes de criar variações.** As variações, os clipes de movimento e a descrição vêm todos da imagem principal.
- **Mantenha o Bloqueio de estilo ativado dentro de um mesmo filme.** Desative-o só quando quiser uma versão diferente do lugar.
- **Dê um painel de inspiração aos lugares imaginários.** De três a seis fotos de referência dão ao modelo o contexto de que ele precisa para uma primeira imagem principal fiel.
- **Use um estilo para todos os locais de um projeto.** Estilos misturados quebram o visual de uma história.
- **Crie um clipe de movimento para cada local ao qual você volta.** Uma deriva ou um dolly de 5 segundos funciona como plano de abertura e como B-roll.

## Por código e agentes
A API REST, o SDK e a CLI criam locais, geram e aprovam imagens principais, adicionam variações e clipes de movimento, e arquivam e restauram locais. Eles também definem a categoria e o estilo, e reescrevem a descrição canônica a partir da imagem principal atual. Veja [Locais](https://nodaro.ai/docs/developers/api/locations).

No Nodaro Cloud, a API também pode montar uma vista em 360 graus de um local, sem emendas visíveis, uma vista do anel por vez.

As ferramentas MCP incluem `create_location`, `update_location`, `generate_location`, `approve_main_image`, `recaption_location`, `generate_location_motion`, `list_locations` e `get_location`. Elas não excluem nem restauram locais. Veja as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Frequently asked questions

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

Crie um nó Local e aprove a imagem principal dele no Estúdio de locais. Depois, conecte o nó à entrada “Entidades” de todos os nós de imagem e vídeo da cena. O Nodaro envia a imagem principal e a descrição dela com cada prompt.

### O que o Bloqueio de estilo faz?

Com o “Bloqueio de estilo” ativado, o padrão, todas as variações são geradas a partir da imagem principal aprovada, então o prédio, os materiais e a disposição continuam iguais. Desative-o quando quiser que o modelo reinterprete o lugar, por exemplo para testar outro design.

### Como uso a versão com chuva de um local em uma imagem?

Mencione a variação no prompt, por exemplo @old-library:1:weather/rain. O nó então envia a imagem com chuva em vez da imagem principal.

### Posso animar um local?

Sim. A página “Movimento” transforma a imagem principal aprovada em clipes curtos, como um dolly-in lento ou um sobrevoo de drone. Um clipe custa o mesmo que uma execução de imagem para vídeo no modelo escolhido.

### Como excluo ou restauro um local?

“Excluir da biblioteca”, na janela de seleção de entidades, arquiva um local, e os nós que o usam continuam funcionando. A página “Biblioteca de locais” lista os locais arquivados, com “Restaurar” e uma exclusão permanente.