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 uma tarefa e retorna o ID dela, e o resultado é salvo na sua biblioteca. Todas as ferramentas de vídeo precisam da permissão workflows:execute. As tarefas 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, ou finaliza um rascunho do Seedance 2.5 em 1080p |
video_depth | Transforma um clipe em um vídeo de profundidade |
video_mask | Acompanha um assunto descrito em texto e retorna um vídeo de máscara |
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 |
video_remake | Video Remake: substitui as pessoas, os pets, os produtos ou o lugar de um vídeo curto pelas suas imagens |
list_trends, get_trend, estimate_trend, run_trend | Executa uma receita pronta do Video Remake com as imagens do usuário |
stop_video_pro, continue_video_pro | Para ou retoma uma execução longa do Gerar vídeo Pro |
generate_video
Cria um vídeo a partir de um prompt de texto. Funciona como o nó Gerar vídeo.
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, ou o seu modelo de vídeo salvo. Um ID desconhecido volta ao padrão. Um modelo que não é de geração de vídeo é recusado. Veja Um modelo indicado para a outra rota. |
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: a sua proporção salva; senão 16:9, quando o modelo a lista; e, se não, a primeira proporção listada. 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. Alguns modelos, como o Seedance 2.5, o Seedance 2.5 Flash e o HappyHorse 1.1, não aceitam seed. Eles a ignoram, e execuções repetidas variam. |
reference_task_type | string | Só seedance-2-5 e seedance-2-5-flash: para que serve a mídia de referência. auto (padrão) deixa isso para o prompt. reference mantém a proporção e a duração que você definiu. edit roda no formato e na duração do próprio vídeo de referência, com cada vídeo de referência de 4 a 30 segundos. extend continua o vídeo de referência na duração que você definiu, e a origem não é juntada ao resultado. Ignorado sem mídia de referência e nos outros modelos. |
draft | boolean | No seedance-2-5, um rascunho em 480p pelo preço de uma execução em 480p. Finalize a tomada de que gostar com video_upscale e model: "seedance-2-5-hd". Veja Modo rascunho do Seedance 2.5. |
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, 10 no Seedance 2.5 Flash, 9 no Seedance 2 e no MiniMax H3, 7 no Gemini Omni e 3 no VEO 3.1. Os modelos sem referências as ignoram. No grok, a chamada roda como grok-i2v com até 7 delas. |
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. |
character_references | array | Somente Gemini Omni, Gemini Omni Flash, Gemini Omni Flash 1.2, Kling 4.0 e Kling 4.0 Flash. Mantém o rosto de uma pessoa real, até 3 entradas no Gemini Omni e no Gemini Omni Flash, 2 no Gemini Omni Flash 1.2 e 7 no Kling 4.0 e no Kling 4.0 Flash. Veja Manter o rosto de uma pessoa. |
keep_original_sound | boolean | Somente Kling 4.0 e Kling 4.0 Flash. Mantém o som próprio dos vídeos de referência. Ignorado sem um vídeo de referência. |
audio_soundtrack | boolean | Somente Kling 4.0. O primeiro clipe de reference_audio_urls toca como trilha sonora por padrão. false envia todos os clipes como amostras de voz, sem trilha sonora. |
user_request | string | A última mensagem do usuário para o assistente, palavra por palavra, com até 4.000 caracteres. Ela fica guardada no nó, no workflow da conversa, e nunca muda o que é gerado. Veja As conversas MCP viram workflows. |
flow_id | string | "new" começa um novo workflow para esta etapa. O ID de workflow de um resultado anterior adiciona a etapa a esse workflow. Até 36 caracteres. Veja Conversas MCP. |
Retorna: um ID de tarefa. 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. |
Seedance 2.5 Flash (seedance-2-5-flash) | A versão mais rápida e de menor custo do Seedance 2.5. duration vai de 4 a 30 segundos, padrão 8, e -1 deixa o modelo escolher a duração. resolution é 480p ou 720p, e 1080p renderiza e cobra 720p. Áudio nativo, sem seed e sem draft. Até 10 imagens, 5 vídeos e 5 clipes de áudio de referência; mais do que isso é recusado antes de qualquer reserva de créditos (too_many_references). Vídeos e clipes de áudio de referência têm de 2 a 30 segundos cada e 30 segundos no total, e um áudio que não é WAV nem MP3 é convertido para MP3. Um prompt com áudio de referência sozinho é uma chamada válida. Com um quadro inicial, aspect_ratio é sempre adaptive. Ele roda com créditos grátis como um clipe de 4 segundos em 480p. |
MiniMax H3 (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. |
Kling 4.0 (kling-4) | Texto para vídeo só com o prompt, ou até 10 reference_image_urls, 5 reference_video_urls (cada um de 2 a 30 segundos, e 30 segundos no total, ou a chamada é recusada antes de qualquer reserva de créditos; um clipe com mais de 2048 px no lado maior, ou com mais pixels que 1920×1080, é reduzido para caber, mantendo o formato, antes do envio), 7 character_references (cada um um sujeito nomeado) e 3 reference_audio_urls, com no máximo 15 materiais no total. Um quadro inicial ou final conta como imagem. Mais que isso é recusado antes de qualquer reserva. O primeiro clipe de áudio toca como a trilha sonora do resultado por padrão. Ele é enviado como mais um vídeo de referência que carrega o áudio, então ocupa uma das 5 vagas de vídeo, e a execução é cobrada como uma execução com vídeo de referência. Os outros clipes de áudio continuam vozes nomeadas. audio_soundtrack: false mantém todos os clipes como vozes. No prompt, nomeie os materiais como @image_1, @video_1, um personagem como @<name> e um clipe de voz como @audio_1. Uma execução com vídeo de referência cobra a saída mais o maior valor entre a saída e os clipes, pela tarifa de referência. |
Kling 4.0 Keyframes (kling-4-keyframes) | Um quadro inicial, até 8 quadros intermediários como reference_image_urls, em ordem, e um quadro final. A duração do clipe limita o total de quadros, de 4 com 3 segundos a 10 a partir de 9 segundos. No prompt, os quadros são @first_frame, @keyframe_1 e seguintes, e @last_frame. Sem vídeos de referência, áudio nem personagens. |
Kling 4.0 Flash (kling-4-flash) | O Kling 4.0 mais rápido e de menor custo. duration vai de 3 a 20 segundos, padrão 5. A saída é só em 720p: qualquer resolution renderiza e cobra 720p. aspect_ratio é como no kling-4. O áudio está sempre ativado, e não há seed nem quadro final. No animate_image, um quadro inicial sozinho é o quadro de abertura exato. Qualquer outra coisa roda no modo de referência, com no máximo 15 materiais no total: um generate_video só com o prompt, até 10 reference_image_urls, até 5 reference_video_urls (de 2 a 20 segundos somados, ou a chamada é recusada antes de qualquer reserva de créditos), até 7 character_references, ou um quadro inicial junto com qualquer um deles. O clipe N de reference_audio_urls (até 7) vira a voz da entrada N de character_references, em ordem. Um personagem precisa de 2 a 4 imagens para carregar uma voz. Um clipe cujo personagem tem uma só imagem, e qualquer clipe depois do último personagem, é descartado, e a execução começa mesmo assim. Escreva quem fala pelo nome do personagem. O animate_image não aceita character_references, então envie as vozes pelo generate_video. keep_original_sound: true mantém o som próprio de um vídeo de referência, e não há audio_soundtrack. Uma execução com vídeo de referência cobra a saída mais o maior valor entre a saída e os clipes, pela tarifa de referência. Ao contrário dos outros modelos Kling, ele roda com créditos gratuitos, como um clipe de 3 ou 4 segundos. |
| Kling 4.0 e Kling 4.0 Keyframes | duration vai de 3 a 30 segundos, padrão 5. resolution é 720p (padrão) ou 1080p. aspect_ratio é auto (padrão), 16:9, 9:16, 1:1 ou 21:9. O áudio está sempre ativado, e não há seed. |
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. |
Gemini Omni Flash 1.2 (gemini-omni-flash-1-2) | O Gemini Omni Flash mais recente, com preço por segundo. duration é qualquer número inteiro de segundos de 3 a 15. resolution é 360p, 720p (padrão), 1080p ou 4k, e o 4K não está disponível no plano gratuito. aspect_ratio é 16:9, 9:16 ou auto. Ele aceita até 6 imagens de referência, ou 5 junto com um vídeo de origem. Um quadro inicial sozinho, ou um quadro inicial e um final em um clipe de até 10 segundos, são usados como quadros exatos. Com referências, ou acima de 10 segundos, os quadros entram nas imagens de referência e são nomeados no prompt. Um vídeo de origem é editado e cobrado pela própria duração, até 15 segundos. Um clipe mais longo usa os primeiros 15 segundos. Ele aceita até 2 character_references, nunca com um quadro inicial ou final, e sem voice_preset. Com referências, os quadros guiam o clipe, mas não são quadros exatos: para uma abertura exata, envie os quadros sem referências. |
PixVerse V6 Max (pixverse-v6-max) | Roda dos dois jeitos. No animate_image, o quadro inicial é o primeiro quadro exato, e o clipe fica no formato desse quadro. Um generate_video só com prompt aceita aspect_ratio 16:9 (padrão), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 ou 21:9. duration vai de 1 a 15 segundos, padrão 5. resolution é 360p, 540p, 720p (padrão) ou 1080p, e qualquer outro valor renderiza e cobra 720p. seed vai de 0 a 2147483647. O áudio fica ligado, a menos que sound: false, e uma execução com áudio custa mais que uma sem som. Sem quadro final e sem imagens, vídeos ou áudios de referência. |
Grok Imagine 1.5 (grok-imagine-video-1.5) | Só animate_image: precisa de um quadro inicial. image_url é o primeiro quadro exato e end_frame_url o último quadro exato. A mesma imagem nos dois faz um loop sem emenda. Até 4 reference_image_urls são quadros intermediários, em ordem, distribuídos por igual ao longo do clipe. Um clipe de D segundos aceita no máximo D − 1 deles, e o resto fica de fora. duration vai de 1 a 15 segundos, padrão 8. resolution é 480p (padrão), 720p ou 1080p, e qualquer outro valor renderiza e cobra 480p. Em 1080p, aceita só o quadro inicial: um quadro final, um loop ou quadros intermediários são recusados antes de qualquer reserva de créditos. Sem seed, vídeos de referência, áudio ou personagens. O preço é por segundo, conforme a resolução, e os quadros não acrescentam nada. |
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 H3 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.
Manter o rosto de uma pessoa
Para manter o rosto de uma pessoa real no Gemini Omni ou no Gemini Omni Flash, passe character_references: até 3 entradas { image_url, description }, cada uma com body_image_url, name e voice_preset opcionais. image_url é um retrato, e description descreve a pessoa. Esta é a entrada de identidade do próprio modelo, então ela mantém o rosto, enquanto reference_image_urls só orienta o clipe.
- Outros modelos respondem com um erro em vez de executar sem ela.
- Ela não pode ser combinada com um quadro inicial.
- Ela divide o orçamento de 7 unidades de entrada do modelo com as imagens de referência (1 unidade cada) e um vídeo de origem (2 unidades). Um personagem conta 1 unidade, ou 2 com um
body_image_url. voice_preseté um ID de voz do Gemini, comokore. Ele mantém a mesma voz para esse personagem em todos os clipes.
No Gemini Omni Flash 1.2 (gemini-omni-flash-1-2), são aceitas até 2 entradas. Elas não contam nas 6 imagens de referência dele, não podem ser combinadas com um quadro inicial ou final, e voice_preset é recusado.
No Kling 4.0 (kling-4) e no Kling 4.0 Flash (kling-4-flash), cada uma das até 7 entradas vira um sujeito nomeado. image_url, body_image_url e até 3 extra_image_urls são as suas 2 a 4 imagens, e uma entrada com uma só imagem é enviada como uma imagem de referência comum. O prompt o chama de @<name>, um quadro inicial é permitido, e voice_preset é recusado.
No Kling 4.0 e no Kling 4.0 Flash, uma entrada também pode trazer video_url: um clipe de 3 a 8 segundos do personagem, em uma única tomada contínua. O personagem é então criado a partir desse vídeo, e o modelo tira dele o visual, e a voz quando o clipe tem fala. A entrada continua precisando de image_url e description. No máximo 3 personagens podem ser criados a partir de um vídeo, e no máximo 5 vídeos podem ser enviados no total, contando os vídeos de referência. Qualquer outro modelo recusa um video_url com character_video_unsupported. Um personagem criado a partir de um vídeo tem o preço de um personagem criado a partir de imagens.
As referências de personagem não somam créditos ao preço do clipe.
Padrões de vídeo salvos
generate_video e animate_image leem os padrões de vídeo salvos na sua conta: model, aspectRatio, resolution e duration. Salve-os em mcpPreferences.video com PATCH /v1/user/settings, ou com client.userSettings.update({ mcpPreferences: { video } }) no SDK. Veja Configurações do usuário. Nenhuma ferramenta MCP os salva.
- Um valor que a chamada informa prevalece. Um valor salvo preenche o que a chamada deixa de fora, ajustado ao modelo: uma proporção ou duração que o modelo não lista passa para a mais próxima que ele lista.
- Sem nenhum dos dois. A proporção é
16:9quando o modelo a lista e, se não, a primeira proporção listada. O tamanho e a duração são os padrões do modelo. - O modelo salvo. Ele só é usado quando a rota da chamada o aceita: um modelo de texto para vídeo em
generate_videoe um modelo de geração de vídeo emanimate_image. Caso contrário, roda o padrão da chamada. - Apagar um campo. Um campo salvo como
nullé apagado, e o padrão da chamada volta a valer para ele.
Um modelo indicado para a outra rota
Alguns modelos têm um ID por modo: Grok Imagine (grok e grok-i2v), Wan (wan e wan-i2v), Wan 2.7 (wan-2.7-t2v e wan-2.7-i2v) e HappyHorse (happyhorse e happyhorse-i2v). Um modelo assim roda com o ID da ferramenta que você chama, seja qual for o ID que você indicar.
grok-i2vnumgenerate_videosó com prompt roda comogrok, egrokemanimate_imageroda comogrok-i2v. A proporção, o tamanho e a duração são ajustados a esse ID.generate_videocomreference_image_urlsouconnected_referencesnogrokroda comogrok-i2vcom as imagens, até 7, porque ogroknão aceita nenhuma. O preço é o dogrok-i2v.- No Wan, no Wan 2.7 e no HappyHorse, o ID de imagem para vídeo também não aceita imagens de referência. As imagens são descartadas, e a execução usa só o prompt.
- Um modelo que nenhuma das duas ferramentas executa, como um modelo de imagem, de sincronia labial ou de edição de vídeo, é recusado com um erro que lista os modelos que funcionam. Nada é cobrado.
- Um ID que o catálogo não conhece continua voltando ao padrão.
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, ou o seu modelo de vídeo salvo. Um ID desconhecido volta ao padrão. Veja Um modelo indicado para a outra rota. |
duration, aspect_ratio, resolution, sound, draft | Como em generate_video, com os seus padrões de vídeo salvos. | |
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 H3 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. |
user_request | string | A última mensagem do usuário para o assistente, palavra por palavra, com até 4.000 caracteres. Ela fica guardada no nó, no workflow da conversa, e nunca muda o que é gerado. Veja As conversas MCP viram workflows. |
flow_id | string | "new" começa um novo workflow para esta etapa. O ID de workflow de um resultado anterior adiciona a etapa a esse workflow. Até 36 caracteres. Veja Conversas MCP. |
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 tarefa.
extend_video
Continua um clipe para a frente no tempo. Escolha o modelo primeiro: três modelos continuam um vídeo que eles mesmos geraram, cinco estendem qualquer vídeo, e um estende qualquer vídeo 16:9 ou 9:16.
Permissão: workflows:execute. Créditos: o preço do modelo de extensão. Os modelos Seedance, Kling 4, Gemini Omni Flash 1.2 e PixVerse V6 cobram por segundos e resolução.
Seedance 2.5, Seedance 2.5 Flash e Gemini Omni Flash 1.2 cobram por segundo enviado e adicionado. No PixVerse V6, generate_audio muda o preço.
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| 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-5-extend (Seedance 2.5), seedance-2-5-flash-extend (Seedance 2.5 Flash), seedance-2-0-extend (Seedance 2.0), kling-4-extend (Kling 4), gemini-omni-flash-1-2-extend (Gemini Omni Flash 1.2), pixverse-v6-extend (PixVerse V6), grok-extend (Grok), veo-extend ou runway-extend. |
prompt | string | Obrigatório. O que acontece em seguida, com até 8.000 caracteres. Com um modelo Seedance, descreva só a continuação. |
video_url ou video_asset_id | string | Só modelos Seedance, Kling 4, Gemini Omni Flash 1.2 e PixVerse V6: o vídeo a estender, de qualquer origem. O Gemini Omni Flash 1.2 só aceita um vídeo 16:9 ou 9:16. |
task_id | string | Só veo-extend, runway-extend e grok-extend: o ID da tarefa da geração anterior do VEO, do Runway ou do Grok Imagine, o providerTaskId da saída dessa geração. |
duration | integer | Segundos a adicionar. De 4 a 30 no seedance-2-5-extend e no seedance-2-5-flash-extend, de 4 a 15 no seedance-2-0-extend e de 3 a 10 no gemini-omni-flash-1-2-extend, padrão 8. De 3 a 30 no kling-4-extend, padrão 5. De 1 a 15 no pixverse-v6-extend, padrão 5. 6 ou 10 no grok-extend, padrão 6. |
generate_audio | boolean | Só modelos Seedance e PixVerse V6: continua a trilha sonora. Padrão: true. No Kling 4 e no Gemini Omni Flash 1.2, as novas imagens sempre têm som. |
resolution | string | Seedance 2.5 e Seedance 2.0: 480p, 720p (padrão) ou 1080p. Seedance 2.5 Flash: 480p ou 720p (padrão). Kling 4: 720p (padrão) ou 1080p. Gemini Omni Flash 1.2: 360p, 720p (padrão), 1080p ou 4k, nunca acima da resolução da própria origem. PixVerse V6: 360p, 540p, 720p (padrão) ou 1080p. O Grok mantém a resolução do vídeo de origem. Use a mesma da origem para a junção mais limpa. |
reference_image_urls | array | Modelos Seedance: 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. |
O Grok continua só um vídeo do Grok Imagine feito no Nodaro, a partir de texto ou de uma imagem. Qualquer outra origem é recusada com grok_extend_source antes de qualquer cobrança.
Cada modelo lê o final da origem. O Seedance 2.5, o Seedance 2.5 Flash e o Gemini Omni Flash 1.2 continuam a partir dos últimos 10 segundos da origem. O Seedance 2.0 continua a partir dos últimos 2 segundos, e o Kling 4 a partir dos últimos 3. Uma origem mais curta é enviada inteira. O PixVerse V6 e o Gemini Omni Flash 1.2 juntam só os novos segundos deles ao clipe original. O Gemini Omni Flash 1.2 não continua diálogos.
Uma duração ou resolução que o modelo não oferece é recusada antes de qualquer cobrança. O mesmo vale para uma origem com pouca imagem: menos de 1,8 segundo no Seedance, menos de 2 segundos no Seedance 2.5 Flash e no Kling 4, e menos de cerca de 4 segundos no Gemini Omni Flash 1.2. O Gemini Omni Flash 1.2 também recusa uma origem que não seja 16:9 nem 9:16. Um prompt do PixVerse V6 com menos de 3 caracteres também é recusado. seed só funciona no VEO. O LTX 2.3 Pro Extend não é oferecido por esta ferramenta.
Retorna: um ID de tarefa. Um modelo Seedance, Kling 4, Gemini Omni Flash 1.2 ou PixVerse V6 gera o que acontece em seguida 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.
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, seedance-2-5 ou seedance-2-5-flash. Um ID desconhecido é recusado. |
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. Seedance 2.5 Flash: 480p ou 720p. |
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 e Seedance 2.5 Flash: até 30 imagens (10 no Seedance 2.5 Flash), citadas no prompt como {image:1}, {image:2} e assim por diante. |
seed | integer | Uma seed fixa. seedance-2-5, seedance-2-5-flash e happyhorse-edit não aceitam seed e a ignoram. |
draft | boolean | Só Seedance 2.5: renderiza a edição como um rascunho em 480p. Finalize-a em 1080p com video_upscale e model: "seedance-2-5-hd". |
Com seedance-2-5 ou seedance-2-5-flash, o prompt é uma instrução que edita o clipe inteiro. O Seedance 2.5 Flash não aceita draft. 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. A reserva é a duração do clipe mais longo (a origem, ou um clipe de referência extra mais longo) arredondada para cima até um segundo inteiro, mais um segundo, e a liquidação é pela duração entregue. Enquanto o clipe não pode ser medido, a reserva é feita para o clipe mais longo do modelo.
Retorna: um ID de tarefa.
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.
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 tarefa. 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.
Permissão: workflows:execute. Créditos: o preço do modelo de upscale. O Topaz é medido: ele reserva créditos pelo tamanho da saída e cobra o que o upscale realmente usou. Veja Upscale de vídeo › Créditos.
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| Topaz Video Upscale | Topaz | Upscale de vídeo | 44 | Aumento de resolução e aprimoramento de vídeo com alta qualidade, para 720p, 1080p ou 4K, de 15 a 60 fps (os quadros são interpolados). Cobrança por medição: o preço é por unidade do Topaz, e uma execução usa algumas unidades por gigapixel de saída. |
| VEO 1080p Upscale | Upscale de vídeo | 22 | Aumenta a resolução de um vídeo do VEO para 1080p. | |
| VEO 4K Upscale | Upscale de vídeo | 418 | Aumenta a resolução de um vídeo do VEO para 4K. |
| Parâmetro | Tipo | Observações |
|---|---|---|
model | string | topaz (padrão), veo-1080p, veo-4k, seedance-2-5-hd ou nodaro-video-upscale. |
video_url ou video_asset_id | string | Obrigatório para topaz e nodaro-video-upscale. |
target_resolution | string | Para topaz: o lado menor da saída, 720p, 1080p (padrão) ou 4k. Para nodaro-video-upscale: 1080p (padrão), 2k ou 4k, e 720p roda em 1080p. 2k é recusado em todos os outros modelos. |
target_fps | integer | Para topaz: a taxa de quadros da saída, de 15 a 60. Padrão: a taxa do próprio vídeo de origem. O Topaz interpola os quadros que faltam. |
upscale_factor | string | Legado. Use target_resolution. 1, 2 ou 4, aplicado ao lado menor do vídeo de origem. |
task_id | string | Obrigatório para veo-1080p e veo-4k: o ID da tarefa da geração original do VEO, o providerTaskId da saída dessa geração. Para seedance-2-5-hd, o ID da tarefa do rascunho. |
source_job_id | string | Só seedance-2-5-hd: o ID da tarefa do rascunho do Seedance 2.5 a finalizar, no lugar de task_id. |
O seedance-2-5-hd renderiza de novo um rascunho do Seedance 2.5 como a mesma tomada, em 1080p. O preço vem da duração do rascunho. Veja Upscale de vídeo.
O nodaro-video-upscale (Nodaro Video Upscale) aceita qualquer clipe de até 60 segundos e 50 MB. Ele mantém a taxa de quadros, a duração e o som do clipe, e é cobrado por segundo do clipe. Só é oferecido onde o list_models o lista.
Retorna: um ID de tarefa.
video_depth
Transforma um vídeo em um vídeo de profundidade, em que o que está perto fica claro e o que está longe fica escuro. Funciona como o nó Profundidade de vídeo.
Permissão: workflows:execute. Créditos: pela duração do clipe. Veja Profundidade de vídeo.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo de origem. |
provider | string | video-depth-anything (padrão), consistente de um quadro para o outro, ou depth-anything-frames, que roda em cada quadro, pode tremular e aceita clipes de até 80 segundos. |
model_size | string | small, base ou large. Padrão: large. |
colormap | string | grayscale (padrão), turbo, inferno, magma ou viridis. O depth-anything-frames renderiza só grayscale e inferno. Qualquer outro valor vira grayscale. |
resolution | string | Só video-depth-anything: auto (padrão), 360p, 480p, 720p ou 1080p. |
side_by_side | boolean | Só video-depth-anything: o original e a profundidade lado a lado. |
Uma configuração que o modelo não aceita é descartada. Um clipe com mais de 2.400 quadros ou 300 segundos é recusado antes que qualquer crédito seja reservado.
Retorna: um ID de tarefa.
video_mask
Acompanha ao longo de um vídeo um assunto descrito em texto simples e retorna um vídeo de máscara em preto e branco, branco onde o assunto está. Funciona como o nó Máscara de vídeo.
Permissão: workflows:execute. Créditos: pela duração do clipe, de 55 a 3.108 créditos no SAM 3.1. O SAM 3 custa metade.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url ou video_asset_id | string | O vídeo de origem, de até 5 minutos a 30 fps. Um clipe com mais quadros por segundo conta como proporcionalmente mais longo. |
prompt | string | Obrigatório. O que acompanhar, com 1 a 500 caracteres, como the woman in the red coat. Separe vários assuntos com vírgulas. |
threshold | number | De 0,05 a 0,95. Padrão: 0.5. Um valor menor encontra mais: tente 0.3 quando nada corresponder. |
provider | string | sam-3.1 (padrão) ou sam-3, pela metade do preço. |
hold_last_mask | boolean | Padrão: false. Quando é true, os quadros em que o objeto se perde repetem a máscara não vazia mais recente, por no máximo 1 segundo. |
min_subject_height_pct | number | De 0 a 100. Padrão: 0, desativado. Descarta as regiões mais baixas que essa fração da altura do quadro, antes da retenção. |
max_subject_height_pct | number | De 0 a 100. Padrão: 0, desativado. Descarta as regiões mais altas que essa fração da altura do quadro. Um mínimo acima do máximo é recusado. |
zone | object | Padrão: desativado. left_pct, right_pct, top_pct e bottom_pct, cada um de 0 a 49 % do quadro. Mantém só as regiões cujo centro está dentro dessas margens, por exemplo para descartar os rostos nas bordas da imagem. Uma margem omitida vale 0. Um {} vazio também desativa. |
per_shot | boolean | Padrão: false. Quando é true, os cortes de cena do clipe são encontrados primeiro, e o assunto é detectado de novo em cada tomada. A retenção nunca leva uma máscara através de um corte. Em um clipe sem corte, o resultado é a mesma máscara, ajustada ao número exato de quadros do clipe. O preço não muda. |
redetect_every_sec | number | 0 (padrão, desativado) ou de 1 a 10. Também detecta o assunto de novo a cada esse número de segundos, em cada tomada com per_shot. Isso pega alguém que aparece ou se vira para a câmera no meio da tomada. A execução fica mais lenta, e o preço não muda. |
Um clipe que não pode ser lido ou que é longo demais é recusado antes de qualquer cobrança. Um prompt que não corresponde a nada em nenhum quadro falha, e os créditos são reembolsados. Quando os cortes por tamanho ou a zona não deixam nada em nenhum quadro, o resultado é uma máscara vazia, entregue e cobrada normalmente. A saída da tarefa então tem kept: false. Leia kept, não coverage, para distinguir uma máscara vazia de uma muito pequena. Com per_shot, a saída também informa shots, o número de tomadas encontradas. O chunks da saída conta as requisições enviadas ao modelo, e recipe é a versão do método de mascaramento que fez a máscara. Passe o ID da tarefa para mask_composite como mask_asset_id.
Retorna: um ID de tarefa.
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.
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, infinitalk e omnihuman-2-0. |
video_url ou video_asset_id | string | Um clipe do rosto, para os modelos que reanimam um vídeo existente, como latentsync e heygen-lipsync-precision. |
audio_url ou audio_asset_id | string | A fala ou a música. |
audio_duration_sec | number | Ignorado. A ferramenta ainda o aceita, para que chamadas antigas continuem funcionando. Um modelo cobrado pela duração do áudio é cobrado pela duração que o Nodaro mede no próprio áudio. |
model | string | Padrão: kling-avatar, uma cabeça falante em 720p. Outros incluem kling-avatar-pro, infinitalk, omnihuman-1-5, omnihuman-2-0, latentsync, heygen-lipsync-precision, lipsync-2-pro, sync-lipsync-v3, volcengine-lipsync, a família Seedance 2 (inclusive seedance-2-5-flash) e minimax-h3. Um ID desconhecido é recusado. O Wav2Lip, o VideoReTalking e o SadTalker foram descontinuados: uma chamada que indica wav2lip, video-retalking ou sadtalker é recusada com uma mensagem para escolher outro modelo, e nada é cobrado. |
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. Seedance 2.5 Flash: 480p ou 720p. OmniHuman 1.5: 720p ou 1080p (padrão). O OmniHuman 2.0 é sempre 720p. |
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. |
Nos modelos Seedance e no minimax-h3, a execução faz um clipe de 8 segundos e é cobrada pelo preço de 8 segundos do modelo, seja qual for a duração do áudio. O seedance-2-5-flash aceita de 2 a 30 segundos de áudio. Quando o clipe volta sem som, o Nodaro coloca o seu áudio nele.
O omnihuman-2-0 (OmniHuman 2.0) aceita só uma imagem e de 4 a 300 segundos de áudio. Um áudio mais curto é completado até 4 segundos, e um mais longo é recusado. O prompt tem até 300 caracteres, e ele não aceita resolution, seed nem fast_mode. É cobrado por segundo de áudio.
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 H3 — nível multimodal de alta qualidade: 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 de alta qualidade — 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 de alta qualidade, 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, Vídeo 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 de alta qualidade dirigido por prompt, a partir de uma imagem fixa e um áudio. 720p / 1080p, até 60 s. Pessoas, animais de estimação e anime. |
| OmniHuman 2.0 | Bytedance | Sincronização labial | 39 | Avatar falante a partir de uma imagem fixa + um áudio, conduzido pela voz, com um prompt opcional para a cena, o movimento e a câmera. 720p, de 4 segundos a 5 minutos, cobrado por segundo de áudio. |
| 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 tarefa. 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.
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 tarefa.
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.
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 tarefa.
face_swap
Substitui o rosto num vídeo pelo rosto de um retrato. Funciona como o nó Trocar rosto.
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 tarefa.
video_remake
O Video Remake substitui as pessoas, os pets, os produtos ou o lugar em um vídeo de 4 a 30 segundos pelas imagens de referência do usuário. O vídeo mantém o movimento, o enquadramento, o ritmo e o som: o áudio do clipe é mantido, e o resultado tem a duração do clipe. A ferramenta usa a API do Video Remake. Só no Nodaro Cloud.
Permissão: workflows:execute. Créditos: a cotação que a ferramenta retorna primeiro. Nada é cobrado até que o usuário a aceite.
| Parâmetro | Tipo | Observações |
|---|---|---|
video_url | string | Obrigatório. O clipe de origem, de 4 a 30 segundos. |
roles | array | Obrigatório. Até 6 { kind: "person", name, images?, body?, outfit?, hair? }, 1 { kind: "location", name?, images? }, 3 { kind: "pet", name, images?, body?, coat? } e 3 { kind: "product", name, images?, shape?, finish? }. Cada papel recebe de 0 a 3 imagens de uma só pessoa, pet ou produto, ou de um só lugar, com no máximo 30 imagens no total. Um papel sem imagens fica como no vídeo. Cada traço é "new" (padrão), a partir das imagens, ou "original", a partir do vídeo. Qualquer papel também pode receber preview_name, o nome dele em uma prévia, e in_preview: false, que o deixa fora de uma prévia. Uma execução completa ignora os dois. |
pre_prompt | string | As suas próprias palavras, colocadas antes das instruções dos papéis. Mesmo limite e mesmas menções {role:N} que post_prompt. |
post_prompt | string | As suas próprias palavras, até 4.000 caracteres. Mencione um papel como {role:N}, em que N conta a partir de 1 sobre roles, incluindo os papéis vazios. |
preview | boolean | Renderiza 4 segundos, a partir de preview_start (padrão 0). |
engine | string | nodaro-prism (Nodaro Prism, o padrão) ou nodaro-pulse (Nodaro Pulse). O Nodaro Pulse renderiza em 720p ou 1080p, sem rascunho, e faz uma nova tentativa guiada pelo clipe e pelas imagens. Ele recebe no máximo 10 imagens, e mais que isso é recusado com too_many_images. Ele não tem qualidade total: execute de novo em 1080p. |
style | string | precise (padrão) segue o clipe exatamente. motion segue o movimento do clipe e tira a aparência das imagens, com mais liberdade que precise. O preço dele pode ser diferente, e a cotação o mostra. O Nodaro pode fixar o estilo do motor como Movimento, o que substitui este valor. |
art_style | string | Um estilo artístico no nodaro-prism: um ID do catálogo do seletor Estilo, de get_picker_catalog "style", como pop-art. Ele funciona em uma execução com style: "motion" e em uma execução do Preciso onde o motor aceita um (preciseArtStyle em GET /v1/video-remake/style-choice). O Nodaro pode executar essa chamada do Preciso como Movimento. O prompt recebe o texto de vídeo do estilo. Sem papel com imagens e sem referências (roles pode ser []), uma execução do Movimento reestiliza o clipe inteiro, onde o motor aceita execuções só de estilo (styleOnly). Veja Estilos artísticos. O nodaro-pulse não recebe nenhum e o recusa com art_style_needs_prism. Uma direction sua enviada junto é recusada com use_art_style. |
motion_length | string | Só nodaro-pulse. O Nodaro Pulse renderiza segundos inteiros. cut-end (padrão) corta o clipe em segundos inteiros no fim, e cut-start no início. |
resolution | string | 480p (padrão), 720p ou 1080p. No nodaro-pulse, 720p (o padrão dele) ou 1080p. |
draft | boolean | Padrão: false, então uma execução em 480p é comum. true faz um rascunho em 480p cuja mesma tentativa o full_quality pode finalizar em 1080p. true acima de 480p é recusado, e o nodaro-pulse o recusa com draft_unsupported. |
references | array | Até 5 referências fixas que nenhum papel substitui. Cada uma é { images, line }: de 1 a 3 imagens de uma coisa e uma linha que a nomeia, como "the glass she drinks from". Na linha, {image} representa a primeira imagem dela. As referências são enviadas como estão e nunca são preparadas. As imagens delas contam para o limite de 30. Uma referência sozinha basta para uma execução. Um {role:N} ou um token bruto {image: em uma linha é recusado. |
prepare_references | boolean | Padrão: true. Antes do vídeo, as imagens de cada papel de pessoa, pet e produto viram uma única imagem de referência limpa, feita por um modelo de imagem. Isso custa créditos extras, cobrados mesmo que o vídeo falhe depois, e acrescenta cerca de um minuto. false pula essa etapa. |
quality | string | Obsoleto. draft significa um rascunho em 480p. Use resolution e draft. |
session_id | string | Uma das sessões de geração do usuário, em que o resultado é arquivado. Uma sessão que o usuário não pode usar é recusada com not_found. O mesmo vale para uma sessão de um cliente conectado por OAuth sem assets:write. |
client_request_id | string | Um token de nova tentativa. Reutilize-o quando tentar de novo, para que a execução não seja iniciada nem cobrada duas vezes. |
confirm | boolean | Omita-o para receber só a cotação. Veja A cotação. Defina confirm como true só depois que o usuário aceitar o preço. |
Preparação do clipe
O Nodaro define, para cada motor, como o clipe é preparado para o modelo de vídeo. Por exemplo, ele decide se um clipe que o modelo recusa é tentado de novo. A ferramenta não recebe nenhuma configuração para isso. Uma configuração face_masking que um cliente mais antigo ainda envia é ignorada.
A cotação
Sem confirm, a ferramenta retorna a cotação e não cobra nada:
totalCreditsfica reservado quando a execução começa, eexpectedCreditsé o que a execução deve cobrar.breakdownindica as partes:base,references(a preparação das referências, 0 quando está desativada ou não há nada a preparar),motion(o que o vídeo reserva),motionExpected(o que o vídeo deve cobrar),privacy(a preparação do clipe). A cotação também pode indicarprompt, o prompt que um modelo de linguagem escreve, ereferenceAudio, a preparação do som do clipe. Cada um desses dois só é indicado quando a configuração do motor executa essa etapa. Uma execução só de estilo não tem a parteprivacy. Uma execução comart_styletambém pode indicarstyleRefs.styleRefssão as imagens dos papéis redesenhadas antes no estilo artístico, quando a configuração do Nodaro para o motor faz isso. Ele só é indicado nesse caso e entra nos dois totais.motionemotionExpectedsão alternativas, então leia os totais, nunca a soma.settlesLower: truesignifica que a duração do vídeo fica a cargo do modelo, então a cobrança final deve ser menor. Nonodaro-pulse,expectedCreditsé igual atotalCredits, esettlesLoweréfalse.engineeengineNameindicam o motor cotado.privacyCredits, quando aparece, só é cobrado se o clipe for recusado e a execução for tentada de novo. Ele não entra em nenhum dos totais.
Retorna: sem confirm, a cotação. Com confirm: true, um ID de tarefa. Consulte-o periodicamente com wait_for_job. Cada um destes casos volta como erro da ferramenta:
- Papéis demais de um tipo, ou mais de 30 imagens.
- Um rascunho acima de 480p, ou qualquer rascunho no
nodaro-pulse. - Em uma implantação que ainda não executa o
nodaro-pulse,engine: "nodaro-pulse"é recusado comengine_unavailableantes de qualquer envio. - Em uma implantação cujo motor ainda não recebe um estilo artístico,
art_styleé recusado comart_style_unavailableantes de qualquer envio. - Um
art_styleem uma execução do Preciso cujo motor não aceita estilo nela, ou em uma execução do Movimento cujo prompt a configuração do Nodaro torna Preciso (art_style_needs_flex), fora do catálogo (unknown_art_style) ou um painel de inspiração salvo (art_style_not_supported). - Um clipe fora de 4 a 30 segundos, ou uma prévia que passa do fim do clipe.
- Um
{role:N}além do último papel, ou um token bruto{image:,{video:ou{audio:. - Um prompt que ficaria longo demais.
estimate_full_quality e full_quality
Um rascunho do Video Remake ou de trend pode ser finalizado em qualidade total, em 1080p e com o áudio do clipe, como uma nova tarefa ligada ao rascunho. A mesma tentativa do rascunho é renderizada de novo em 1080p. Um rascunho é uma execução do Nodaro Prism feita em 480p com draft: true. Uma execução comum, incluindo 480p sem draft: true, e toda execução do nodaro-pulse não têm qualidade total. Ela usa a API do Video Remake. Somente no Nodaro Cloud.
Permissão: workflows:execute. Créditos: a cotação que as ferramentas retornam. Nada é cobrado até o usuário aceitá-la.
estimate_full_quality é uma cotação gratuita, e nada é iniciado. Ela recebe job_id: um rascunho concluído (uma tarefa video_remake ou run_trend feita em 480p com draft: true), até 7 dias depois da conclusão. Qualquer outra execução é recusada com not_a_draft. Ela retorna kind, totalCredits, o breakdown dele e availableUntil. kind é "same-take", a própria tentativa do rascunho em 1080p. Um servidor mais antigo omite kind, o que significa o mesmo. totalCredits é breakdown.base, as etapas de finalização, mais breakdown.motionHd, a renderização em 1080p. breakdown.motionHd vale 0 quando uma tentativa anterior deste rascunho que falhou já concluiu essa renderização, que então é reutilizada.
full_quality recebe:
| Parâmetro | Tipo | Observações |
|---|---|---|
job_id | string | Obrigatório. O rascunho concluído, como em estimate_full_quality. |
session_id | string | Uma das sessões de geração do usuário, em que a nova tarefa é arquivada. Uma sessão que o usuário não pode usar é recusada com not_found. |
confirm | boolean | Omita-o para receber só a cotação. Defina-o como true só depois que o usuário aceitar o preço. |
Retorna: sem confirm, a cotação. Com confirm: true, o ID da nova tarefa. Consulte-o periodicamente com wait_for_job. Uma execução tem uma única tarefa em qualidade total. Quando ela já está em andamento ou concluída, a ferramenta a retorna com existing: true e não cobra nada. Uma tarefa que falhou pode ser pedida de novo. Não há client_request_id, porque a tarefa é identificada pelo rascunho.
As recusas voltam como erros da ferramenta: not_found, not_completed, not_a_draft, draft_expired, full_quality_unavailable e, em full_quality, também insufficient_credits ou um limite do espaço de trabalho. full_quality_pending não é definitivo: a renderização em 1080p de uma tentativa anterior está em revisão ou ainda não começou. Tente de novo mais tarde.
Trends
Uma trend é uma receita pronta do Video Remake: um clipe curto com vagas para as pessoas, os pets, os produtos ou o lugar, que o usuário preenche com as próprias imagens. Quatro ferramentas as executam, através da API de Trends. Só no Nodaro Cloud.
| Ferramenta | Permissão | O que faz |
|---|---|---|
list_trends | jobs:read | O catálogo publicado: o slug, o nome, as tags, o que cada cartão precisa por tipo e a duração dele. query, tag, favorites: true e cursor são opcionais. |
get_trend | jobs:read | Uma trend pelo slug: o original dela, o clipe do qual toda execução parte, para mostrar (videoUrl, posterUrl, width, height, durationSec e previewStartSec quando ela tem uma prévia; em uma trend que esconde o clipe original, este é o primeiro exemplo, e examples então começa no segundo), as slots dela (key, label, kind, required, hint, hintImageUrl, uma imagem de quem ou do que a vaga é no original, chips, os chips que o usuário pode definir nessa vaga ou [] para nenhum, e os padrões deles), os examples, que podem estar vazios, previewSec (4, ou null), engine, o motor que toda execução usa (nodaro-prism ou nodaro-pulse), com o seu engineName (“Nodaro Prism” ou “Nodaro Pulse”), e resolutions, as que uma execução pode pedir, com o padrão primeiro. No nodaro-prism, 480p é uma execução comum, a menos que a execução passe draft: true. O nodaro-pulse oferece 720p e 1080p, sem rascunho. Um slug de rascunho, não publicado, arquivado ou desconhecido é um erro not_found. |
estimate_trend | workflows:execute | Uma cotação gratuita: expectedCredits, o valor que deve ser cobrado pela execução, e holdCredits, o valor reservado enquanto ela roda. Em uma trend que tenta de novo um clipe que o modelo de vídeo recusa, ela também retorna privacyCredits. Esse valor só é cobrado se essa repetição rodar. Ele não entra nos dois totais, e a parte dele no breakdown também não. Ele vale 0 em uma trend cujo clipe foi preparado com antecedência. Os mesmos argumentos de run_trend, sem session_id e confirm. |
run_trend | workflows:execute | Faz o vídeo da trend com as imagens do usuário. |
run_trend recebe:
| Parâmetro | Tipo | Observações |
|---|---|---|
slug | string | Obrigatório. A trend. O slug runs é recusado. |
slots | object | Obrigatório. Indexado pelas chaves das vagas da trend: { images?, …chips }, com 1 a 3 URLs de imagem de um só objeto. Toda vaga obrigatória precisa de imagens. Os chips são os que get_trend lista nos chips da vaga, cada um "new" ou "original", entre os do próprio tipo: pessoa body, outfit, hair; pet body, coat; produto shape, finish. Um chip que a vaga não lista é fixado pela trend. |
example | integer | Uma vaga opcional deixada de fora recebe as imagens deste exemplo. A partir de 1, na ordem em que get_trend lista os examples, padrão 1. Quando esse exemplo não tem nenhuma para a vaga, a vaga fica como no original. Omita-o em uma trend sem exemplos: uma vaga opcional deixada de fora fica então como no original. Em uma trend que esconde o original, omiti-lo usa o exemplo mostrado como o original dela. Uma trend de profundidade total nunca usa exemplos: uma vaga opcional deixada de fora recebe a imagem padrão da trend para esse papel, quando há uma definida, ou senão o visual do original. |
details | string | Até 1.000 caracteres. Mencione uma vaga como {slot:<key>}. |
preview | boolean | Uma execução de 4 segundos, quando previewSec é 4. |
resolution | string | Uma das resolutions de get_trend. O padrão é a primeira. Outro valor é recusado com resolution_unsupported. |
draft | boolean | Padrão: false, então uma execução em 480p é comum. true faz um rascunho em 480p cuja mesma tentativa o full_quality pode finalizar em 1080p. Uma trend do nodaro-pulse não tem rascunho, e true é recusado com draft_unsupported. |
preview_job_id | string | Para uma execução completa: o ID da tarefa da prévia concluída do próprio usuário para esta trend. A execução então segue desde o início a repetição dessa prévia. Qualquer outra tarefa é ignorada. |
session_id | string | Aceito, mas ainda não aplicado: as execuções de trends ainda não são arquivadas em sessões. A sessão ainda é verificada: uma sessão que o usuário não pode usar é recusada com not_found. |
client_request_id | string | Um token de nova tentativa. |
confirm | boolean | Omita-o para receber só a cotação. Defina-o como true só depois que o usuário aceitar o preço. |
Retorna: sem confirm, a cotação. Com confirm: true, um ID de tarefa. Consulte-o periodicamente com wait_for_job. Uma recusa, como missing_slot, unknown_slot, invalid_choice ou chip_not_offered, volta como erro da ferramenta. Um erro de vaga indica a chave da vaga. Uma execução de trend feita com draft: true pode ser finalizada em 1080p com full_quality.
stop_video_pro
Para uma tarefa 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 da tarefa. O restante dos créditos reservados é reembolsado. Uma tarefa que ainda não começou é cancelada 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. A tarefa do Gerar vídeo Pro. |
Retorna: uma confirmação. Consulte a tarefa periodicamente com get_job: ela termina com output_data.pro.stopped definido como true e o vídeo parcial como resultado.
continue_video_pro
Continua, como uma nova tarefa, 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. A tarefa 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 da nova tarefa.
Perguntas frequentes
Qual modelo generate_video usa por padrão?
O Seedance 2 Fast, a menos que você tenha salvo um modelo de vídeo padrão na sua conta. 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-5-extend, seedance-2-5-flash-extend, seedance-2-0-extend, kling-4-extend ou pixverse-v6-extend, que estendem qualquer vídeo, por URL ou ID do Nodaro. O gemini-omni-flash-1-2-extend estende qualquer vídeo 16:9 ou 9:16. Os modelos veo-extend e runway-extend só continuam um vídeo que eles mesmos geraram antes.
Páginas relacionadas
Gerar vídeo
Sincronização labial
Edição de vídeo
Imagem
Trends
Ú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.