Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa
Referência das ferramentas

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.

FerramentaPermissãoCréditos
start_video_directornenhumaGrátis
create_explainerworkflows:executeA execução de criação, a narração, o alinhamento e a renderização. Somente no Nodaro Cloud.
create_launch_videoworkflows:executeComo create_explainer. Somente no Nodaro Cloud.
list_shot_shapesnenhumaGrátis
get_shot_shapenenhumaGrátis
list_brand_presetsnenhumaGrátis
forced_alignmentworkflows:execute33
resolve_shot_sequenceworkflows:executeGrátis, sem job
render_shot_sequenceworkflows:execute55

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âmetroTipoObservações
topicstringObrigatório. O que o vídeo explicativo deve ensinar, de 1 a 8.000 caracteres.
brandstring or objectUm 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âmetroTipoObservações
briefstringO produto: o que ele é, para quem é, os principais recursos e o tom. De 1 a 8.000 caracteres.
brandstring or objectComo em create_explainer.
urlstringA 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

CampoObservações
paletteObrigatório. Cores hexadecimais: bg, text e accent são obrigatórias; accent2, bgAlt, line e textMuted são opcionais.
fontsObrigató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).
logoOpcional. 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âmetroTipoObservações
idstringObrigató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âmetroTipoObservações
transcriptstringObrigató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_idstringO á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âmetroTipoObservações
briefobjectObrigatório. O briefing da sequência de tomadas: narração, cenas, tomadas e revelações.
audio_urlstringObrigatório. O áudio da narração.
alignmentarrayObrigató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âmetroTipoObservações
planobjectObrigató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

Última atualização

Nesta página