O que o nó “Gerar roteiro” produz?

Um roteiro estruturado, com um título, uma duração total e uma lista de cenas. Cada cena tem uma descrição visual, a ação, um clima, uma duração sugerida, um prompt de imagem e, quando for o caso, os personagens, os diálogos, o local, a câmera, o clima musical e os efeitos sonoros.

Como faço uma imagem por cena?

Conecte a saída “Imagens” do “Gerar roteiro” à entrada “Prompt” de um nó “Gerar imagem”. Quando o roteiro tem duas ou mais cenas, o “Gerar imagem” é executado uma vez por cena, com o prompt de imagem daquela cena.

Quantos créditos o “Gerar roteiro” custa?

Uma execução custa de 11 a 33 créditos, conforme o nível do modelo de IA. Os modelos Econômicos custam 11 créditos, os Padrão 22 e os Premium 33. O modo avançado e os esforços de raciocínio “Muito alto” e “Máximo” custam um nível a mais, com teto no Premium.

Quantas cenas devo pedir?

Cerca de uma cena a cada 5 a 10 segundos de vídeo funciona bem na maioria dos formatos. “Número de cenas” aceita de 1 a 20, e “Duração-alvo” define a duração total que a IA planeja.

Nó Gerar roteiro (Generate Script): roteiros de vídeo com IA, com cenas, câmera, diálogos e prompts de imagem

Escreva com IA um roteiro de vídeo com várias cenas. Cada cena traz descrição, ação, clima, duração, câmera, diálogos e um prompt de imagem pronto.

O nó Gerar roteiro (Generate Script) escreve um roteiro de vídeo estruturado, com várias cenas, a partir de um prompt curto. Cada cena vem com uma descrição visual, a ação, um clima, uma duração sugerida e um prompt de imagem pronto para o Gerar imagem (Generate Image). Quando se aplicam, as cenas também trazem indicações de câmera, diálogos, detalhes do local, um clima musical e efeitos sonoros. Sete saídas enviam cada parte do roteiro ao nó que precisa dela.

Quando usar

Você quer um storyboard para um vídeo: um prompt de imagem por cena e, depois, uma imagem e um clipe por cena.
Você precisa de um roteiro estruturado para um vídeo explicativo, um anúncio, uma demonstração de produto ou um vídeo para redes sociais.
Você quer planejar as falas, os climas musicais e os efeitos sonoros junto com as imagens.
Você quer planejar a duração e o ritmo de um vídeo antes de gastar créditos com a geração.

Para um filme completo, feito para você a partir de um só prompt, use o História → vídeo (Story → Video).

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Vídeo › História e roteiro › Gerar roteiro.

Descrever o vídeo

Adicione um nó Texto (Text), digite nele o tema, a história ou o conceito e conecte-o à entrada Prompt do Gerar roteiro. Seja específico: “30-second product ad for a fitness app showing a morning routine” funciona melhor que “make a video”.

Definir a forma do roteiro

Abra o painel de configurações. Defina Número de cenas e Duração-alvo (segundos) e, se quiser, um Tom e um Guia de estilo.

Executar e conectar as saídas

Clique em Executar. O roteiro aparece no nó. Conecte as saídas dele aos nós que fazem as imagens, as vozes e a música.

O Gerar roteiro transforma uma ideia em cenas; as saídas dele alimentam uma imagem por cena, o diálogo e a música.

Entradas e saídas

O Gerar roteiro tem cinco entradas na borda esquerda:

Entrada	Aceita	O que faz
Prompt	Nós de texto, como Texto ou Prompt	O tema, a história ou o conceito. Obrigatória: o nó não tem uma caixa de prompt própria.
Tom	Um nó Tom (Tone) ou qualquer nó de texto	Define o Tom.
Guia de estilo	Um nó Guia de estilo (Style Guide) ou qualquer nó de texto	Define o Guia de estilo.
Número de cenas	Um nó Número de cenas (Scene Count)	Define o Número de cenas, de 1 a 20.
Duração	Um nó Duração (Duration)	Define a Duração-alvo (segundos), de 5 a 600.

