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

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.

As ferramentas de vídeo permitem que um assistente crie e transforme vídeos no Nodaro. Com elas, ele gera um clipe a partir de texto ou de uma imagem, estende o clipe ou muda o estilo dele, reilumina o clipe, faz o upscale dele e faz um rosto falar ou copiar um movimento. Cada ferramenta inicia um job e retorna o ID dele, e o resultado é salvo na sua biblioteca. Todas as ferramentas de vídeo precisam da permissão workflows:execute. Os jobs de vídeo costumam levar de 2 a 10 minutos.

FerramentaO que faz
generate_videoTexto para vídeo, com referências opcionais
animate_imageImagem para vídeo, com um quadro final opcional
extend_videoContinua um clipe para a frente no tempo
modify_videoMuda o estilo de um clipe ou o edita com um prompt
relight_videoReilumina um clipe, ou troca o fundo dele, a partir dos próprios pixels
video_upscaleFaz o upscale de um clipe
lip_syncFaz um rosto falar ou cantar uma faixa de áudio
speech_to_videoAnima um retrato de acordo com um clipe de fala
motion_transferCopia o movimento de um vídeo para a imagem de um personagem
face_swapSubstitui um rosto num vídeo
stop_video_pro, continue_video_proPara ou retoma uma execução longa do Gerar vídeo Pro (Generate Video Pro)

generate_video

Cria um vídeo a partir de um prompt de texto. Funciona como o nó Gerar vídeo (Generate Video).

Permissão: workflows:execute. Créditos: o preço do modelo, que na maioria dos modelos depende da duração e da resolução. Confira o pricing do modelo em list_models antes de informar um custo.

ParâmetroTipoObservações
promptstringA descrição do vídeo, com até 8.000 caracteres. Obrigatório, a menos que uma predefinição o forneça.
modelstringO ID do modelo. Padrão: seedance-2-fast. Um ID desconhecido volta ao padrão.
durationnumberSegundos. É usado o valor compatível mais próximo. -1 deixa o Seedance 2 escolher a duração.
aspect_ratiostringPor exemplo 16:9, 9:16 ou 1:1. Padrão: 16:9. Um valor não compatível é trocado por outro.
resolutionstringPor exemplo 480p, 720p, 1080p ou 4k, conforme o modelo. Omita-o para usar a resolução mais baixa do modelo, que é a mais barata.
soundbooleanGera som, nos modelos que conseguem.
negative_promptstringO que evitar, com até 8.000 caracteres.
seedintegerUma seed fixa, nos modelos compatíveis.
reference_image_urlsarrayImagens de referência de identidade ou de estilo, como URLs ou IDs do Nodaro. Cada modelo tem o próprio limite, por exemplo 30 no Seedance 2.5, 9 no Seedance 2 e no MiniMax Hailuo 3, 7 no Gemini Omni e 3 no VEO 3.1. Os modelos sem referências as ignoram.
reference_video_urlsarrayVídeos de referência de estilo ou de movimento, nos modelos que os aceitam.
reference_video_captionsarrayPara que serve cada vídeo de referência, na mesma ordem, com até 500 caracteres cada. Cada descrição vira uma linha como @video_1: … no prompt.
reference_audio_urlsarrayÁudio de referência que conduz o movimento, nos modelos que o aceitam.
presetIdstringUma predefinição de list_node_presets. Os campos que você informa a substituem.
structuredobjectDetalhes estruturados adicionados ao prompt, como em generate_image.
described_referencesarrayAté 10 itens { name, description } para um assunto que você consegue nomear, mas do qual não tem imagem.
connected_references, reference_orderarrayAvançado. Referências rotuladas e ordenadas, no próprio formato do editor, até 14.

Retorna: um ID de job. Nos clientes com MCP Apps, o cartão reproduz o vídeo quando ele fica pronto.

Com o Seedance, escreva um vídeo com vários momentos como Shot 1: … Shot 2: …, use um movimento de câmera por tomada e descreva o som no prompt. get_node_skill com generate-video retorna as regras de prompt de cada família de modelos.

Um vídeo de referência diz ao modelo para copiar algo do clipe. Diga para que ele serve em reference_video_captions. Por exemplo, uma renderização em massinha cinza de uma cena 3D é um guia de layout, não um visual; sem uma descrição, o modelo pode copiar também o visual de massinha cinza.

Observações sobre os modelos

