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.
| Ferramenta | O que faz |
|---|---|
generate_video | Texto para vídeo, com referências opcionais |
animate_image | Imagem para vídeo, com um quadro final opcional |
extend_video | Continua um clipe para a frente no tempo |
modify_video | Muda o estilo de um clipe ou o edita com um prompt |
relight_video | Reilumina um clipe, ou troca o fundo dele, a partir dos próprios pixels |
video_upscale | Faz o upscale de um clipe |
lip_sync | Faz um rosto falar ou cantar uma faixa de áudio |
speech_to_video | Anima um retrato de acordo com um clipe de fala |
motion_transfer | Copia o movimento de um vídeo para a imagem de um personagem |
face_swap | Substitui um rosto num vídeo |
stop_video_pro, continue_video_pro | Para 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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | A descrição do vídeo, com até 8.000 caracteres. Obrigatório, a menos que uma predefinição o forneça. |
model | string | O ID do modelo. Padrão: seedance-2-fast. Um ID desconhecido volta ao padrão. |
duration | number | Segundos. É usado o valor compatível mais próximo. -1 deixa o Seedance 2 escolher a duração. |
aspect_ratio | string | Por exemplo 16:9, 9:16 ou 1:1. Padrão: 16:9. Um valor não compatível é trocado por outro. |
resolution | string | Por exemplo 480p, 720p, 1080p ou 4k, conforme o modelo. Omita-o para usar a resolução mais baixa do modelo, que é a mais barata. |
sound | boolean | Gera som, nos modelos que conseguem. |
negative_prompt | string | O que evitar, com até 8.000 caracteres. |
seed | integer | Uma seed fixa, nos modelos compatíveis. |
reference_image_urls | array | Imagens 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_urls | array | Vídeos de referência de estilo ou de movimento, nos modelos que os aceitam. |
reference_video_captions | array | Para 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_urls | array | Áudio de referência que conduz o movimento, nos modelos que o aceitam. |
presetId | string | Uma predefinição de list_node_presets. Os campos que você informa a substituem. |
structured | object | Detalhes estruturados adicionados ao prompt, como em generate_image. |
described_references | array | Até 10 itens { name, description } para um assunto que você consegue nomear, mas do qual não tem imagem. |
connected_references, reference_order | array | Avanç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
| Modelo | O 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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | O primeiro quadro. |
end_frame_url ou end_frame_asset_id | string | O último quadro. Escolha um modelo cujos features em list_models incluam end-frame. |
prompt | string | O que acontece no vídeo, com até 8.000 caracteres. |
model | string | Padrão: seedance-2-fast. Um ID desconhecido volta ao padrão. |
duration, aspect_ratio, resolution, sound | Como em generate_video. | |
reference_image_urls, reference_video_urls, reference_audio_urls | array | Referê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_trim | object | Corta 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_order | array | Como 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.
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| Seedance 2 Extend | Bytedance | Extensão de vídeo | a partir de 286 | Estende QUALQUER vídeo: gera a continuação (com áudio) e a corta e junta ao original em um único clipe contínuo. |
| VEO Extend | Extensão de vídeo | a partir de 209 | Estende um clipe existente do VEO 3.1 com mais um segmento. | |
| Runway Extend | Runway | Extensão de vídeo | 352 | Estende um vídeo do Runway com mais um clipe. |
| Parâmetro | Tipo | Observações |
|---|---|---|
model | string | Obrigatório. seedance-2-extend, veo-extend ou runway-extend. |
prompt | string | Obrigató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_id | string | Só seedance-2-extend: o vídeo a estender, de qualquer origem. |
kie_task_id | string | Só 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. |
duration | integer | seedance-2-extend: segundos a adicionar, de 4 a 15. Padrão: 8. |
generate_audio | boolean | seedance-2-extend: continua a trilha sonora. Padrão: true. |
resolution | string | seedance-2-extend: 480p, 720p (padrão), 1080p ou 4k. Use a mesma da origem para a junção mais limpa. |
reference_image_urls | array | seedance-2-extend: até 8 imagens de referência, chamadas de @image_1 a @image_8 no prompt, na ordem da lista. |
veo_quality | string | veo-extend: fast ou quality. |
runway_resolution | string | runway-extend: 720p ou 1080p. |
seed | integer | De 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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. A alteração, com até 8.000 caracteres. |
video_url ou video_asset_id | string | Obrigatório, um dos dois. O clipe de origem. |
model | string | wan (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. |
duration | string | Wan e Wan Flash: 5 ou 10 segundos. |
resolution | string | Wan e Wan Flash: 720p ou 1080p. Seedance 2.5: de 480p a 1080p. |
aspect_ratio | string | Só Runway Aleph: 16:9, 9:16, 4:3, 3:4, 1:1 ou 21:9. |
audio | boolean | Só Wan Flash: mantém ou gera de novo o áudio. |
multi_shots | boolean | Só Wan Flash: permite mudanças de cena dentro do clipe. |
reference_image_url | string | Só Runway Aleph: uma imagem de referência de estilo. |
reference_image_urls | array | Só Seedance 2.5: até 30 imagens, citadas no prompt como {image:1}, {image:2} e assim por diante. |
seed | integer | Uma 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âmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O clipe de origem: no máximo 240 quadros e 2.770.000 pixels por quadro. |
prompt | string | A 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_url | string | Uma imagem de referência para o novo visual. Altamente recomendada. |
alpha_mode | string | auto (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_url | string | Obrigatório para select e custom. |
alpha_keyframe_index | integer | Para select: o quadro, contado a partir de 0, que a máscara descreve. |
max_resolution | string | 720 ou 1080 (padrão). |
seed | integer | Uma 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.
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| Topaz Video Upscale | Topaz | Upscale de vídeo | 209 | Upscale e aprimoramento de vídeo de alta qualidade. |
| VEO 1080p Upscale | Upscale de vídeo | 22 | Faz upscale de um vídeo do VEO para 1080p. | |
| VEO 4K Upscale | Upscale de vídeo | 418 | Faz upscale de um vídeo do VEO para 4K. |
| Parâmetro | Tipo | Observações |
|---|---|---|
model | string | topaz (padrão), veo-1080p ou veo-4k. |
video_url ou video_asset_id | string | Obrigatório para topaz. |
upscale_factor | string | Para topaz: 1, 2 ou 4. Padrão: 2. |
kie_task_id | string | Obrigató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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | Um retrato. Use-o para kling-avatar, kling-avatar-pro e infinitalk. |
video_url ou video_asset_id | string | Um clipe do rosto, para os modelos que reanimam um vídeo existente, como latentsync e video-retalking. |
audio_url ou audio_asset_id | string | A fala ou a música. |
model | string | Padrã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. |
prompt | string | Uma dica para a atuação, como a confident TED speaker, com até 500 caracteres. Alguns modelos a usam. |
resolution | string | InfiniTalk: 480p ou 720p. Seedance 2 e 2 Fast: 480p, 720p ou 1080p. OmniHuman 1.5: 720p ou 1080p (padrão). |
seed, fast_mode | Só OmniHuman 1.5: uma seed fixa e um modo mais rápido, com qualidade um pouco menor. | |
mode | string | Só 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_seconds | Só 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.
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| minimax-h3 | MiniMax | Imagem para vídeo, Texto para vídeo | a partir de 253 | MiniMax 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 Standard | Kuaishou | Sincronização labial | 308 | Sincroniza os lábios de um retrato estático com um áudio guia. Qualidade padrão. |
| Kling Avatar Pro | Kuaishou | Sincronização labial | 616 | Sincronização labial premium — formato da boca e tempo mais precisos. |
| Seedance 2 | Bytedance | Imagem para vídeo, Texto para vídeo | a partir de 253 | Seedance 2 — nível premium com áudio nativo. Preço por segundo conforme a resolução. |
| Seedance 2 Fast | Bytedance | Imagem para vídeo, Texto para vídeo | a partir de 198 | Nível mais barato e mais rápido do Seedance 2. |
| Seedance 2 Mini | Bytedance | Imagem para vídeo, Texto para vídeo | a partir de 132 | Nível econômico do Seedance 2 — só 480p/720p, preço por segundo conforme a resolução. |
| Seedance 2.5 | Bytedance | Imagem para vídeo, Texto para vídeo | a partir de 374 | Seedance 2.5 — até 30 s em uma única tomada, áudio nativo e amplas referências multimodais. 480p/720p/1080p. |
| OmniHuman 1.5 | Bytedance | Sincronização labial | a partir de 1.122 | Avatar falante premium dirigido por prompt, a partir de uma imagem fixa e um áudio. 720p / 1080p, até 60 s. Pessoas, pets e anime. |
| InfiniTalk | InfiniTalk | Sincronização labial | a partir de 121 | Cabeça falante guiada por áudio, a partir de uma imagem fixa. 480p / 720p. |
| Sync Lipsync v3 | Sync | Sincronização labial | a partir de 1.100 | Dubla 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 Sync | Volcengine | Sincronização labial | a partir de 330 | Dublagem 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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. O movimento e a cena, com até 2.500 caracteres. |
image_url ou image_asset_id | string | O retrato. |
audio_url ou audio_asset_id | string | A fala. |
resolution | string | 480p (padrão), 580p ou 720p. |
negative_prompt | string | O 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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | Obrigatório. O personagem. |
video_url ou video_asset_id | string | Obrigatório. O vídeo cujo movimento é copiado. |
prompt | string | O resultado que você quer, com até 8.000 caracteres. |
provider | string | O modelo. Padrão: kling. |
resolution | string | 480p, 580p, 720p (padrão) ou 1080p. |
character_orientation | string | Qual enquadramento prevalece: image (padrão) ou video. |
background_source | string | Qual entrada fornece o fundo: input_video ou input_image, nos modelos compatíveis. |
video_duration | number | A 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âmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo de origem. |
face_image_url ou face_image_asset_id | string | O 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âmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigató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âmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. O job original do Gerar vídeo Pro. |
from_segment | integer | O 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
Páginas relacionadas
Gerar vídeo
Sincronização labial
Edição de vídeo
Imagem
Modelos de vídeo
Última atualização
Imagem
Gere, transforme, edite, componha e descreva imagens e crie máscaras num assistente de IA com as ferramentas do Nodaro: parâmetros, padrões e créditos.
Ediçã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.