# Gerar roteiro

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

Source: https://nodaro.ai/pt-BR/docs/nodes/video/generate-script

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)](https://nodaro.ai/docs/nodes/image/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.

- Found in: Video › Story & Script
- Output: text
- API type: `generate-script`

## 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)](https://nodaro.ai/docs/nodes/video/story-to-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)](https://nodaro.ai/docs/nodes/automate/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.

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

- Texto → Gerar roteiro (prompt)
- Gerar roteiro → Gerar imagem (imagens)
- Gerar roteiro → Texto para diálogo (diálogo)
- Gerar roteiro → Gerar música (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](https://nodaro.ai/docs/nodes/automate/text) ou [Prompt](https://nodaro.ai/docs/nodes/automate/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)](https://nodaro.ai/docs/nodes/settings/tone) ou qualquer nó de texto | Define o **Tom**. |
| **Guia de estilo** | Um nó [**Guia de estilo** (Style Guide)](https://nodaro.ai/docs/nodes/settings/style-guide) ou qualquer nó de texto | Define o **Guia de estilo**. |
| **Número de cenas** | Um nó [**Número de cenas** (Scene Count)](https://nodaro.ai/docs/nodes/settings/scene-count) | Define o **Número de cenas**, de 1 a 20. |
| **Duração** | Um nó [**Duração** (Duration)](https://nodaro.ai/docs/nodes/settings/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](https://nodaro.ai/docs/nodes/image/generate-image). 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)](https://nodaro.ai/docs/nodes/audio/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)](https://nodaro.ai/docs/nodes/audio/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)](https://nodaro.ai/docs/nodes/audio/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](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

Para manter esses valores em um só lugar em vários roteiros, conecte nós de [Configurações de geração](https://nodaro.ai/docs/nodes/settings) à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](https://nodaro.ai/docs/guides/choosing-models).

## 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](https://nodaro.ai/docs/nodes/automate/text) 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](https://nodaro.ai/docs/developers/api/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`](https://nodaro.ai/docs/mcp/tools/prompts-and-text#generate_script), que recebe o guia de estilo como `style_guide`. Veja também [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes).

## Frequently asked questions

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