ModeloO que saber
Seedance 2 (seedance-2)Aceita resolution: "4k" e aspect_ratio: "adaptive" ou "21:9".
Seedance 2 Fast e Mini (seedance-2-fast, seedance-2-mini)Somente 480p e 720p.
Seedance 2.5 (seedance-2-5)480p, 720p ou 1080p, e até 30 segundos numa única chamada. Até 30 imagens, 10 vídeos e 10 clipes de áudio de referência.
MiniMax Hailuo 3 (minimax-h3)Até 9 imagens, 3 vídeos e 3 clipes de áudio de referência. resolution é 2K (padrão) ou o mais barato 768P, e o áudio está sempre ativado. Um vídeo só com texto precisa de uma proporção específica. Os vídeos de referência têm de 2 a 15 segundos cada, 15 segundos no total, e o áudio de referência precisa vir com uma referência de imagem ou de vídeo.
Wan 3.0 (wan-3, wan-3-prime)Até 10 imagens, 5 vídeos e 5 clipes de áudio de referência, cada clipe com 1 a 15 segundos e 15 segundos no total por tipo. duration vai de 2 a 30 segundos, padrão 5. resolution é 480p, 720p ou 1080p. wan-3-prime é mais rápido e custa mais.
Gemini Omni Flash (gemini-omni-flash)A versão mais barata e mais rápida do Gemini Omni. duration é 4, 6, 8 ou 10 segundos, padrão 8. aspect_ratio é 16:9 ou 9:16. resolution é 720p, 1080p ou 4k.
VEO 3.1 Quality (veo3)Não tem modo de referência; use o VEO 3.1 Fast ou o Lite para referências.

No Seedance 2, no MiniMax Hailuo 3 e no Wan 3.0, um quadro inicial ou final enviado junto com referências vira mais uma imagem de referência, descrita no prompt como o quadro de abertura ou de encerramento. No Seedance, os vídeos de referência são cobrados pela duração de entrada mais a duração de saída, então clipes de referência mais longos reservam mais créditos.

animate_image

Anima uma imagem fixa num vídeo. Passe também um quadro final, e o vídeo vai da primeira imagem até a segunda. Funciona como o modo imagem para vídeo do Gerar vídeo.

Permissão: workflows:execute. Créditos: o preço do modelo.

ParâmetroTipoObservações
image_url ou image_asset_idstringO primeiro quadro.
end_frame_url ou end_frame_asset_idstringO último quadro. Escolha um modelo cujos features em list_models incluam end-frame.
promptstringO que acontece no vídeo, com até 8.000 caracteres.
modelstringPadrão: seedance-2-fast. Um ID desconhecido volta ao padrão.
duration, aspect_ratio, resolution, soundComo em generate_video.
reference_image_urls, reference_video_urls, reference_audio_urlsarrayReferências dentro dos limites de cada modelo, por exemplo 30 imagens no Seedance 2.5, 9 no Seedance 2 e no MiniMax Hailuo 3 e 7 no Gemini Omni, no Kling 3 Omni e no Grok.
loop_trimobjectCorta o resultado no ponto de loop mais limpo: enabled, frames_to_test (de 1 a 64) e quality, lossless ou precise. O parâmetro antigo auto_loop_trim ainda funciona e corresponde a este.
described_references, connected_references, reference_orderarrayComo em generate_video.

A ferramenta escolhe o modo pelo que você passa: quadros (um primeiro quadro e um último opcional) ou referências. Vídeos e áudios de referência não podem ser combinados com um quadro final. Para um loop sem emenda, use a mesma imagem como primeiro e último quadro, desative o som, depois junte as cópias com combine_videos e adicione o som com merge_video_audio.

Retorna: um ID de job.

extend_video

Continua um clipe para a frente no tempo. Escolha o modelo primeiro: dois modelos continuam um vídeo que eles mesmos geraram, e um estende qualquer vídeo.

Permissão: workflows:execute. Créditos: o preço do modelo de extensão.

