NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Referência das ferramentas

Vídeo

Gere vídeo de texto ou imagem, estenda, reestilize, reilumine e faça upscale de clipes e faça rostos falar ou se mover num assistente de IA com o Nodaro.

As ferramentas de vídeo permitem que um assistente crie e transforme vídeos no Nodaro. Com elas, ele gera um clipe a partir de texto ou de uma imagem, estende o clipe ou muda o estilo dele, reilumina o clipe, faz o upscale dele e faz um rosto falar ou copiar um movimento. Cada ferramenta inicia 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.

FerramentaO que faz
generate_videoTexto para vídeo, com referências opcionais
animate_imageImagem para vídeo, com um quadro final opcional
extend_videoContinua um clipe para a frente no tempo
modify_videoMuda o estilo de um clipe ou o edita com um prompt
relight_videoReilumina um clipe, ou troca o fundo dele, a partir dos próprios pixels
video_upscaleFaz o upscale de um clipe, ou finaliza um rascunho do Seedance 2.5 em 1080p
video_depthTransforma um clipe em um vídeo de profundidade
video_maskAcompanha um assunto descrito em texto e retorna um vídeo de máscara
lip_syncFaz um rosto falar ou cantar uma faixa de áudio
speech_to_videoAnima um retrato de acordo com um clipe de fala
motion_transferCopia o movimento de um vídeo para a imagem de um personagem
face_swapSubstitui um rosto num vídeo
video_remakeVideo 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_trendExecuta uma receita pronta do Video Remake com as imagens do usuário
stop_video_pro, continue_video_proPara 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âmetroTipoObservações
promptstringA descrição do vídeo, com até 8.000 caracteres. Obrigatório, a menos que uma predefinição o forneça.
modelstringO ID do modelo. Padrão: seedance-2-fast, 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.
durationnumberSegundos. É usado o valor compatível mais próximo. -1 deixa o Seedance 2 escolher a duração.
aspect_ratiostringPor exemplo 16:9, 9:16 ou 1:1. Padrão: 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.
resolutionstringPor exemplo 480p, 720p, 1080p ou 4k, conforme o modelo. Omita-o para usar a resolução mais baixa do modelo, que é a mais barata.
soundbooleanGera som, nos modelos que conseguem.
negative_promptstringO que evitar, com até 8.000 caracteres.
seedintegerUma seed fixa, nos modelos compatíveis. 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_typestringSó 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.
draftbooleanNo 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_urlsarrayImagens de referência de identidade ou de estilo, como URLs ou IDs do Nodaro. Cada modelo tem o próprio limite, por exemplo 30 no Seedance 2.5, 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_urlsarrayVídeos de referência de estilo ou de movimento, nos modelos que os aceitam.
reference_video_captionsarrayPara que serve cada vídeo de referência, na mesma ordem, com até 500 caracteres cada. Cada descrição vira uma linha como @video_1: … no prompt.
reference_audio_urlsarrayÁudio de referência que conduz o movimento, nos modelos que o aceitam.
presetIdstringUma predefinição de list_node_presets. Os campos que você informa a substituem.
structuredobjectDetalhes estruturados adicionados ao prompt, como em generate_image.
described_referencesarrayAté 10 itens { name, description } para um assunto que você consegue nomear, mas do qual não tem imagem.
connected_references, reference_orderarrayAvançado. Referências rotuladas e ordenadas, no próprio formato do editor, até 14.
character_referencesarraySomente 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_soundbooleanSomente 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_soundtrackbooleanSomente 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_requeststringA ú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_idstring"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

ModeloO que saber
Seedance 2 (seedance-2)Aceita resolution: "4k" e aspect_ratio: "adaptive" ou "21:9".
Seedance 2 Fast e Mini (seedance-2-fast, seedance-2-mini)Somente 480p e 720p.
Seedance 2.5 (seedance-2-5)480p, 720p ou 1080p, e até 30 segundos numa única chamada. Até 30 imagens, 10 vídeos e 10 clipes de áudio de referência.
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 Keyframesduration 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, como kore. 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:9 quando 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_video e um modelo de geração de vídeo em animate_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-i2v num generate_video só com prompt roda como grok, e grok em animate_image roda como grok-i2v. A proporção, o tamanho e a duração são ajustados a esse ID.
  • generate_video com reference_image_urls ou connected_references no grok roda como grok-i2v com as imagens, até 7, porque o grok não aceita nenhuma. O preço é o do grok-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âmetroTipoObservações