Uma entrada conectada tem prioridade sobre o valor digitado no painel. Enquanto ela estiver conectada, o painel mostra esse campo como somente leitura, com um chip que dá o nome do nó conectado. Arraste uma conexão para fora de uma dessas entradas para adicionar o nó correspondente.

Cada uma das sete saídas leva uma parte do roteiro ativo:

Saída	O que leva	Conecte a
Cenas	O roteiro como texto: o prompt de imagem da primeira cena.	Uma entrada de texto.
Imagens	O prompt de imagem de cada cena.	A entrada Prompt do Gerar imagem. Com duas ou mais cenas, o Gerar imagem é executado uma vez por cena.
Diálogo	Todas as falas do roteiro, com o falante e a emoção.	Texto para diálogo (Text to Dialogue). Clique em Preencher falas do roteiro (N) nas configurações dele para copiar as falas. Se o Texto para diálogo não tiver falas próprias, ele usa as falas do roteiro quando é executado.
Música	Os climas musicais de todas as cenas, cada um uma só vez, reunidos em um só texto.	O prompt do Gerar música (Generate Music).
Efeitos sonoros	Os efeitos sonoros de todas as cenas, reunidos em um só texto.	O prompt do Texto para áudio (Text to Audio).
Personagens	Os personagens do roteiro, cada um uma só vez, com nome, descrição, clima, ação e posição.	Nós que leem os personagens de um roteiro.
Locais	Os locais do roteiro, cada um uma só vez, com nome, descrição, hora do dia, condições do tempo e iluminação.	Nós que leem os locais de um roteiro.

Configurações

Configuração	O que faz
Modelo de IA	O modelo de texto que escreve o roteiro. O padrão é o Gemini 3.6 Flash. Pesquise por nome, fabricante ou nível.
Esforço de raciocínio	Quanto o modelo pensa antes de escrever, nos modelos que oferecem essa opção.
Modo avançado	Só nos modelos Gemini. Executa o modelo com os controles do próprio fabricante, para que Temperatura, Máx. de tokens e toda a faixa de raciocínio se apliquem. Esses controles aparecem quando o modo está ativado. Ele custa um nível de crédito a mais, com teto no Premium. Nos outros modelos, a chave fica desativada e mostra o motivo.
Número de cenas	Quantas cenas escrever, de 1 a 20. O padrão é 5. A entrada Número de cenas pode definir esse valor.
Guia de estilo	Orientações visuais e narrativas para todas as cenas, como uma paleta de cores, uma época ou uma referência visual. O guia é enviado ao modelo junto com o tema e pode citar outros nós como `{Node Label}`. A entrada Guia de estilo pode definir esse valor.
Tom	O registro emocional do roteiro inteiro, por exemplo lúdico, dramático ou educativo, com até 200 caracteres. A entrada Tom pode definir esse valor a partir de um nó Tom ou de qualquer nó de texto.
Duração-alvo (segundos)	A duração total que o roteiro planeja, de 5 a 600 segundos. O padrão é 60. A IA distribui essa duração entre as cenas, então cada cena pode variar. A entrada Duração pode definir esse valor.
Texto antes e depois	Texto adicionado antes e depois do prompt, e não do guia de estilo, quando o nó é executado. Ele fica oculto para quem usa o seu workflow como app. Veja Texto antes e depois do prompt.

Para manter esses valores em um só lugar em vários roteiros, conecte nós de Configurações de geração às entradas correspondentes em vez de digitá-los.

O que cada cena contém

Parte	O que é
Número e nome da cena	A posição e um nome curto da cena.
Descrição visual	Uma descrição detalhada do que se vê.
Ação	O que acontece na cena.
Clima	Um ou mais tons emocionais.
Duração	A duração sugerida, em segundos.
Prompt de imagem	Um prompt pronto para o Gerar imagem.
Personagens	O nome, a descrição, o clima, a ação e a posição de cada personagem.
Diálogo	As falas, cada uma com um falante, o texto e uma emoção.
Local	O nome, uma descrição, a hora do dia, as condições do tempo e a iluminação.
Cinematografia	O tipo de tomada, o ângulo da câmera e o movimento da câmera.
Clima musical e efeitos sonoros	Sugestões para a trilha sonora.