ModeloDesenvolvedorModosCréditosDetalhes
Seedance 2 ExtendBytedanceExtensão de vídeoa partir de 286Estende QUALQUER vídeo: gera a continuação (com áudio) e a corta e junta ao original em um único clipe contínuo.
VEO ExtendGoogleExtensão de vídeoa partir de 209Estende um clipe existente do VEO 3.1 com mais um segmento.
Runway ExtendRunwayExtensão de vídeo352Estende um vídeo do Runway com mais um clipe.
ParâmetroTipoObservações
modelstringObrigatório. seedance-2-extend, veo-extend ou runway-extend.
promptstringObrigatório. O que acontece em seguida, com até 8.000 caracteres. Com seedance-2-extend, descreva só a continuação.
video_url ou video_asset_idstringSó seedance-2-extend: o vídeo a estender, de qualquer origem.
kie_task_idstringSó veo-extend e runway-extend: o ID da tarefa da geração anterior do VEO ou do Runway, que vem da saída do job dela.
durationintegerseedance-2-extend: segundos a adicionar, de 4 a 15. Padrão: 8.
generate_audiobooleanseedance-2-extend: continua a trilha sonora. Padrão: true.
resolutionstringseedance-2-extend: 480p, 720p (padrão), 1080p ou 4k. Use a mesma da origem para a junção mais limpa.
reference_image_urlsarrayseedance-2-extend: até 8 imagens de referência, chamadas de @image_1 a @image_8 no prompt, na ordem da lista.
veo_qualitystringveo-extend: fast ou quality.
runway_resolutionstringrunway-extend: 720p ou 1080p.
seedintegerDe 10.000 a 99.999.

Retorna: um ID de job. seedance-2-extend gera o que acontece em seguida, com áudio, e junta isso à origem num único clipe.

modify_video

Muda o estilo de um clipe existente ou o edita com um prompt. Funciona como o nó Vídeo para vídeo (Video to Video).

Permissão: workflows:execute. Créditos: o preço do modelo.

ParâmetroTipoObservações
promptstringObrigatório. A alteração, com até 8.000 caracteres.
video_url ou video_asset_idstringObrigatório, um dos dois. O clipe de origem.
modelstringwan (padrão, Wan 2.6, a opção geral), wan-flash, wan-videoedit, luma-modify, runway-aleph, happyhorse-edit ou seedance-2-5. Um ID desconhecido volta para wan.
durationstringWan e Wan Flash: 5 ou 10 segundos.
resolutionstringWan e Wan Flash: 720p ou 1080p. Seedance 2.5: de 480p a 1080p.
aspect_ratiostringSó Runway Aleph: 16:9, 9:16, 4:3, 3:4, 1:1 ou 21:9.
audiobooleanSó Wan Flash: mantém ou gera de novo o áudio.
multi_shotsbooleanSó Wan Flash: permite mudanças de cena dentro do clipe.
reference_image_urlstringSó Runway Aleph: uma imagem de referência de estilo.
reference_image_urlsarraySó Seedance 2.5: até 30 imagens, citadas no prompt como {image:1}, {image:2} e assim por diante.
seedintegerUma seed fixa.

Com seedance-2-5, o prompt é uma instrução que edita o clipe inteiro. O resultado mantém a duração e a proporção da origem, e o clipe precisa ter de 4 a 30 segundos. A cobrança é igual à de uma execução do Seedance 2.5 com um vídeo de referência: segundos de entrada mais segundos de saída, reservados para o clipe mais longo e liquidados pela duração entregue.

Retorna: um ID de job.

relight_video

Reilumina um clipe, troca ou muda o estilo do fundo dele ou compõe novos elementos, usando os próprios pixels do vídeo de origem. Ela executa o Beeble SwitchX e funciona como o nó Reiluminar e trocar (Relight & Switch).

Permissão: workflows:execute. Créditos: definidos pelo número de quadros e pela resolução de saída.

ParâmetroTipoObservações
video_url ou video_asset_idstringO clipe de origem: no máximo 240 quadros e 2.770.000 pixels por quadro.
promptstringA nova iluminação ou o novo visual, com até 2.000 caracteres. Passe um prompt, uma imagem de referência ou os dois.
reference_image_urlstringUma imagem de referência para o novo visual. Altamente recomendada.
alpha_modestringauto (padrão) mascara o assunto principal. fill muda o estilo do quadro inteiro. select usa mask_url como uma máscara de quadro-chave. custom usa mask_url como um vídeo de máscara para todos os quadros.
mask_urlstringObrigatório para select e custom.
alpha_keyframe_indexintegerPara select: o quadro, contado a partir de 0, que a máscara descreve.
max_resolutionstring720 ou 1080 (padrão).
seedintegerUma seed fixa.

Retorna: um ID de job. Os resultados trazem uma atribuição ao SwitchX.

video_upscale

Faz o upscale de um clipe para uma resolução maior. Funciona como o nó Upscale de vídeo (Upscale Video).

Permissão: workflows:execute. Créditos: o preço do modelo de upscale.

