# História → vídeo

> Transforme um prompt de história em um filme pronto com IA. O nó escreve o roteiro, escala o elenco, planeja as tomadas, anima, edita e pede sua aprovação.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/story-to-video

O nó **História → vídeo** (Story → Video) transforma o prompt de uma história curta em um filme pronto. Ele executa um pipeline de IA em oito etapas: roteiro, personagens, objetos de cena, locais, lista de tomadas, imagens das cenas, animação com áudio e a edição final. Entre as etapas, ele para para que você aprove, edite ou rejeite o que ele fez, e tudo o que ele faz aparece no canvas como nós comuns.

- Found in: Video › Story & Script
- Output: video
- API type: `generative-pipeline`

O História → vídeo só roda no Nodaro Cloud. Ele não está disponível em instalações self-hosted.

## Quando usar
- Você tem uma ideia para um trailer, um curta-metragem, um videoclipe, um reel ou um comercial e quer um primeiro corte completo a partir de um parágrafo.
- Você quer que a IA escale personagens e crie locais, e quer guardá-los como entidades reutilizáveis para trabalhos futuros.
- Você quer dirigir em alto nível, aprovar as escolhas importantes e deixar o pipeline fazer o resto.

Para montar um filme tomada a tomada por conta própria, comece pelo [**Gerar roteiro** (Generate Script)](https://nodaro.ai/docs/nodes/video/generate-script) e pelo [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video).

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › História e roteiro › História → vídeo**.

### Descrever a história
Selecione o nó e digite a história em **Prompt da história** no painel de configurações, com até 4.000 caracteres.

### Escolher o formato e a duração
Escolha um **Formato** e defina **Duração desejada (segundos)**. A duração precisa caber no formato; o painel avisa quando ela não cabe.

### Escolher quem aprova
Escolha um **Modo**. **Manual**, o padrão, para depois de cada etapa e espera a sua aprovação.

### Executar o pipeline
Clique em **Executar pipeline**. O painel do pipeline abre, e novos nós aparecem no canvas à medida que cada etapa é executada. Quando uma etapa precisar de você, aprove-a no painel para continuar.

Workflow: O História → vídeo coloca o elenco e os locais no canvas como nós de entidade reais. Reutilize-os em outros nós, aqui no Gerar vídeo, para uma nova tomada do mesmo personagem no mesmo lugar.

- Personagem → Gerar vídeo (entidades)
- Local → Gerar vídeo (entidades)

## Configurações
Selecione o nó para ver as configurações dele no painel de configurações.

| Configuração | O que faz |
| --- | --- |
| **Prompt da história** | A história, com até 4.000 caracteres. |
| **Duração desejada (segundos)** | A duração do filme. Precisa caber no formato. Os nós novos começam com 35 segundos. |
| **Formato** | **trailer**, **curta-metragem** (o padrão), **videoclipe**, **reel** ou **comercial**. O formato molda o roteiro e define a duração permitida. |
| **Resolução de saída** | **480p**, **720p** (o padrão), **1080p** ou **4K**. |
| **Modo** | **Manual** (o padrão), **Automático** ou **Guiado**. Veja [Modos](#modes). |
| **Quadros do avaliador de vídeo** | Quantos quadros de cada tomada o avaliador de vídeo confere: **Primeiro + último** (o padrão e o mais barato), **Primeiro + meio + último** ou **5 igualmente espaçados**, que detecta o maior número de falhas de movimento. |
| **Modelo de imagem** | Opcional. O modelo das imagens de personagens, locais e objetos de cena e dos quadros-chave das cenas, por exemplo Nano Banana Pro ou GPT Image 2.5 Flare. **Automático** deixa o diretor escolher por tomada. |
| **Modelo de vídeo** | Opcional. O modelo de todas as tomadas, por exemplo Seedance 2, Kling 3.0 ou VEO 3.1 Fast. **Automático** deixa o diretor escolher por tomada. Se o modelo não servir para a entrada de uma tomada, essa tomada usa Automático. |
| **LLM do roteiro** | Opcional. O modelo de IA que escreve o roteiro e o plano de cenas: Claude Haiku 4.5, Claude Sonnet 4.6, Claude Opus 4.7 ou Claude Opus 5. **Automático** usa o Claude Sonnet 4.6. Os avaliadores sempre usam o padrão. |

O botão **Executar pipeline** inicia a execução. Depois de uma execução, ele vira **Executar novamente** e inicia um novo pipeline.

### Formatos e durações
| Formato | Mais curto | Mais longo |
| --- | ---: | ---: |
| **reel** | 7 s | 90 s |
| **comercial** | 10 s | 90 s |
| **trailer** | 30 s | 180 s |
| **curta-metragem** | 12 s | 600 s |
| **videoclipe** | 30 s | 600 s |

## Modos
| Modo | O que acontece |
| --- | --- |
| **Manual** | Cada etapa para e espera a sua aprovação. Você pode editar o que a etapa fez, aprovar ou rejeitar com feedback. |
| **Automático** | O pipeline executa todas as etapas sem parar. Avaliadores de IA conferem cada etapa. Depois de três vereditos bloqueantes seguidos em uma mesma etapa, a execução falha, e os créditos não gastos são reembolsados. |
| **Guiado** | Como o Manual, com um chat na etapa Roteiro em que você refina o plano em linguagem natural. Veja [Refinar o plano no modo Guiado](#refine-the-plan-in-guided-mode). |

Um pipeline em execução no modo Automático ou Guiado tem um botão **Mudar para modo manual**. Um pipeline que um gatilho anterior no workflow inicia automaticamente sempre é executado no modo Automático, porque não há ninguém para aprovar.

## As oito etapas
O painel do pipeline lista as etapas em ordem. Cada uma mostra o status: aguardando, em execução, aguardando aprovação ou aprovada.

| Etapa | O que o pipeline faz | O que você aprova |
| --- | --- | --- |
| **1. Roteiro** | O Showrunner escreve o plano: título, logline, elenco, locais, objetos de cena, a lista de cenas e as durações delas. Avaliadores conferem o roteiro e se todos os personagens foram contemplados. | O plano. **Rejeitar com feedback** faz o Showrunner tentar de novo, até duas vezes. |
| **2. Personagens** | Um retrato para cada membro do elenco e uma voz correspondente da biblioteca da ElevenLabs. Depois, variações de ângulo e de expressão para cada personagem. | O retrato e a voz de cada personagem e, depois, todas as variações juntas. |
| **3. Objetos** | Uma imagem de referência para cada objeto de cena. | Todos os objetos de cena juntos. |
| **4. Locais** | Uma imagem principal para cada local e, depois, variações como hora do dia, condições do tempo, o local após o acontecimento ou outro ângulo. | Cada imagem principal e, depois, todas as variações juntas. |
| **5. Lista de tomadas** | Um Diretor de cena planeja cada cena: as tomadas, a câmera, o movimento e o modelo de vídeo de cada tomada. Cada cena aparece no canvas como um nó [**Cena** (Scene)](https://nodaro.ai/docs/nodes/video/scene). | Cada cena. |
| **6. Imagens das cenas** | Um quadro-chave para cada tomada. | Os quadros-chave. |
| **7. Animação e áudio** | Cada tomada é animada, os diálogos ganham voz e sincronização labial, a música é gerada na duração desejada, e um editor de IA escolhe os cortes. | No Manual e no Guiado, uma verificação do tempo dos diálogos e uma prévia sem som antes de a música ser feita. |
| **8. Montagem final** | O filme pronto. | O filme. |

### O que os avaliadores conferem
Avaliadores de IA conferem o trabalho em vários pontos. Nos modos Manual e Guiado, o que eles encontram é mostrado a você; no modo Automático, eles decidem sozinhos.

- **Imagens de personagens e locais.** Um avaliador de visão compara cada imagem principal com a descrição dela. Uma imagem reprovada é feita de novo com as orientações do avaliador, até duas vezes. Uma nota abaixo de 5, em uma escala de 10, sempre conta como reprovação.
- **O storyboard.** Depois que os quadros-chave são feitos, um avaliador os revisa como uma sequência. Ele procura, por exemplo, um personagem cujo visual muda aos poucos, um local que se altera, um salto inexplicado na hora do dia ou uma falha no enredo. Ele só avisa. Quando o storyboard está incoerente, o banner oferece **Derivar da lista de tomadas**.
- **Cada tomada.** Depois que cada tomada é animada, o avaliador de vídeo confere se a ação corresponde ao prompt, se o primeiro quadro continua a tomada anterior e se não há corpos deformados, textos embaralhados ou falhas de movimento. Uma tomada reprovada é feita mais uma vez com o feedback do avaliador. Se ainda for reprovada, o Manual e o Guiado mostram **Pular** e **Gerar novamente** para essa tomada; o Automático faz a execução falhar e reembolsa os créditos não gastos.
- **Match cuts.** Quando uma tomada é planejada como match cut e o avaliador encontra uma quebra com a tomada seguinte, a etapa espera até você escolher **Aceitar quebra** ou criar o quadro-chave de novo.

### O que a etapa Animação e áudio faz
1. **Animar.** Cada tomada é animada a partir do quadro-chave dela com o modelo de vídeo escolhido. As cenas que precisam de continuidade são executadas uma tomada após a outra, cada uma começando do último quadro da tomada anterior.
2. **Dar voz.** As falas ganham voz e, quando a tomada precisa, sincronização labial. Quando o plano tem um roteiro de narração, por exemplo em um trailer, uma faixa de narrador é gravada uma só vez para o filme inteiro.
3. **Conferir o tempo.** No Manual e no Guiado, se a duração real dos diálogos estiver longe do plano, o painel mostra uma **Nova verificação da duração dos diálogos** com uma proposta de redistribuição para você aprovar ou rejeitar.
4. **Prévia sem música.** No Manual e no Guiado, o painel mostra uma **Prévia sem som** para você conferir o tempo antes de a música ser feita.
5. **Trilha.** A música é gerada para o filme, cortada na duração desejada com um fade-out curto, e as batidas dela são detectadas. As durações das tomadas mudam um pouco para que os cortes caiam na batida.
6. **Editar.** Um editor de IA escolhe um corte seco, uma fusão, um match cut ou uma sobreposição para cada junção e evita cortar durante os diálogos. O filme final mistura a música com a narração, se houver, com a música abaixada sob a voz.

## Trabalhar no canvas durante a execução
O pipeline grava nós no canvas enquanto trabalha. O canvas os organiza automaticamente e acompanha a construção enquanto você está parado. Mova ou dê zoom para assumir o controle; clique em **Acompanhar construção** para que ele volte a acompanhar.

A borda de cada nó do pipeline mostra o que você pode fazer com ele:

| Borda | Estado | O que você pode fazer |
| --- | --- | --- |
| Cinza, pulsando | Em execução | Mover ou renomear o nó. As configurações ficam bloqueadas. |
| Âmbar | Aguardando aprovação | Editar as configurações, aprovar ou rejeitar. |
| Azul | Aprovado | Editar as configurações. O editor avisa que etapas posteriores talvez precisem ser feitas de novo. |
| Nenhuma | Ramificado | Qualquer coisa. O nó é totalmente seu. |

Uma pequena marca laranja **desatualizado** indica que algo de que o nó depende mudou, por exemplo um personagem usado em uma cena, e que o nó talvez precise ser feito de novo.

Se você excluir ou desconectar nós do pipeline, o pipeline pausa na etapa seguinte e mostra um banner de divergência do canvas. Restaure o canvas e aprove de novo, ou ramifique o pipeline.

## Controlar a execução
- **Reexecutar a partir daqui.** Inicia um novo pipeline a partir de uma etapa anterior já aprovada, por exemplo para refazer a lista de tomadas com outra direção. O pipeline original fica como está.
- **Interromper execução.** Para o pipeline. Os créditos não gastos são reembolsados.
- **Ramificar pipeline.** Tira o canvas das mãos do pipeline. O pipeline para no próximo ponto de verificação, os créditos não gastos são reembolsados, e todos os nós passam a ser seus para editar. Isso não pode ser desfeito; para continuar com a ajuda da IA, inicie um novo pipeline a partir do canvas ramificado.

Se o serviço reiniciar durante uma execução, o pipeline retoma sozinho, até três vezes. Depois disso, a execução falha, e os créditos não gastos são reembolsados.

## Refinar o plano no modo Guiado
No modo **Guiado**, um chat abre ao lado do painel do pipeline na etapa Roteiro.

- **Peça uma mudança.** Escreva o que você quer, com até 8.000 caracteres por mensagem. O diretor responde em uma frase e pode propor um cartão de mudança.
- **Aplique ou derive.** Uma edição proposta para o plano, como um novo título, a duração de uma cena ou um membro do elenco, tem um botão **Aplicar**. Para uma mudança estrutural, como um novo gênero ou outro personagem principal, o diretor sugere, em vez disso, reexecutar a partir de uma etapa anterior.
- **As referências continuam íntegras.** Uma mudança que removeria um personagem, um local ou um objeto de cena ainda usado em uma cena é rejeitada, e o diretor explica o que corrigir.
- **20 mensagens por pipeline.** Quando o limite é atingido, aprove, derive ou mude para o modo Manual.

Depois da montagem final, o modo Guiado abre um segundo chat para revisar o filme, com 8 mensagens. Esse chat não pode editar o filme diretamente. Ele sugere qual etapa reexecutar, por exemplo o roteiro, os personagens, a lista de tomadas, os quadros-chave ou a animação.

## Créditos
O custo de um filme depende do formato e da duração dele, dos modelos e de quantas vezes você gera de novo. Quando o pipeline começa, ele reserva o custo estimado; o painel mostra a estimativa e o que já foi gasto. O modo Guiado reserva um pouco mais para o chat.

Quando você cancela ou ramifica o pipeline, ou quando a execução falha, os créditos não gastos são reembolsados. Os botões de ferramentas de um nó [Cena](https://nodaro.ai/docs/nodes/video/scene) custam alguns créditos cada, reservados quando você clica e reembolsados se a ferramenta falhar. Veja [Créditos](https://nodaro.ai/docs/concepts/credits).

## Dicas
- **Escreva a história, não as tomadas.** Informe os personagens, o cenário, o conflito e o final. O Showrunner e o Diretor de cena planejam as tomadas.
- **Corrija os problemas cedo.** Um retrato de personagem errado se repete em todas as cenas. Rejeite-o com feedback na etapa 2, e não no final.
- **Use Reexecutar a partir daqui para explorar.** Derive do roteiro ou da lista de tomadas para testar outra direção sem perder a primeira.
- **Fixe os modelos para um visual consistente.** Escolha um **Modelo de imagem** e um **Modelo de vídeo** quando todas as tomadas precisarem ter o mesmo estilo.

## Pela API
Os pipelines têm uma API própria no Nodaro Cloud: `POST /v1/pipelines` inicia uma execução, e outras rotas listam execuções, transmitem eventos e aprovam, rejeitam ou cancelam etapas. Veja a [API de pipelines](https://nodaro.ai/docs/developers/api/pipelines). Assistentes de IA podem dirigir um filme com as ferramentas MCP do [Film Director](https://nodaro.ai/docs/mcp/film-director).

## Frequently asked questions

### O que o nó “História → vídeo” faz?

Um filme pronto a partir de um único prompt de história. Ele escreve o roteiro, gera o elenco, os objetos de cena e os locais, planeja as tomadas, cria um quadro-chave para cada tomada, anima as tomadas com diálogo e música e edita o resultado. Tudo aparece no canvas como nós que você pode alterar.

### Preciso aprovar cada etapa?

Só no modo “Manual”, o padrão, e no modo “Guiado”. No modo “Automático”, o pipeline executa todas as etapas sem parar, e avaliadores de IA conferem cada etapa no seu lugar.

### Qual pode ser a duração de um filme do “História → vídeo”?

Depende do formato. Um reel tem de 7 a 90 segundos, um comercial de 10 a 90, um trailer de 30 a 180, um curta-metragem de 12 a 600 e um videoclipe de 30 a 600 segundos.

### O que acontece com os meus créditos se eu cancelar?

O pipeline reserva o custo estimado quando começa. Quando você cancela, ramifica o pipeline ou a execução falha, os créditos que não foram gastos são reembolsados.

### Posso usar o “História → vídeo” em uma instalação self-hosted?

Não. O “História → vídeo” só roda no Nodaro Cloud.