Docs do NodaroEdição de vídeo
Corte, junte, repita, legende, sobreponha e monte vídeos num assistente de IA com as ferramentas de edição do Nodaro, várias delas grátis e sem IA.
As ferramentas de edição de vídeo transformam clipes gerados num vídeo pronto: cortam, juntam, repetem em loop e legendam os clipes, colocam imagens sobre eles, adicionam ou substituem o som e montam vídeos narrados. A maioria renderiza com o FFmpeg, e não com um modelo de IA, então elas são rápidas, dão sempre o mesmo resultado e custam poucos créditos ou nenhum. Todas as ferramentas precisam da permissão workflows:execute e retornam um ID de job.
| Ferramenta | O que faz | Créditos |
|---|---|---|
trim_video | Corta um clipe por tempo, por quadros ou no ponto de loop mais limpo | Pela duração, em blocos de 5 segundos |
combine_videos | Junta clipes, com transições ou um corte inteligente sem emenda | Pela duração, em blocos de 5 segundos |
loop_video | Repete um clipe um certo número de vezes ou até uma duração | Pela duração, em blocos de 5 segundos |
extract_frame | Extrai um quadro como imagem | 11 |
merge_video_audio | Adiciona ou substitui o som de um vídeo | 22 |
add_captions | Grava no vídeo legendas comuns ou legendas palavra por palavra | 33, ou 55 para legendas animadas ou com estilo |
overlay_images | Mostra imagens sobre um vídeo em momentos definidos | 22 |
still_to_video | Transforma uma imagem e uma faixa de áudio num vídeo | Grátis |
slideshow | Transforma de 2 a 100 imagens e um áudio opcional numa apresentação de slides | Grátis |
gif_to_video | Converte um GIF animado em MP4 | Grátis |
assemble_narrated_video | Encaixa blocos de voz sobre os clipes deles num único vídeo narrado | 44: 3 unidades, mais uma unidade a cada 6 blocos ou fração de 6 |
trim_video
Corta um clipe. Escolha um de três modos: por tempo, por quadros ou no ponto de loop mais limpo. Funciona como o nó Cortar vídeo (Trim Video).
Permissão: workflows:execute. Créditos: pela duração do clipe gerado, em blocos de 5 segundos, como no nó Cortar vídeo.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O clipe de origem. |
start_time, end_time | number | Por tempo: o trecho a manter, em segundos. end_time precisa vir depois de start_time. |
trim_start_frames, trim_end_frames | integer | Por quadros: quantos quadros remover do início ou do fim. Eles têm prioridade sobre os tempos. São úteis quando os quadros exatos importam, como em clipes do VEO 3.1 a 24 fps. |
smart_loop_cut | boolean | Encontra, entre os últimos quadros, o que mais se parece com o quadro 0 e corta ali, para um loop limpo. Tem prioridade sobre os outros modos. |
smart_loop_cut_lookback | integer | Quantos quadros finais comparar, de 2 a 64. Padrão: 16. |
silent | boolean | Remove o som. Padrão: false. |
Retorna: um ID de job. Um corte de loop inteligente informa o quadro escolhido em output_data.smartLoopCut.
combine_videos
Junta dois ou mais clipes num único vídeo, com uma transição ou um corte inteligente sem emenda. Funciona como o nó Combinar vídeos (Combine Videos).
Permissão: workflows:execute. Créditos: pela duração estimada da saída, em blocos de 5 segundos, como no nó Combinar vídeos.
| Parâmetro | Tipo | Observações |
|---|---|---|
videos | array | Obrigatório. Pelo menos 2 clipes, cada um { url } ou { asset_id }, na ordem de reprodução. |
transition | string | A transição entre os clipes, como cut, fade, dissolve, dip-to-black, wipe-left, slide-up, circle-open, pixelize ou zoom-in. A ferramenta lista cerca de 50. |
transition_duration | number | De 0 a 5 segundos. |
audio_mode | string | keep, crossfade ou remove. |
audio_crossfade_duration | number | Um fade cruzado só do som, de 0 a 5 segundos. A imagem não muda. Por padrão, acompanha transition_duration. |
audio_crossfade_curve | string | Com crossfade: linear, equal-power, smooth, logarithmic ou exponential. |
smart_cut | boolean | Compara os últimos quadros de cada clipe com os primeiros quadros do seguinte e corta onde eles combinam. A junção fica sem emenda em clipes gerados a partir do último quadro do clipe anterior. Só no Nodaro Cloud. |
smart_cut_mode | string | best-pair (padrão), preroll-keep-prev ou preroll-keep-next, que decidem qual lado de uma sobreposição é mantido. |
smart_cut_frames_prev, smart_cut_frames_next | integer | A janela de busca no fim e no início de cada clipe, de 1 a 24 quadros. Padrão: 8. |
Retorna: um ID de job.
loop_video
Repete um clipe um certo número de vezes, ou até ele atingir uma duração. Funciona como o nó Vídeo em loop (Loop Video).
Permissão: workflows:execute. Créditos: pela duração da saída, em blocos de 5 segundos, como no nó Vídeo em loop.
| Parâmetro | Tipo | Observações |
|---|---|---|
mode | string | Obrigatório. repeat para um número de cópias, ou duration para repetir até uma duração e cortar ali. |
video_url ou video_asset_id | string | O clipe de origem. |
repeat_count | integer | Para repeat: de 2 a 20 cópias. |
target_duration | number | Para duration: a duração, de 1 a 300 segundos. |
smart_cut_before_repeat | boolean | Corta o clipe no ponto de loop mais limpo antes de repeti-lo, para que nenhuma emenda apareça em nenhuma repetição. Recomendado para clipes do VEO 3.1 feitos a partir de um primeiro e de um último quadro. |
smart_cut_lookback | integer | Quantos quadros finais comparar, de 2 a 64. Padrão: 16. |
Retorna: um ID de job.
extract_frame
Extrai um quadro de um vídeo como imagem: o primeiro, o último ou o de um momento que você escolher. Use o último quadro de um clipe como primeiro quadro do seguinte para encadear tomadas. Funciona como o nó Extrair quadro (Extract Frame).
Permissão: workflows:execute. Créditos: 11.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo de origem. |
mode | string | first, last ou timestamp. |
time_seconds | number | O momento do quadro. Informá-lo implica timestamp. |
Retorna: um ID de job. O resultado é uma imagem.
merge_video_audio
Adiciona som a um vídeo ou substitui o som dele: uma narração, uma trilha sonora ou uma dublagem. Funciona como o nó Mesclar vídeo e áudio (Merge Video & Audio).
Permissão: workflows:execute. Créditos: 22.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo. |
audio_url ou audio_asset_id | string | Uma faixa de áudio. |
audio_tracks | array | Várias faixas, no lugar de uma, cada uma { url, start_time, volume }: quando ela começa no vídeo, em segundos, e o volume dela, de 0 a 200, em que 100 é o original. |
voiceover_volume | number | O volume do novo áudio, de 0 a 200. Padrão: 100. |
keep_original_audio | boolean | Mantém o som do próprio vídeo por baixo do novo áudio. Padrão: true. |
background_volume | number | O volume do som do próprio vídeo, de 0 a 200. Padrão: 30. |
Retorna: um ID de job.
add_captions
Grava legendas num vídeo: um bloco de legenda estático ou legendas animadas, sincronizadas palavra por palavra. Funciona como o nó Adicionar legendas (Add Captions), cuja página documenta todos os estilos e opções.
Permissão: workflows:execute. Créditos: 33 para uma legenda simples; 55 para um estilo animado ou para uma legenda com opções de estilo.
| Estilo | O que mostra |
|---|---|
subtitle (padrão) | Um bloco estático. Com text, esse texto é gravado como está durante todo o vídeo e nunca é substituído por uma transcrição. Sem text, a fala é legendada. |
word-highlight, karaoke, bouncy | Uma linha por vez, sincronizada palavra por palavra, com a palavra falada em destaque |
tiktok-words | Páginas curtas de palavras. Uma página nunca atravessa o fim de uma frase ou uma pausa, e dura no máximo 1,5 segundo. |
word-pop | Uma palavra por vez. Cada palavra fica na tela até a próxima começar, por no máximo 1,5 segundo. |
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo. |
style | string | Um dos estilos acima. Padrão: subtitle. |
text | string | Em subtitle, o texto exato a gravar. Num estilo animado, é só um texto de reserva, usado quando a transcrição não retorna nada ou está desativada. |
captions | array | As suas próprias palavras com tempo, um { text, startMs, endMs } por palavra, em milissegundos. É o formato que transcribe retorna. |
auto_transcribe | boolean | Transcreve a fala do vídeo para marcar o tempo das palavras. |
transcribe_provider | string | incredibly-fast-whisper (padrão), elevenlabs-stt ou whisper. Os estilos animados precisam do tempo de cada palavra, então whisper é recusado quando a transcrição é a única fonte desses tempos. |
look | string | outline (Montserrat 900, maiúsculas, contorno preto, palavra falada em amarelo) ou clean. Sem valor definido, é outline nos estilos animados e clean em subtitle. |
font_family, font_size, font_weight, color, uppercase | A tipografia. Rubik, Heebo, Cairo e Tajawal cobrem hebraico e árabe. | |
stroke_color, stroke_width, background_color | O contorno e a caixa de fundo. | |
position, position_y | bottom, top ou center, ou o centro do bloco em porcentagem da altura. Cerca de 65 fica abaixo de um rosto e acima dos botões de um app. | |
max_words_per_line | integer | De 1 a 20 palavras por linha, ou por página de tiktok-words. 1 ou 2 dão o visual impactante das redes sociais. Sem valor definido, a linha se ajusta à largura. Não tem efeito em word-pop. |
highlight_color, animate | Só nos estilos animados: a cor da palavra falada, e false para parar o movimento das palavras. | |
segments | array | Tratamentos diferentes para trechos de tempo do mesmo vídeo, cada um com start_ms, end_ms, as próprias opções e, opcionalmente, o próprio texto. Os trechos não podem se sobrepor. |
As opções de estilo também funcionam em subtitle, mas uma legenda com estilo é cobrada pelo preço animado. Para usar a sua própria transcrição corrigida, mapeie as palavras de transcribe em captions, uma entrada por palavra.
Retorna: um ID de job.
overlay_images
Mostra de 1 a 20 imagens sobre um vídeo, cada uma durante um intervalo de tempo: um logo, uma foto de produto, uma captura de tela ou um cartão. Nenhum modelo de IA é executado, e o som do vídeo é mantido como está. Funciona como o nó Sobreposição em vídeo (Video Overlay).
Permissão: workflows:execute. Créditos: 22 no Nodaro Cloud.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo base, por exemplo um resultado de combine_videos. |
layers | array | Obrigatório. De 1 a 20 camadas. |
output_aspect | string | Renderiza num canvas 16:9, 9:16, 1:1 ou 4:5 em vez do tamanho do próprio vídeo, com base_fit (cover, o padrão, ou contain) e uma background_color. |
Cada camada recebe uma imagem, url ou asset_id, que pode ser um resultado de image_overlay, e estes campos:
| Campo da camada | Observações |
|---|---|
start, end | start é obrigatório. O intervalo de tempo, em segundos. Sem end, a camada fica até o fim do vídeo. |
preset | card (centralizado, encaixado em 78% por 60% do quadro), corner-badge (18% de largura, perto do corner, no canto inferior direito por padrão) ou full-frame. |
anchor, x, y, width, height, fit | Uma caixa exata, nas mesmas unidades de porcentagem de image_overlay. Um campo de caixa tem prioridade sobre a predefinição. Sem nenhum dos dois, a camada é um selo de canto. |
opacity, animate, z_index | A opacidade, um fade curto com escala na entrada e na saída (ativado por padrão) e a ordem de empilhamento. |
As camadas que passam do fim do vídeo são cortadas ou ignoradas, e uma imagem animada mostra o primeiro quadro dela; a saída do job lista os dois casos como warnings. Um ID de camada que não é encontrado é recusado antes de qualquer execução, com a posição dele na lista. Passe o ID de job do resultado para add_captions como video_asset_id para legendá-lo em seguida.
Retorna: um ID de job.
still_to_video
Transforma uma imagem e uma faixa de áudio num vídeo, renderizado localmente, sem um modelo de IA. O vídeo dura exatamente o mesmo que o áudio. Use-o para slides narrados, um vídeo com a capa de uma música ou um momento parado dentro de uma edição mais longa. Para movimento com IA, use animate_image. Funciona como o nó Imagem fixa para vídeo (Still to Video).
Permissão: workflows:execute. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | A imagem. |
audio_url ou audio_asset_id | string | O áudio, que define a duração. |
motion | string | none (padrão), zoom-in, zoom-out, pan-left, pan-right ou ken-burns. |
intensity | integer | A força do movimento, de 1 a 10. Padrão: 3. |
resolution | string | 720p, 1080p (padrão) ou 4K. Em 4K, com movimento, a renderização é mais lenta. |
aspect_ratio | string | 16:9 (padrão), 9:16, 1:1 ou 4:3. |
fps | integer | 24 ou 30 (padrão). |
fit, pad_color | string | cover (padrão, corta para preencher) ou contain (adiciona barras na cor pad_color, preta por padrão). |
Retorna: um ID de job.
slideshow
Transforma de 2 a 100 imagens e uma faixa de áudio opcional num vídeo de apresentação de slides, renderizado localmente, sem um modelo de IA. Funciona como o nó Apresentação de slides (Slideshow).
Permissão: workflows:execute. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
image_urls ou image_asset_ids | array | De 2 a 100 imagens, em ordem. |
audio_url ou audio_asset_id | string | Opcional. Com áudio, o vídeo dura exatamente o mesmo que o áudio, e os slides dividem esse tempo igualmente. |
image_durations | array | Os segundos de cada slide, ou null para automático. Com áudio, os totais que não coincidem são ajustados proporcionalmente para caber, e a saída do job informa em quanto. |
per_image_duration | number | Sem áudio: os segundos por slide, de 0,5 a 60. Padrão: 3. |
transition, transition_duration | Uma transição como cut, fade, dissolve, dip-to-black ou wipe-left, e a duração dela, de até 5 segundos. Uma transição desconhecida volta para cut. | |
motion, intensity | none, zoom-in, zoom-out, ken-burns ou alternate, que alterna o zoom a cada slide, com uma força de 1 a 10. | |
resolution, aspect_ratio, fps, fit, pad_color | Como em still_to_video. |
Para uma única imagem, use still_to_video. Para movimento com IA entre imagens, use animate_image.
Retorna: um ID de job.
gif_to_video
Converte um GIF animado num MP4 H.264, renderizado localmente, sem um modelo de IA. Use-o para passar um GIF como referência de movimento para um modelo de vídeo que não aceita GIFs, como o Seedance. Funciona como o nó GIF para vídeo (Gif to Video).
Permissão: workflows:execute. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
gif_url ou gif_asset_id | string | O GIF. |
loop_to_minimum | boolean | Repete um GIF curto até target_duration. Padrão: true. Um GIF que não faz um loop limpo é reproduzido para a frente e depois para trás, para que nenhum salto apareça. |
target_duration | number | A duração do loop, de 2 a 8 segundos. Padrão: 3. |
interpolate | boolean | Adiciona quadros para um movimento suave a 24 fps. Padrão: true. false mantém o tempo original do GIF. |
alpha_background | string | O fundo de um GIF transparente: white (padrão) ou black. |
Retorna: um ID de job. Um GIF de um só quadro vira um clipe curto e parado.
assemble_narrated_video
Encaixa blocos ordenados, cada um com um clipe e uma voz, num único vídeo narrado. Quando uma voz é mais curta que o clipe dela, ela fica centralizada, com silêncio em volta. Quando é mais longa, o clipe fica mais lento para caber, até um limite, e depois congela no último quadro. A voz nunca é cortada. Funciona como o nó Montar vídeo narrado (Assemble Narrated Video).
Permissão: workflows:execute. Créditos: 44, pelo número de blocos: 3 unidades, mais uma unidade a cada 6 blocos ou fração de 6, como no nó Montar vídeo narrado.
| Parâmetro | Tipo | Observações |
|---|---|---|
blocks | array | Obrigatório. De 1 a 60 blocos na ordem de reprodução, cada um com um vídeo (video_url ou video_asset_id) e uma voz opcional (audio_url ou audio_asset_id). Os clipes não podem ter diálogo. |
voice_volume | number | O volume da voz, em porcentagem, de 0 a 200. Padrão: 100. |
clip_audio_volume | number | O som dos próprios clipes por baixo da voz, de 0 a 200. Padrão: 40. |
max_slowdown | number | Quanto um clipe pode ficar mais lento para uma voz longa, de 1 a 2. Padrão: 1.5. |
trim_start_frames, trim_end_frames | integer | Quadros cortados do início de cada bloco depois do primeiro e do fim de cada bloco antes do último, para junções sem emenda. Até 120. Padrão: 0. |
Retorna: um ID de job. A receita video-explainer termina com esta ferramenta; veja Receitas de conteúdo.
Perguntas frequentes
Páginas relacionadas
Vídeo
Adicionar legendas
Combinar vídeos
Análise e listas de edição
Receitas de conteúdo
Última atualização
Vídeo
Gere vídeo de texto ou imagem, estenda, reestilize, reilumine e faça upscale de clipes e faça rostos falar ou se mover num assistente de IA com o Nodaro.
Análise e listas de edição
Analise um vídeo cena a cena, audite a análise, detecte silêncios, sincronize gravações e planeje e renderize listas de decisões de edição com o MCP.