ModeloDesenvolvedorModosCréditosDetalhes
Topaz Video UpscaleTopazUpscale de vídeo209Upscale e aprimoramento de vídeo de alta qualidade.
VEO 1080p UpscaleGoogleUpscale de vídeo22Faz upscale de um vídeo do VEO para 1080p.
VEO 4K UpscaleGoogleUpscale de vídeo418Faz upscale de um vídeo do VEO para 4K.
ParâmetroTipoObservações
modelstringtopaz (padrão), veo-1080p ou veo-4k.
video_url ou video_asset_idstringObrigatório para topaz.
upscale_factorstringPara topaz: 1, 2 ou 4. Padrão: 2.
kie_task_idstringObrigatório para veo-1080p e veo-4k: o ID da tarefa da geração original do VEO.

Retorna: um ID de job.

lip_sync

Faz um rosto falar ou cantar uma faixa de áudio: um retrato vira uma cabeça falante, ou a boca num clipe existente acompanha um novo áudio. Funciona como o nó Sincronização labial (Lip Sync).

Permissão: workflows:execute. Créditos: o preço do modelo. A descrição do parâmetro model da ferramenta lista o preço de cada modelo.

ParâmetroTipoObservações
image_url ou image_asset_idstringUm retrato. Use-o para kling-avatar, kling-avatar-pro e infinitalk.
video_url ou video_asset_idstringUm clipe do rosto, para os modelos que reanimam um vídeo existente, como latentsync e video-retalking.
audio_url ou audio_asset_idstringA fala ou a música.
modelstringPadrão: kling-avatar, uma cabeça falante em 720p. Outros incluem kling-avatar-pro, infinitalk, omnihuman-1-5, latentsync, wav2lip, video-retalking, sadtalker, heygen-lipsync-precision, lipsync-2-pro, sync-lipsync-v3, volcengine-lipsync, a família Seedance 2 e minimax-h3. Um ID desconhecido volta para kling-avatar.
promptstringUma dica para a atuação, como a confident TED speaker, com até 500 caracteres. Alguns modelos a usam.
resolutionstringInfiniTalk: 480p ou 720p. Seedance 2 e 2 Fast: 480p, 720p ou 1080p. OmniHuman 1.5: 720p ou 1080p (padrão).
seed, fast_modeSó OmniHuman 1.5: uma seed fixa e um modo mais rápido, com qualidade um pouco menor.
modestringSó Volcengine: lite (padrão, uma pessoa de frente para a câmera) ou basic (cenas complexas).
open_scenedet, separate_vocal, align_audio, align_audio_reverse, templ_start_secondsSó Volcengine: detecção de falantes quando há várias pessoas falando, remoção de ruído do áudio, repetição do vídeo de origem até a duração do áudio e o momento de início na origem.

get_node_skill com lip-sync explica qual modelo serve para canto, dublagem, tomadas cinematográficas de corpo inteiro ou o rascunho mais barato.

ModeloDesenvolvedorModosCréditosDetalhes
minimax-h3MiniMaxImagem para vídeo, Texto para vídeoa partir de 253MiniMax Hailuo 3 — nível multimodal premium: quadro inicial e final mais referências de imagem, vídeo e áudio, áudio nativo, saída em 2K (padrão) ou 768P e preço por segundo, de 4 a 15 s.
Kling Avatar StandardKuaishouSincronização labial308Sincroniza os lábios de um retrato estático com um áudio guia. Qualidade padrão.
Kling Avatar ProKuaishouSincronização labial616Sincronização labial premium — formato da boca e tempo mais precisos.
Seedance 2BytedanceImagem para vídeo, Texto para vídeoa partir de 253Seedance 2 — nível premium com áudio nativo. Preço por segundo conforme a resolução.
Seedance 2 FastBytedanceImagem para vídeo, Texto para vídeoa partir de 198Nível mais barato e mais rápido do Seedance 2.
Seedance 2 MiniBytedanceImagem para vídeo, Texto para vídeoa partir de 132Nível econômico do Seedance 2 — só 480p/720p, preço por segundo conforme a resolução.
Seedance 2.5BytedanceImagem para vídeo, Texto para vídeoa partir de 374Seedance 2.5 — até 30 s em uma única tomada, áudio nativo e amplas referências multimodais. 480p/720p/1080p.
OmniHuman 1.5BytedanceSincronização labiala partir de 1.122Avatar falante premium dirigido por prompt, a partir de uma imagem fixa e um áudio. 720p / 1080p, até 60 s. Pessoas, pets e anime.
InfiniTalkInfiniTalkSincronização labiala partir de 121Cabeça falante guiada por áudio, a partir de uma imagem fixa. 480p / 720p.
Sync Lipsync v3SyncSincronização labiala partir de 1.100Dubla um vídeo existente — sincroniza de novo os lábios com uma nova faixa de áudio. Entrada de vídeo, cobrança por segundo.
Volcengine Lip SyncVolcengineSincronização labiala partir de 330Dublagem de vídeo para vídeo com IA — sincroniza de novo os lábios com uma nova faixa de voz. Vários falantes (detecção de cenas e identificação de falantes) no modo básico. Entrada de vídeo, cobrança por segundo.

