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.
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 e Sequência de tomadas 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).
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): 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.
Perguntas frequentes
Páginas relacionadas
Diretor de vídeo
Sequência de tomadas
Áudio
Alinhamento forçado
Última atualização
Objetos e criaturas
Liste e leia seus objetos e criaturas, gere imagens e variações, aprove imagens principais e anime clipes de rotação e de repouso num assistente de IA.
Produções do Studio
Parâmetros de cada ferramenta de produção do Studio, da validação grátis do plano à geração de quadros, movimento, voz e trilha, com escopos e cotações.