# Diretor de vídeo

> O Diretor de vídeo escreve, narra e renderiza vídeos de motion graphics em uma chamada, com create_explainer e create_launch_video, nas cores da sua marca.

Source: https://nodaro.ai/pt-BR/docs/mcp/video-director

O **Diretor de vídeo** (Video Director) escreve, narra e renderiza um vídeo de motion graphics com narração a partir de um único pedido. `create_explainer` transforma um tema em um vídeo explicativo, e `create_launch_video` transforma a descrição de um produto em um vídeo de lançamento. O diretor escreve a locução e o plano de tomadas, gera a voz e a alinha palavra por palavra. Depois, renderiza um MP4 em que cada texto ou gráfico aparece no momento em que a narração o diz. Ele é construído sobre o pipeline de [sequência de tomadas](https://nodaro.ai/docs/mcp/shot-sequence), que você também pode conduzir por conta própria.

As ferramentas de uma chamada, `create_explainer` e `create_launch_video`, só existem no Nodaro Cloud. `start_video_director` e as ferramentas de sequência de tomadas funcionam em todas as edições.

## Motion graphics ou imagens animadas
O Diretor de vídeo faz **motion graphics**: tipografia cinética, formas e imagens, nunca cenas ilustradas ou filmadas. Para um vídeo explicativo contado com imagens animadas geradas, use a receita `video-explainer`; veja [Receitas de conteúdo](https://nodaro.ai/docs/mcp/recipes).

Quando você pede “um vídeo explicativo” sem indicar o estilo, o assistente pede que você escolha antes de chamar qualquer ferramenta. Ele segue em frente quando você já escolheu, ou quando o seu pedido já indicava um estilo.

## As três ferramentas
| Ferramenta | O que faz |
| --- | --- |
| `create_explainer` | Escreve e renderiza um vídeo explicativo guiado por conceitos a partir de um `topic` |
| `create_launch_video` | Escreve e renderiza um vídeo de lançamento de produto a partir de um `brief` |
| `start_video_director` | Retorna o guia do diretor, para que o próprio assistente escreva o briefing e execute as etapas uma a uma |

Os parâmetros estão na [referência de ferramentas](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director).

```json
{ "topic": "How transformer self-attention works, in 60 seconds" }
```

```json
{
"brief": "Nodaro is an AI video studio. Paste a prompt, pick a style, get a finished video. For indie creators and small teams who don't have time to edit. Tone: confident, modern, no jargon."
}
```

As duas ferramentas retornam um ID de job. Em clientes com MCP Apps, como o Claude na web, o cartão mostra o progresso e reproduz o vídeo pronto. Outros clientes consultam `get_job` periodicamente; o MP4 fica em `output_data.videoUrl`. O vídeo também é salvo na sua biblioteca.

## O que um vídeo pode conter
- **Textos, formas e imagens** aparecem em sincronia com a locução, cada um no quadro exato em que a frase dele é dita.
- **As formas** são retângulos, círculos e linhas.
- **As imagens** podem ser elementos livres ou capturas de tela nos blueprints `device-surface-showcase` e `cursor-ui-demo`, que mostram as capturas de tela que você enviou em um dispositivo ou com um cursor em movimento.
- **Sem captura ao vivo.** O diretor não consegue capturar um site. `create_launch_video` só com uma `url` responde que precisa de um `brief`; com os dois, ignora a URL.

## Quanto custa
Um vídeo de uma chamada executa estas etapas, cada uma cobrada separadamente:

| Etapa | Créditos |
| --- | --- |
| Autoria: o roteiro da locução e o plano de tomadas | Uma execução de LLM, listada como `video-director` em `list_models` |
| Locução com ElevenLabs v3 | 33 |
| Alinhamento forçado das palavras | 33 |
| Resolução das deixas em quadros | 0 |
| Renderização | 55 |

- **Reembolsos.** Os créditos da autoria voltam se a execução falhar. Cada etapa seguinte só é reembolsada se ela mesma falhar: quando a renderização falha, a locução e o alinhamento que já terminaram continuam cobrados.
- **Uma correção automática.** Às vezes, o plano criado quebra uma regra de tempo, como duas cenas que se sobrepõem. Nesse caso, o diretor recebe uma passada de correção gratuita com o erro exato, sem mudar o roteiro nem as deixas. Se essa passada também falhar, o job falha com um erro `resolve:`.
- **Fazer você mesmo.** Quando o próprio assistente escreve o briefing e executa as etapas com `start_video_director`, não há cobrança de autoria: você paga só a locução, o alinhamento e a renderização.

## Marca
As duas ferramentas aceitam um `brand`: o ID de uma predefinição de [`list_brand_presets`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#list_brand_presets), como `cobalt-corporate`, ou seus próprios tokens, com paleta, fontes e logo. A paleta e as fontes valem para todas as cenas.

```json
{
"topic": "How our new analytics dashboard works",
"brand": {
"palette": { "bg": "#0B0B12", "text": "#FFFFFF", "accent": "#8B5CF6" },
"fonts": { "heading": "Montserrat", "body": "Inter" },
"logo": {
"name": "NODARO",
"image": "https://…/uploads/logo.png",
"imageBackdrop": "#111111"
}
}
}
```

As fontes também podem ter peso, caixa e espaçamento entre letras, definidos separadamente para os títulos e para o corpo do texto. Um valor definido em um elemento prevalece sobre a marca, e a marca prevalece sobre o padrão do blueprint. O espaçamento entre letras nunca é aplicado a textos em árabe, porque separa as letras ligadas. Um peso que a fonte não carrega é trocado pelo mais próximo que ela carrega.

### Logo
| Campo | Observações |
| --- | --- |
| `logo.name` | Obrigatório com um logo. O texto do logo tipográfico, também usado quando a imagem não carrega. |
| `logo.tagline` | Opcional. Uma linha abaixo do logo. |
| `logo.image` | Opcional. Uma URL `https` de um PNG, WebP ou JPEG enviado ao Nodaro, por [`upload_image_widget` ou `request_image_upload`](https://nodaro.ai/docs/mcp/tools/uploads). SVG e outros hosts são recusados. |
| `logo.imageBackdrop` | Opcional. Uma cor hexadecimal para um painel arredondado atrás da imagem do logo. |

Com `logo.image`, o vídeo sempre contém uma cena `logo-assemble-lockup`, o único blueprint que mostra a imagem do logo. Se o plano não tiver essa cena, o diretor a adiciona no final. Se a imagem não carregar na hora da renderização, essa cena mostra o logo tipográfico animado; assim, uma URL ruim nunca faz a renderização falhar. Uma renderização que começa logo depois do upload pode mostrar o logo tipográfico antes de a imagem ficar disponível; renderize de novo depois de uma breve espera.

## Criar o vídeo você mesmo
Para revisar o briefing antes de qualquer renderização, peça ao assistente que chame `start_video_director`. O guia que a ferramenta retorna explica como escolher um gênero (`explainer` ou `product-launch`) e um arco narrativo, escrever a locução como frases de deixa e montar o briefing. Depois, o assistente executa as etapas da [sequência de tomadas](https://nodaro.ai/docs/mcp/shot-sequence): `generate_speech`, `forced_alignment`, `resolve_shot_sequence` e `render_shot_sequence`.

Nesse caminho, o briefing só aceita os tokens de marca como objeto, não como ID de predefinição: copie os tokens de uma predefinição de `list_brand_presets`. A cena do logo não é adicionada automaticamente; por isso, inclua você mesmo uma revelação `logo-assemble-lockup`.

## Frequently asked questions

### O que o Diretor de vídeo do Nodaro faz?

Vídeos de motion graphics com narração. Tipografia cinética, formas e imagens aparecem no momento em que a locução diz a frase delas, sincronizadas no quadro exato. Ele faz vídeos explicativos a partir de um tema e vídeos de lançamento a partir da descrição de um produto.

### Quanto custa um vídeo do Diretor de vídeo?

create_explainer e create_launch_video cobram uma execução de autoria mais as etapas que ela executa: 33 créditos pela locução, 33 pelo alinhamento e 55 pela renderização. list_models lista o preço da autoria como video-director. Executar as etapas você mesmo custa só o preço dessas três etapas.

### O Diretor de vídeo consegue fazer um vídeo a partir da URL do meu site?

Não. Ele não consegue capturar um site ao vivo. Em vez disso, descreva o produto no briefing. Os blueprints de dispositivo e de cursor podem mostrar capturas de tela que você mesmo envia.

### Posso usar meu próprio logo e as cores da minha marca?

Sim. Passe o ID de uma predefinição de marca, ou sua própria paleta, fontes e logo. Com uma imagem de logo, o vídeo sempre termina com uma cena de assinatura do logo.

### O Diretor de vídeo faz cenas ilustradas ou animadas?

Não, ele só faz motion graphics. Para um vídeo explicativo contado com imagens animadas geradas, use a receita video-explainer. Quando você pede um vídeo explicativo sem indicar o estilo, o assistente pergunta qual dos dois você quer.