Retorna: um ID de job. O cartão reproduz o vídeo quando ele fica pronto.

speech_to_video

Anima um retrato para que ele fale um clipe de áudio, com sincronização labial no rosto e movimento na cabeça e no corpo. Ela executa o Wan Speech to Video e funciona como o nó Fala para vídeo (Speech to Video).

Permissão: workflows:execute. Créditos: de 33 a 66.

ParâmetroTipoObservações
promptstringObrigatório. O movimento e a cena, com até 2.500 caracteres.
image_url ou image_asset_idstringO retrato.
audio_url ou audio_asset_idstringA fala.
resolutionstring480p (padrão), 580p ou 720p.
negative_promptstringO que evitar, com até 2.500 caracteres.

Retorna: um ID de job.

motion_transfer

Copia o movimento de um vídeo-guia para a imagem de um personagem, para que o personagem faça o mesmo movimento. Funciona como o nó Transferir movimento (Motion Transfer).

Permissão: workflows:execute. Créditos: o preço do modelo e da duração.

ParâmetroTipoObservações
image_url ou image_asset_idstringObrigatório. O personagem.
video_url ou video_asset_idstringObrigatório. O vídeo cujo movimento é copiado.
promptstringO resultado que você quer, com até 8.000 caracteres.
providerstringO modelo. Padrão: kling.
resolutionstring480p, 580p, 720p (padrão) ou 1080p.
character_orientationstringQual enquadramento prevalece: image (padrão) ou video.
background_sourcestringQual entrada fornece o fundo: input_video ou input_image, nos modelos compatíveis.
video_durationnumberA duração da saída, de 1 a 60 segundos, nos modelos compatíveis.

Retorna: um ID de job.

face_swap

Substitui o rosto num vídeo pelo rosto de um retrato. Funciona como o nó Trocar rosto (Face Swap).

Permissão: workflows:execute. Créditos: 143.

ParâmetroTipoObservações
video_url ou video_asset_idstringO vídeo de origem.
face_image_url ou face_image_asset_idstringO retrato cujo rosto é usado.

Retorna: um ID de job.

stop_video_pro

Para um job do Gerar vídeo Pro em andamento, o mecanismo que faz vídeos longos em segmentos, por exemplo a partir de um workflow com o nó Gerar vídeo Pro. O segmento em andamento é abandonado, mas ainda é cobrado, os segmentos restantes são pulados, e todos os segmentos concluídos são juntados no vídeo final do job. O restante dos créditos reservados é reembolsado. Um job que ainda não começou é cancelado com reembolso total.

Permissão: workflows:execute. Créditos: grátis; a reserva não usada é reembolsada.

ParâmetroTipoObservações
job_idstringObrigatório. O job do Gerar vídeo Pro.

Retorna: uma confirmação. Consulte o job periodicamente com get_job: ele termina com output_data.pro.stopped definido como true e o vídeo parcial como resultado.

continue_video_pro

Continua, como um novo job, uma execução do Gerar vídeo Pro que foi parada, que falhou ou que terminou. Os segmentos antes de from_segment são reaproveitados, e todos os segmentos a partir dele são gerados de novo. Uma execução que falhou precisa de pelo menos um segmento entregue.

Permissão: workflows:execute. Créditos: só os segmentos gerados de novo, mais a taxa fixa do Gerar vídeo Pro.

ParâmetroTipoObservações
job_idstringObrigatório. O job original do Gerar vídeo Pro.
from_segmentintegerO primeiro segmento a gerar de novo, contado a partir de 1, até 24. Padrão: o primeiro segmento que falta. Passe um anterior para refazer o fim de uma execução concluída.

Retorna: o ID do novo job.

Perguntas frequentes

Última atualização

Nesta página