Editar o roteiro

Depois de uma execução, o painel de configurações mostra o roteiro gerado: o Título, o número de cenas e a duração total, e uma seção por cena. Abra uma cena para editar Descrição visual, Ação, Clima, Duração (s) e Prompt de imagem (para “Gerar imagem”). As saídas enviam o roteiro com as suas edições. Copiar prompts copia os prompts de imagem de todas as cenas.

Cada execução fica guardada no histórico de resultados do nó, e as saídas seguem o resultado que você selecionar.

Quando o roteiro já existe, Expandir storyboard no nó cria os nós do workflow para cada cena. Escolha Nós de cena, que cria um nó de cena por cena, ou Nós de pipeline. Nós de pipeline cria nós separados para cada cena: Gerar imagem, vídeo, Texto para fala (Text to Speech) e Mesclar vídeo e áudio (Merge Video & Audio). Você pode adicionar um nó Combinar vídeos (Combine Videos) no final e iniciar a geração das imagens na hora. A caixa de diálogo mostra os créditos estimados antes de você criar os nós.

Predefinições

Abra Predefinições no nó para usar predefinições de formato que definem o tom, o número de cenas e a duração-alvo. Digite o seu tema no prompt.

Pasta	Predefinições
Por formato	Short do YouTube, Explicativo, Anúncio / comercial, Demo de produto, Lista, Anúncio UGC (gancho, demo, prova e opinião, em estilo selfie)
Formato longo e narrativa	Pauta de podcast, Narração de trailer, Momentos da história

Créditos

Uma execução custa 11, 22 ou 33 créditos, conforme o nível do modelo de IA: Econômico, Padrão ou Premium. O modelo padrão, o Gemini 3.6 Flash, é um modelo Econômico. O Modo avançado e os esforços de raciocínio Muito alto e Máximo custam um nível a mais, com teto no Premium. O selo de custo no nó é atualizado quando você ativa o modo avançado. Veja os níveis em Como escolher um modelo.

Dicas

Seja específico no prompt. Cite o produto, o público, a duração e o formato.
Use o Tom para manter a consistência. Ele vale para todas as cenas, então o roteiro inteiro mantém um só registro emocional.
Coloque o visual no Guia de estilo. Uma paleta, uma época ou uma referência visual mantém os prompts de imagem consistentes.
Trate a duração como um plano. A Duração-alvo orienta a IA, mas a duração de cada cena pode variar conforme o conteúdo dela.

Solução de problemas

A execução para com “needs a topic” ou “nenhum prompt encontrado”. O roteiro não tem sobre o que escrever. Conecte à entrada Prompt um nó Texto com o tema, a história ou o conceito. As entradas Tom, Guia de estilo, Número de cenas e Duração só definem configurações; elas não são um tema. A execução para antes de começar, então nada é cobrado.

Pela API

O POST /v1/generate-script escreve um roteiro a partir de código. Ele responde na hora com um jobId. O roteiro pronto fica no output_data.script do job, com title, totalDuration e scenes. Veja Jobs.

Campo	O que faz
`prompt`	Obrigatório. O tema, a história ou o conceito, com até 100.000 caracteres.
`sceneCount`	Número de cenas, de 1 a 20. O padrão é 5.
`targetDuration`	Duração-alvo (segundos), de 5 a 600. O padrão é 60.
`tone`	Tom, com até 200 caracteres.
`styleGuide`	Guia de estilo, com até 100.000 caracteres.
`llmModel`	O modelo de texto. O padrão é `gemini-3.6-flash`.
`reasoningEffort`	`none`, `low`, `medium`, `high`, `xhigh` ou `max`.
`advancedMode`, `temperature`, `maxTokens`	O Modo avançado e os controles dele, só nos modelos Gemini.

A ferramenta MCP é a generate_script, que recebe o guia de estilo como style_guide. Veja também Executar um único nó.

Gerar roteiro