Utilitários, receitas e skills
Teste a conexão com ping, carregue receitas testadas com get_recipe, inicie a skill Film Director e prepare vídeos UGC sobre sites com os montadores.
As ferramentas de utilitários, receitas e skills ajudam um assistente a começar bem. ping testa a conexão, get_recipe carrega guias testados de várias etapas, start_film_director carrega a skill Film Director e os três montadores de UGC preparam um vídeo de criador de conteúdo sobre um site. Nenhuma delas gera mídia nem gasta créditos. Outras três ferramentas desta página gastam créditos: capture_site captura uma página da web como capturas de tela, e ugc_split_speech e ugc_finish_clips cortam a fala e finalizam os clipes de um vídeo UGC.
Outras ferramentas que retornam instruções estão documentadas com a família delas: start_workflow_editor e get_node_skill, start_video_director, get_studio_production_skill e get_recast_authoring_skill.
ping
Retorna pong, o seu ID de usuário do Nodaro e o nome do cliente que a chamou. Use-a para verificar se o conector funciona.
Permissão: nenhuma, sempre visível. Créditos: grátis.
Esta ferramenta não tem parâmetros.
get_recipe
Lista e carrega receitas de conteúdo: guias testados que conduzem um assistente por um fluxo completo com várias ferramentas, como um vídeo explicativo animado e narrado. A ferramenta só retorna texto. As ações que uma receita pede são feitas com as outras ferramentas, cada uma com a própria permissão e o próprio preço. Veja o catálogo em Receitas de conteúdo.
Permissão: nenhuma, sempre visível. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
recipe | string | O nome de uma receita, como video-explainer. Omita-o para listar todas as receitas. |
file | string | Um arquivo de referência dentro da receita, como references/prompts.md. Exige recipe. |
Retorna: sem argumentos, o nome, a descrição e as frases de ativação de cada receita. Com recipe, as instruções completas da receita. Com file, esse arquivo. Um nome desconhecido retorna um erro com os nomes válidos.
No Nodaro Cloud, a lista também inclui um vídeo UGC sobre um site: um criador de conteúdo falando para a câmera sobre um site, com as capturas de tela dele exibidas como cartões.
start_film_director
Retorna a skill Film Director: as instruções que fazem o assistente dirigir um filme em 10 etapas, do roteiro à montagem final, e montar um workflow editável no seu canvas ao longo do processo. Os assistentes a chamam primeiro para qualquer pedido de vídeo com várias tomadas, como um trailer, um curta-metragem, um videoclipe, um reel ou um anúncio. Veja Film Director.
Permissão: nenhuma, sempre visível. Créditos: grátis. Somente no Nodaro Cloud.
Esta ferramenta não tem parâmetros. Ela não altera nada.
capture_site
Captura uma página da web como capturas de tela reais na largura de um celular: uma imagem da página inteira e até 8 imagens fixas de seções, recortadas no formato de um cartão de celular. Também retorna um mapa das seções da página, com o título, a posição e um texto curto de cada uma, e os números exatos do texto da página. Os pop-ups de consentimento são ocultados, nunca aceitos.
Permissão: workflows:execute. Créditos: um preço fixo por captura. A ferramenta só aparece onde a instalação ativa a captura de páginas e permite importar mídia por links.
| Parâmetro | Tipo | Observações |
|---|---|---|
url | string | Obrigatório. A página a capturar. O https:// é opcional. Até 2.048 caracteres. |
max_stills | integer | O máximo de imagens fixas de seções a retornar, de 3 a 8. Padrão 8. |
client_request_id | string | Um token de nova tentativa: 8 a 128 caracteres entre letras, dígitos e _ - . :. Reutilize-o ao tentar de novo após um tempo esgotado, para que a captura não seja iniciada nem cobrada duas vezes. |
Retorna: o ID de uma tarefa. Leia as imagens fixas em outputData.stills de wait_for_job, cada uma com um assetId e uma url. As imagens fixas ficam salvas na sua mídia, ocultas do seletor até você salvá-las, e contam no seu armazenamento.
Uma página que bloqueia visitantes automatizados, ou que volta vazia, falha e é reembolsada. Uma página cujo robots.txt não permite a captura é recusada antes de qualquer execução.
Os montadores de vídeo UGC
Três auxiliares grátis usados pela receita de vídeo UGC sobre sites. Eles não geram nada: cada um verifica ou prepara a sua parte e retorna os argumentos exatos das próximas chamadas de geração. Duas outras ferramentas, ugc_split_speech e ugc_finish_clips, fazem o trabalho de áudio e vídeo da mesma receita por um preço fixo por chamada. As cinco estão disponíveis somente no Nodaro Cloud e não precisam de permissão, exceto build_ugc_creator com um personagem salvo, que precisa de assets:read.
build_ugc_creator
Prepara o criador de conteúdo que fala para a câmera: uma pessoa nova, gerada por amostragem, um dos seus personagens salvos ou a sua própria foto.
| Parâmetro | Tipo | Observações |
|---|---|---|
source | string | Obrigatório. sampled, character ou photo. |
character_id | string | Para character: o personagem salvo. |
photo_url | string | Para photo: a sua foto. |
gender | string | woman ou man. |
product_category, overrides, previous, seed | Detalhes opcionais para orientar ou repetir o criador gerado por amostragem. |
Retorna: as imagens de identidade do criador, ou os argumentos exatos das gerações de imagem a executar em seguida. Para um criador gerado por amostragem, é uma imagem por candidato, para que o usuário escolha um.
build_ugc_clips
(Somente no Nodaro Cloud) Verifica o roteiro de um vídeo UGC e retorna todos os problemas de uma vez, cada um com a correção. Depois retorna uma chamada generate_video por clipe, a chamada que os junta e uma cotação de créditos para o resto do vídeo. Os roteiros podem ser escritos em inglês ou em hebraico. Um roteiro em hebraico é respondido em duas etapas: a primeira chamada retorna a fala a gravar e como dividi-la, com a cotação; chame de novo com os segments do ugc_split_speech para receber uma chamada generate_video por segmento. Sem permissão, gratuito. Usado pela receita de site UGC (get_recipe).
| Parâmetro | Tipo | Observações |
|---|---|---|
plan | object | Obrigatório. O roteiro. |
gender | string | Obrigatório. woman ou man. |
identity_images | array | Obrigatório. Uma ou duas imagens do criador. |
traits, seed | Opcionais. | |
spent_job_ids | array | As tarefas já executadas para este vídeo, que a cotação lista como gastas. Até 64. |
segments | array | Os segmentos da saída de ugc_split_speech, quando a resposta à primeira chamada os pediu. Omita-o na primeira chamada. Até 8. |
speech_lane | string | Somente em inglês. reference-audio (padrão): uma voz fala o roteiro e o modelo de vídeo o interpreta. prompt-quoted: o modelo de vídeo lê a fala com a própria voz. |
voice_id | string | Somente em inglês. A voz do modo reference-audio, um nome predefinido ou um ID de list_voices, no lugar da voz que o montador escolhe para o criador. |
Retorna: uma chamada de generate_video pronta para executar por clipe, a chamada que junta os clipes e uma cotação em créditos para o resto do vídeo. Uma linha da cotação com estimate: true é a estimativa de uma chamada de LLM medida, a chamada de imagem para texto que lê a captura de tela. Essa chamada é cobrada pelos tokens que realmente usou. A cotação então traz totalIsEstimate: true, então mostre o total como ≈N. Um modelo sem preço é recusado com llm_model_unpriced.
build_ugc_cards
Define o timing dos cartões de captura de tela e das legendas de um vídeo UGC a partir dos tempos das palavras.
| Parâmetro | Tipo | Observações |
|---|---|---|
plan | object | Obrigatório. O roteiro. |
alignment ou words | array | Os tempos das palavras, de forced_alignment ou de transcribe. |
video_duration_ms | number | A duração do vídeo. |
caption_style | string | A aparência das legendas depois da frase de abertura: body-captions (palavra por palavra, o padrão), karaoke, clean-subtitles ou none. A frase de abertura sempre mantém a sua placa. |
Retorna: as camadas para overlay_images e os segmentos de legenda para add_captions.
ugc_split_speech
Corta a fala gravada de um vídeo UGC em segmentos, nas pausas da própria fala. Cada segmento é salvo como um arquivo de áudio, com um breve silêncio de cada lado.
Créditos: um preço fixo por chamada.
| Parâmetro | Tipo | Observações |
|---|---|---|
plan | object | Obrigatório. O roteiro. |
audio_url ou audio_asset_id | string | A fala, como URL ou como ID de uma tarefa ou de um upload do Nodaro. |
alignment | array | Obrigatório. Os tempos das palavras da fala, de 1 a 2.000 itens { word, start, end }. |
Retorna: uma tarefa cuja saída lista os segmentos, para o parâmetro segments de build_ugc_clips.
ugc_finish_clips
Confere cada clipe renderizado com o áudio que ele recebeu, coloca esse áudio original no clipe, corta o tempo morto entre as palavras e retorna os clipes finalizados em ordem. Se um clipe não corresponder ao seu áudio, a ferramenta indica os clipes a renderizar de novo e não altera nada.
Créditos: um preço fixo por chamada.
| Parâmetro | Tipo | Observações |
|---|---|---|
segments | array | Obrigatório. Os segmentos de ugc_split_speech, de 1 a 8. |
clips | array | Obrigatório. De 1 a 8 itens. Cada um tem clip (o número dele, de 1 a 8) e o vídeo renderizado como video_url ou video_asset_id. reroll_video_url ou reroll_video_asset_id é um clipe renderizado de novo. |
Em um vídeo em hebraico, que é feito de segmentos, a ferramenta também dá a cada clipe o som do seu cenário: uma reverberação ajustada ao cenário, um nível de -16 LUFS e ruído de ambiente por baixo. Cenários externos, de carro e de salão recebem a reverberação e o nível, mas não o ruído de ambiente. Se esta etapa falhar, os clipes voltam sem ela, com um aviso.
Retorna: uma tarefa cuja saída lista os clipes finalizados em ordem.
Perguntas frequentes
Como verifico se o meu assistente está conectado ao Nodaro?
Peça para ele chamar ping. A ferramenta responde com pong, o seu ID de usuário do Nodaro e o nome do seu cliente, e não precisa de permissão.
O que get_recipe retorna?
Instruções, não mídia. Sem argumento, lista as receitas com as descrições e as frases de ativação; com o nome de uma receita, retorna o guia completo dela, que o assistente então segue com as outras ferramentas.
Os montadores de UGC geram o vídeo?
Não. Os três montadores são auxiliares grátis da receita de vídeo UGC sobre sites. Preparam o criador, verificam o roteiro e definem o timing dos cartões e das legendas, e retornam as chamadas exatas a fazer em seguida, com uma cotação em créditos. Duas outras ferramentas, ugc_split_speech e ugc_finish_clips, cortam a fala e finalizam os clipes por um preço fixo por chamada.
Páginas relacionadas
Receitas de conteúdo
Film Director
Referência das ferramentas MCP
Solução de problemas
Última atualização
Cenas 3D
Parâmetros das quatro ferramentas de cena 3D, que criam e revisam uma cena de massinha editável, a renderizam em MP4 ou entregam uma tomada pronta numa tarefa.
Conversas MCP
Cada conversa de um assistente de IA com o Nodaro pelo MCP vira um workflow de nós conectados, que você abre no editor, altera e executa de novo.