Locais

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) onde quer que a cena aconteça, e todas as tomadas partem do mesmo lugar.

O que um local guarda

Criar um local

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.

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.

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

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 (o padrão), Kling 2.5 Turbo Pro, Kling 3.0, Wan 2.6 I2V, Wan 2.7 I2V e 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) ou Gerar vídeo (Generate Video). O nó recebe a imagem principal, as fotos de referência e a descrição canônica.

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.

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

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.