Docs do NodaroUtilitá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 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.
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. 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 um prompt de imagem com os argumentos exatos da geração de imagem a executar em seguida.
build_ugc_clips
Verifica o roteiro de um vídeo UGC e o transforma em pedidos de clipe. Um roteiro inválido retorna todos os problemas de uma vez, cada um com a correção.
| 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 | Os jobs já executados para este vídeo, que a cotação lista como gastos. |
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.
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. |
Retorna: as camadas para overlay_images e os segmentos de legenda para add_captions.
Perguntas frequentes
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 num job.
Receitas de conteúdo
Receitas de conteúdo são guias testados, carregados com get_recipe, que levam um assistente de IA por todo um fluxo do Nodaro, como um explicativo animado.