image_url ou image_asset_idstringO primeiro quadro.
end_frame_url ou end_frame_asset_idstringO último quadro. Escolha um modelo cujos features em list_models incluam end-frame.
promptstringO que acontece no vídeo, com até 8.000 caracteres.
modelstringPadrão: seedance-2-fast, 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, draftComo em generate_video, com os seus padrões de vídeo salvos.
reference_image_urls, reference_video_urls, reference_audio_urlsarrayReferências dentro dos limites de cada modelo, por exemplo 30 imagens no Seedance 2.5, 9 no Seedance 2 e no MiniMax H3 e 7 no Gemini Omni, no Kling 3 Omni e no Grok.
loop_trimobjectCorta o resultado no ponto de loop mais limpo: enabled, frames_to_test (de 1 a 64) e quality, lossless ou precise. O parâmetro antigo auto_loop_trim ainda funciona e corresponde a este.
described_references, connected_references, reference_orderarrayComo em generate_video.
user_requeststringA ú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_idstring"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.

ModeloDesenvolvedorModosCréditosDetalhes
VEO ExtendGoogleExtensão de vídeoa partir de 209Estende um clipe existente do VEO 3.1 com mais um segmento.
Runway ExtendRunwayExtensão de vídeo352Estende um vídeo do Runway com mais um clipe.
ParâmetroTipoObservações
modelstringObrigatório. seedance-2-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.
promptstringObrigató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_idstringSó 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_idstringSó 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.
durationintegerSegundos 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_audiobooleanSó 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.
resolutionstringSeedance 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_urlsarrayModelos Seedance: até 8 imagens de referência, chamadas de @image_1 a @image_8 no prompt, na ordem da lista.
veo_qualitystringveo-extend: fast ou quality.
runway_resolutionstringrunway-extend: 720p ou 1080p.
seedintegerDe 10.000 a 99.999.

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âmetroTipoObservações
promptstringObrigatório. A alteração, com até 8.000 caracteres.
video_url ou video_asset_idstringObrigatório, um dos dois. O clipe de origem.
modelstringwan (padrão, Wan 2.6, a opção geral), wan-flash, wan-videoedit, luma-modify, runway-aleph, happyhorse-edit, seedance-2-5 ou seedance-2-5-flash. Um ID desconhecido é recusado.
durationstringWan e Wan Flash: 5 ou 10 segundos.
resolutionstringWan e Wan Flash: 720p ou 1080p. Seedance 2.5: de 480p a 1080p. Seedance 2.5 Flash: 480p ou 720p.
aspect_ratiostringSó Runway Aleph: 16:9, 9:16, 4:3, 3:4, 1:1 ou 21:9.
audiobooleanSó Wan Flash: mantém ou gera de novo o áudio.
multi_shotsbooleanSó Wan Flash: permite mudanças de cena dentro do clipe.
reference_image_urlstringSó Runway Aleph: uma imagem de referência de estilo.
reference_image_urlsarraySó Seedance 2.5 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.
seedintegerUma seed fixa. seedance-2-5, seedance-2-5-flash e happyhorse-edit não aceitam seed e a ignoram.
draftbooleanSó 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âmetroTipoObservações
video_url ou video_asset_idstringO clipe de origem: no máximo 240 quadros e 2.770.000 pixels por quadro.
promptstringA nova iluminação ou o novo visual, com até 2.000 caracteres. Passe um prompt, uma imagem de referência ou os dois.
reference_image_urlstringUma imagem de referência para o novo visual. Altamente recomendada.
alpha_modestringauto (padrão) mascara o assunto principal. fill muda o estilo do quadro inteiro. select usa mask_url como uma máscara de quadro-chave. custom usa mask_url como um vídeo de máscara para todos os quadros.
mask_urlstringObrigatório para select e custom.
alpha_keyframe_indexintegerPara select: o quadro, contado a partir de 0, que a máscara descreve.
max_resolutionstring720 ou 1080 (padrão).
seedintegerUma seed fixa.

Retorna: um ID de 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.

