# 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.

Source: https://nodaro.ai/pt-BR/docs/mcp/tools/video

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`](#generate_video) | Texto para vídeo, com referências opcionais |
| [`animate_image`](#animate_image) | Imagem para vídeo, com um quadro final opcional |
| [`extend_video`](#extend_video) | Continua um clipe para a frente no tempo |
| [`modify_video`](#modify_video) | Muda o estilo de um clipe ou o edita com um prompt |
| [`relight_video`](#relight_video) | Reilumina um clipe, ou troca o fundo dele, a partir dos próprios pixels |
| [`video_upscale`](#video_upscale) | Faz o upscale de um clipe |
| [`lip_sync`](#lip_sync) | Faz um rosto falar ou cantar uma faixa de áudio |
| [`speech_to_video`](#speech_to_video) | Anima um retrato de acordo com um clipe de fala |
| [`motion_transfer`](#motion_transfer) | Copia o movimento de um vídeo para a imagem de um personagem |
| [`face_swap`](#face_swap) | Substitui um rosto num vídeo |
| [`stop_video_pro`](#stop_video_pro), [`continue_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)](https://nodaro.ai/docs/nodes/video/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`](https://nodaro.ai/docs/mcp/tools/models-and-credits#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`](https://nodaro.ai/docs/mcp/tools/models-and-credits#list_node_presets). Os campos que você informa a substituem. |
| `structured` | object | Detalhes estruturados adicionados ao prompt, como em [`generate_image`](https://nodaro.ai/docs/mcp/tools/image#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](https://nodaro.ai/docs/mcp/3d-scenes) é 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](https://nodaro.ai/docs/nodes/video/generate-video).

**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.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Seedance 2 Extend](https://nodaro.ai/docs/models/video/seedance-2-extend) | Bytedance | Video extension | a partir de 286 | Extend ANY video: generates the continuation (audio included) and trim-stitches it into one seamless clip. |
| [VEO Extend](https://nodaro.ai/docs/models/video/veo-extend) | Google | Video extension | a partir de 209 | Extend an existing VEO 3.1 clip by another segment. |
| [Runway Extend](https://nodaro.ai/docs/models/video/runway-extend) | Runway | Video extension | 352 | Extend a Runway video by another clip. |

| 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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/video/relight-and-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)](https://nodaro.ai/docs/nodes/video/upscale-video).

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

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Topaz Video Upscale](https://nodaro.ai/docs/models/video/topaz-video-upscale) | Topaz | Video upscaling | 209 | High-quality video upscale and enhancement. |
| [VEO 1080p Upscale](https://nodaro.ai/docs/models/video/veo-1080p-upscale) | Google | Video upscaling | 22 | Upscale VEO output to 1080p. |
| [VEO 4K Upscale](https://nodaro.ai/docs/models/video/veo-4k-upscale) | Google | Video upscaling | 418 | Upscale VEO output to 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)](https://nodaro.ai/docs/nodes/video/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.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [minimax-h3](https://nodaro.ai/docs/models/video/minimax-h3) | MiniMax | Image to video, Text to video | a partir de 253 | MiniMax Hailuo 3 — premium multimodal tier: first/last frame + image/video/audio references, native audio, 2K (default) or 768P output, 4-15s per-second pricing. |
| [Kling Avatar Standard](https://nodaro.ai/docs/models/video/kling-avatar-standard) | Kuaishou | Lip sync | 308 | Lip-sync a still portrait to driving audio. Standard quality. |
| [Kling Avatar Pro](https://nodaro.ai/docs/models/video/kling-avatar-pro) | Kuaishou | Lip sync | 616 | Premium lip-sync — better mouth shape and timing. |
| [Seedance 2](https://nodaro.ai/docs/models/video/seedance-2) | Bytedance | Image to video, Text to video | a partir de 253 | Seedance 2 — premium tier with native audio. Per-second pricing by resolution. |
| [Seedance 2 Fast](https://nodaro.ai/docs/models/video/seedance-2-fast) | Bytedance | Image to video, Text to video | a partir de 198 | Cheaper / quicker Seedance 2 tier. |
| [Seedance 2 Mini](https://nodaro.ai/docs/models/video/seedance-2-mini) | Bytedance | Image to video, Text to video | a partir de 132 | Budget Seedance 2 tier — 480p/720p only, per-second pricing by resolution. |
| [Seedance 2.5](https://nodaro.ai/docs/models/video/seedance-2-5) | Bytedance | Image to video, Text to video | a partir de 374 | Seedance 2.5 — up to 30s in one shot, native audio, wide multimodal references. 480p/720p/1080p. |
| [OmniHuman 1.5](https://nodaro.ai/docs/models/video/omnihuman-1-5) | Bytedance | Lip sync | a partir de 1.122 | Premium prompt-directed talking avatar from a still image + audio. 720p / 1080p, up to 60s. People, pets, anime. |
| [InfiniTalk](https://nodaro.ai/docs/models/video/infinitalk) | InfiniTalk | Lip sync | a partir de 121 | Audio-driven talking-head from a still image. 480p / 720p. |
| [Sync Lipsync v3](https://nodaro.ai/docs/models/video/sync-lipsync-v3) | Sync | Lip sync | a partir de 1.100 | Dub existing footage — re-syncs lips to a new audio track. Video input, billed per second. |
| [Volcengine Lip Sync](https://nodaro.ai/docs/models/video/volcengine-lip-sync) | Volcengine | Lip sync | a partir de 330 | Video-to-video AI dubbing — re-syncs lips to a new vocal track. Multi-speaker (scene detection + speaker ID) in basic mode. Video input, billed per second. |

**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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/video/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](https://nodaro.ai/docs/nodes/video/generate-video-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.

## Frequently asked questions

### Qual modelo generate_video usa por padrão?

O Seedance 2 Fast. Passe model com outro ID de list_models para trocá-lo. Um ID desconhecido volta ao padrão sem erro, e, sem resolution, é usada a resolução mais baixa do modelo, que é a mais barata.

### Qual é a diferença entre generate_video e animate_image?

generate_video parte de um texto. animate_image parte de uma imagem fixa e também pode receber um quadro final, para que o vídeo vá de uma imagem até a outra.

### Como faço um retrato falar pelo MCP?

Chame lip_sync com um retrato ou um vídeo do rosto e uma faixa de áudio. O modelo padrão é o Kling Avatar. speech_to_video é outra opção, que anima um retrato de acordo com um clipe de fala.

### Quanto custa uma geração de vídeo pelo MCP?

O mesmo que no editor. A maioria dos modelos de vídeo é cobrada pela duração e pela resolução, então confira o preço do modelo em list_models antes de informar um custo.

### Posso estender um vídeo que não foi feito no Nodaro?

Sim, com seedance-2-extend. Ele estende qualquer vídeo, por URL ou ID do Nodaro. Os modelos veo-extend e runway-extend só continuam um vídeo que eles mesmos geraram antes.