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

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âmetroTipoObservações
recipestringO nome de uma receita, como video-explainer. Omita-o para listar todas as receitas.
filestringUm 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âmetroTipoObservações
urlstringObrigatório. A página a capturar. O https:// é opcional. Até 2.048 caracteres.
max_stillsintegerO máximo de imagens fixas de seções a retornar, de 3 a 8. Padrão 8.
client_request_idstringUm 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âmetroTipoObservações
sourcestringObrigatório. sampled, character ou photo.
character_idstringPara character: o personagem salvo.
photo_urlstringPara photo: a sua foto.
genderstringwoman ou man.
product_category, overrides, previous, seedDetalhes 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âmetroTipoObservações
planobjectObrigatório. O roteiro.
genderstringObrigatório. woman ou man.
identity_imagesarrayObrigatório. Uma ou duas imagens do criador.
traits, seedOpcionais.
spent_job_idsarrayAs tarefas já executadas para este vídeo, que a cotação lista como gastas. Até 64.
segmentsarrayOs segmentos da saída de ugc_split_speech, quando a resposta à primeira chamada os pediu. Omita-o na primeira chamada. Até 8.
speech_lanestringSomente 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_idstringSomente 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âmetroTipoObservações
planobjectObrigatório. O roteiro.
alignment ou wordsarrayOs tempos das palavras, de forced_alignment ou de transcribe.
video_duration_msnumberA duração do vídeo.
caption_stylestringA 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âmetroTipoObservações
planobjectObrigatório. O roteiro.
audio_url ou audio_asset_idstringA fala, como URL ou como ID de uma tarefa ou de um upload do Nodaro.
alignmentarrayObrigató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âmetroTipoObservações
segmentsarrayObrigatório. Os segmentos de ugc_split_speech, de 1 a 8.
clipsarrayObrigató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.

Última atualização

Nesta página