ModeloDesenvolvedorModosCréditosDetalhes
Topaz Video UpscaleTopazUpscale de vídeo44Aumento 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 UpscaleGoogleUpscale de vídeo22Aumenta a resolução de um vídeo do VEO para 1080p.
VEO 4K UpscaleGoogleUpscale de vídeo418Aumenta a resolução de um vídeo do VEO para 4K.
ParâmetroTipoObservações
modelstringtopaz (padrão), veo-1080p, veo-4k, seedance-2-5-hd ou nodaro-video-upscale.
video_url ou video_asset_idstringObrigatório para topaz e nodaro-video-upscale.
target_resolutionstringPara 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_fpsintegerPara 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_factorstringLegado. Use target_resolution. 1, 2 ou 4, aplicado ao lado menor do vídeo de origem.
task_idstringObrigató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_idstringSó 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âmetroTipoObservações
video_url ou video_asset_idstringO vídeo de origem.
providerstringvideo-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_sizestringsmall, base ou large. Padrão: large.
colormapstringgrayscale (padrão), turbo, inferno, magma ou viridis. O depth-anything-frames renderiza só grayscale e inferno. Qualquer outro valor vira grayscale.
resolutionstringSó video-depth-anything: auto (padrão), 360p, 480p, 720p ou 1080p.
side_by_sidebooleanSó 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âmetroTipoObservações
video_url ou video_asset_idstringO vídeo de origem, de até 5 minutos a 30 fps. Um clipe com mais quadros por segundo conta como proporcionalmente mais longo.
promptstringObrigatório. O que acompanhar, com 1 a 500 caracteres, como the woman in the red coat. Separe vários assuntos com vírgulas.
thresholdnumberDe 0,05 a 0,95. Padrão: 0.5. Um valor menor encontra mais: tente 0.3 quando nada corresponder.
providerstringsam-3.1 (padrão) ou sam-3, pela metade do preço.
hold_last_maskbooleanPadrã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_pctnumberDe 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_pctnumberDe 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.
zoneobjectPadrã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_shotbooleanPadrã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_secnumber0 (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âmetroTipoObservações
image_url ou image_asset_idstringUm retrato. Use-o para kling-avatar, kling-avatar-pro, infinitalk e omnihuman-2-0.
video_url ou video_asset_idstringUm clipe do rosto, para os modelos que reanimam um vídeo existente, como latentsync e heygen-lipsync-precision.
audio_url ou audio_asset_idstringA fala ou a música.
audio_duration_secnumberIgnorado. 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.
modelstringPadrã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.
promptstringUma dica para a atuação, como a confident TED speaker, com até 500 caracteres. Alguns modelos a usam.
resolutionstringInfiniTalk: 480p ou 720p. Seedance 2 e 2 Fast: 480p, 720p ou 1080p. Seedance 2.5 Flash: 480p ou 720p. OmniHuman 1.5: 720p ou 1080p (padrão). O OmniHuman 2.0 é sempre 720p.
seed, fast_modeSó OmniHuman 1.5: uma seed fixa e um modo mais rápido, com qualidade um pouco menor.
modestringSó Volcengine: lite (padrão, uma pessoa de frente para a câmera) ou basic (cenas complexas).
open_scenedet, separate_vocal, align_audio, align_audio_reverse, templ_start_secondsSó Volcengine: detecção de falantes quando há várias pessoas falando, remoção de ruído do áudio, repetição do vídeo de origem até a duração do áudio e o momento de início na origem.

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.

ModeloDesenvolvedorModosCréditosDetalhes
MiniMax H3MiniMaxImagem para vídeo, Texto para vídeoa partir de 253MiniMax 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 StandardKuaishouSincronização labial308Sincroniza os lábios de um retrato estático com um áudio guia. Qualidade padrão.
Kling Avatar ProKuaishouSincronização labial616Sincronização labial de alta qualidade — formato da boca e tempo mais precisos.
Seedance 2BytedanceImagem para vídeo, Texto para vídeoa partir de 253Seedance 2 — nível de alta qualidade, com áudio nativo. Preço por segundo conforme a resolução.
Seedance 2 FastBytedanceImagem para vídeo, Texto para vídeoa partir de 198Nível mais barato e mais rápido do Seedance 2.
Seedance 2 MiniBytedanceImagem para vídeo, Texto para vídeoa partir de 132Nível econômico do Seedance 2 — só 480p/720p, preço por segundo conforme a resolução.
Seedance 2.5BytedanceImagem para vídeo, Texto para vídeo, Vídeo para vídeoa partir de 374Seedance 2.5 — até 30 s em uma única tomada, áudio nativo e amplas referências multimodais. 480p/720p/1080p.
OmniHuman 1.5BytedanceSincronização labiala partir de 1.122Avatar falante 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.0BytedanceSincronização labial39Avatar 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 v3SyncSincronização labiala partir de 1.100Dubla um vídeo existente — sincroniza de novo os lábios com uma nova faixa de áudio. Entrada de vídeo, cobrança por segundo.
Volcengine Lip SyncVolcengineSincronização labiala partir de 330Dublagem de vídeo para vídeo com IA — sincroniza de novo os lábios com uma nova faixa de voz. Vários falantes (detecção de cenas e identificação de falantes) no modo básico. Entrada de vídeo, cobrança por segundo.

Retorna: um ID de 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âmetroTipoObservações
promptstringObrigatório. O movimento e a cena, com até 2.500 caracteres.
image_url ou image_asset_idstringO retrato.
audio_url ou audio_asset_idstringA fala.
resolutionstring480p (padrão), 580p ou 720p.
negative_promptstringO que evitar, com até 2.500 caracteres.

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

Retorna: um ID de 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âmetroTipoObservações
video_url ou video_asset_idstringO vídeo de origem.
face_image_url ou face_image_asset_idstringO retrato cujo rosto é usado.

Retorna: um ID de 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âmetroTipoObservações
video_urlstringObrigatório. O clipe de origem, de 4 a 30 segundos.
rolesarrayObrigató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_promptstringAs suas próprias palavras, colocadas antes das instruções dos papéis. Mesmo limite e mesmas menções {role:N} que post_prompt.
post_promptstringAs 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.
previewbooleanRenderiza 4 segundos, a partir de preview_start (padrão 0).
enginestringnodaro-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.
stylestringprecise (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_stylestringUm 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_lengthstringSó 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.
resolutionstring480p (padrão), 720p ou 1080p. No nodaro-pulse, 720p (o padrão dele) ou 1080p.
draftbooleanPadrã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.
referencesarrayAté 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_referencesbooleanPadrã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.
qualitystringObsoleto. draft significa um rascunho em 480p. Use resolution e draft.
session_idstringUma 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_idstringUm token de nova tentativa. Reutilize-o quando tentar de novo, para que a execução não seja iniciada nem cobrada duas vezes.
confirmbooleanOmita-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:

  • totalCredits fica reservado quando a execução começa, e expectedCredits é o que a execução deve cobrar.
  • breakdown indica 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 indicar prompt, o prompt que um modelo de linguagem escreve, e referenceAudio, 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 parte privacy. Uma execução com art_style também pode indicar styleRefs. styleRefs sã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. motion e motionExpected são alternativas, então leia os totais, nunca a soma.
  • settlesLower: true significa que a duração do vídeo fica a cargo do modelo, então a cobrança final deve ser menor. No nodaro-pulse, expectedCredits é igual a totalCredits, e settlesLower é false.
  • engine e engineName indicam 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 com engine_unavailable antes de qualquer envio.
  • Em uma implantação cujo motor ainda não recebe um estilo artístico, art_style é recusado com art_style_unavailable antes de qualquer envio.
  • Um art_style em 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âmetroTipoObservações
job_idstringObrigatório. O rascunho concluído, como em estimate_full_quality.
session_idstringUma 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.
confirmbooleanOmita-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.

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.

FerramentaPermissãoO que faz
list_trendsjobs:readO 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_trendjobs:readUma 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_trendworkflows:executeUma 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_trendworkflows:executeFaz o vídeo da trend com as imagens do usuário.

run_trend recebe:

ParâmetroTipoObservações
slugstringObrigatório. A trend. O slug runs é recusado.
slotsobjectObrigató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.
exampleintegerUma 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.
detailsstringAté 1.000 caracteres. Mencione uma vaga como {slot:<key>}.
previewbooleanUma execução de 4 segundos, quando previewSec é 4.
resolutionstringUma das resolutions de get_trend. O padrão é a primeira. Outro valor é recusado com resolution_unsupported.
draftbooleanPadrã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_idstringPara 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_idstringAceito, 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_idstringUm token de nova tentativa.
confirmbooleanOmita-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âmetroTipoObservações
job_idstringObrigató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âmetroTipoObservações
job_idstringObrigatório. A tarefa original do Gerar vídeo Pro.
from_segmentintegerO primeiro segmento a gerar de novo, contado a partir de 1, até 24. Padrão: o primeiro segmento que falta. Passe um anterior para refazer o fim de uma execução concluída.

Retorna: o ID 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.

Última atualização

Nesta página