# Sequência de tomadas e Diretor de vídeo

> Parâmetros do Diretor de vídeo, que cria um vídeo narrado de gráficos animados numa chamada, e da sequência de tomadas, que alinha revelações à narração.

Source: https://nodaro.ai/pt-BR/docs/mcp/tools/shot-sequence-and-video-director

As **ferramentas do Diretor de vídeo e de sequência de tomadas** criam vídeos narrados de gráficos animados: tipografia cinética, formas e imagens que aparecem no momento em que a narração diz a frase correspondente. As ferramentas do Diretor de vídeo fazem isso numa única chamada; as ferramentas de sequência de tomadas expõem cada etapa. Esta página lista os parâmetros. [Diretor de vídeo](https://nodaro.ai/docs/mcp/video-director) e [Sequência de tomadas](https://nodaro.ai/docs/mcp/shot-sequence) explicam como usá-las.

| Ferramenta | Permissão | Créditos |
| --- | --- | --- |
| `start_video_director` | nenhuma | Grátis |
| `create_explainer` | `workflows:execute` | A execução de criação, a narração, o alinhamento e a renderização. Somente no Nodaro Cloud. |
| `create_launch_video` | `workflows:execute` | Como `create_explainer`. Somente no Nodaro Cloud. |
| `list_shot_shapes` | nenhuma | Grátis |
| `get_shot_shape` | nenhuma | Grátis |
| `list_brand_presets` | nenhuma | Grátis |
| `forced_alignment` | `workflows:execute` | 33 |
| `resolve_shot_sequence` | `workflows:execute` | Grátis, sem job |
| `render_shot_sequence` | `workflows:execute` | 55 |

## `start_video_director`
Retorna o guia de direção de movimento que um assistente segue para criar ele mesmo um vídeo narrado. O guia explica como escolher um gênero e um arco narrativo, escrever a narração como frases de deixa, montar o briefing de uma sequência de tomadas e executar o pipeline. A ferramenta não altera nada e pode ser chamada quantas vezes você quiser.

Esta ferramenta não tem parâmetros.

## `create_explainer`
Escreve e renderiza um vídeo explicativo narrado, com marcação de tempo, sobre um tema, numa única chamada. O diretor escreve o roteiro da narração e o briefing da sequência de tomadas, gera a narração, alinha-a palavra por palavra e renderiza o MP4.

**Permissão:** `workflows:execute`. **Créditos:** a execução de criação, mais a narração, o alinhamento e a renderização; `list_models` lista o preço em `video-director`. **Somente no Nodaro Cloud.**

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `topic` | string | **Obrigatório.** O que o vídeo explicativo deve ensinar, de 1 a 8.000 caracteres. |
| `brand` | string or object | Um ID de predefinição de marca, como `cobalt-corporate`, ou os seus próprios tokens de marca. Veja abaixo. |

**Retorna:** um ID de job. O cartão mostra o progresso e reproduz o vídeo. Sem cartões, consulte `get_job` periodicamente; o MP4 fica em `output_data.videoUrl`.

## `create_launch_video`
Escreve e renderiza um vídeo narrado de lançamento de produto a partir de uma descrição do produto, numa única chamada.

**Permissão:** `workflows:execute`. **Créditos:** como `create_explainer`. **Somente no Nodaro Cloud.**

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `brief` | string | O produto: o que ele é, para quem é, os principais recursos e o tom. De 1 a 8.000 caracteres. |
| `brand` | string or object | Como em `create_explainer`. |
| `url` | string | A URL de um produto a capturar. Não é compatível: sem `brief`, a ferramenta responde que precisa de um briefing; com um briefing, a URL é ignorada. |

**Retorna:** um ID de job.

### O objeto `brand`
| Campo | Observações |
| --- | --- |
| `palette` | **Obrigatório.** Cores hexadecimais: `bg`, `text` e `accent` são obrigatórias; `accent2`, `bgAlt`, `line` e `textMuted` são opcionais. |
| `fonts` | **Obrigatório.** `heading` e `body`, cada uma sendo uma das 24 famílias compatíveis, como Inter, Montserrat, Playfair Display ou Bebas Neue. Rubik, Heebo, Cairo e Tajawal cobrem hebraico e árabe. Os campos opcionais `headingType` e `bodyType` definem um `weight` (de 100 a 900), um `casing` (`uppercase`, `lowercase` ou `none`) e um `tracking` (de -0,2 a 0,5 em). |
| `logo` | Opcional. `name` é obrigatório: o texto do logotipo. `tagline` é uma linha abaixo dele. `image` é uma URL `https` de um PNG, WebP ou JPEG enviado ao Nodaro. `imageBackdrop` é uma cor hexadecimal para um painel atrás da imagem. |

## `list_shot_shapes`
Retorna o catálogo dos 15 blueprints de sequência de tomadas: momentos animados prontos, como `kinetic-type-beats` ou `titlecard-reveal`, com os papéis, a descrição e a duração padrão em quadros. Chame-a antes de escrever um briefing, para escolher um blueprint para cada momento.

Esta ferramenta não tem parâmetros.

## `get_shot_shape`
Retorna um blueprint em detalhe: os papéis, a descrição, a duração padrão, o schema JSON dos `params` e um exemplo preenchido que você pode colar num briefing.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `id` | string | **Obrigatório.** O ID de um blueprint, como `titlecard-reveal`. Um ID desconhecido retorna um erro com a lista de IDs conhecidos. |

## `list_brand_presets`
Retorna as 8 predefinições de marca, como `midnight-violet` e `editorial-cream`: uma combinação nomeada de paleta e fontes, com o rótulo, o clima, a descrição, a paleta e as fontes. Passe o ID de uma predefinição como `brand` para manter todas as cenas consistentes.

Esta ferramenta não tem parâmetros.

## `forced_alignment`
Alinha uma transcrição conhecida a um clipe de áudio ou de vídeo e retorna o tempo de início e de fim de cada palavra. A faixa de fala de um vídeo é extraída primeiro, então um clipe de uma pessoa falando pode ser alinhado diretamente. Funciona como o nó [**Alinhamento forçado** (Forced Alignment)](https://nodaro.ai/docs/nodes/audio/forced-alignment).

**Permissão:** `workflows:execute`. **Créditos:** 33.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `transcript` | string | **Obrigatório.** As palavras exatas faladas, com até 50.000 caracteres. Para uma sequência de tomadas, o roteiro exato da narração. |
| `audio_url` ou `audio_asset_id` | string | O áudio ou o vídeo, como URL ou como ID de job do Nodaro. |

**Retorna:** um ID de job. O alinhamento fica em `output_data.alignment`: uma lista de `{ word, start, end }`, em segundos.

## `resolve_shot_sequence`
Combina o briefing de uma sequência de tomadas e os tempos das palavras num plano pronto para renderizar: associa cada deixa às palavras dela e transforma cada revelação baseada em deixa num quadro exato. Executa na hora e retorna o plano, sem job.

**Permissão:** `workflows:execute`. **Créditos:** grátis.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `brief` | object | **Obrigatório.** O briefing da sequência de tomadas: narração, cenas, tomadas e revelações. |
| `audio_url` | string | **Obrigatório.** O áudio da narração. |
| `alignment` | array | **Obrigatório.** O `output_data.alignment` de `forced_alignment`. |

**Retorna:** `plan` e `warnings`, por exemplo uma deixa que não foi encontrada e recebeu um tempo proporcional. Quando as cenas se sobrepõem no tempo, a ferramenta retorna `422 scene_overlap`. A imagem do logo da marca não é adicionada automaticamente aqui: inclua você mesmo uma revelação `logo-assemble-lockup` para mostrá-la.

## `render_shot_sequence`
Renderiza um plano resolvido num MP4. O vídeo também é salvo na sua biblioteca.

**Permissão:** `workflows:execute`. **Créditos:** como o nó [**Renderizar vídeo** (Render Video)](https://nodaro.ai/docs/nodes/video/render-video): 55, em qualquer tamanho de quadro.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `plan` | object | **Obrigatório.** O plano de `resolve_shot_sequence`. |

**Retorna:** um ID de job. O cartão mostra o progresso e reproduz o vídeo.

## Frequently asked questions

### Qual é a diferença entre create_explainer e as ferramentas de sequência de tomadas?

create_explainer escreve o roteiro e o briefing, gera a narração, faz o alinhamento e renderiza o vídeo numa única chamada. As ferramentas de sequência de tomadas permitem que você faça cada etapa por conta própria e revise o briefing antes da renderização.

### O Diretor de vídeo pode usar as cores e o logo da minha marca?

Sim. Passe brand como um ID de predefinição de list_brand_presets, ou como a sua própria paleta, fontes e logo. A imagem do logo precisa ser uma imagem enviada ao Nodaro, em PNG, WebP ou JPEG.

### Quais ferramentas desta família são grátis?

start_video_director, list_shot_shapes, get_shot_shape, list_brand_presets e resolve_shot_sequence não custam nada. forced_alignment e render_shot_sequence gastam créditos, assim como as duas ferramentas de chamada única.