Pipelines

As ferramentas de pipeline controlam o pipeline História → vídeo (Story to Video) a partir de um assistente de IA. Um único prompt inicia um pipeline que escreve um roteiro, cria o elenco e os lugares, planeja e renderiza as tomadas e junta um filme pronto. O assistente pode acompanhar as etapas, aprová-las, refiná-las num chat e derivar um pipeline concluído a partir de qualquer etapa. A versão desse mesmo mecanismo no canvas é o nó História → vídeo.

As ferramentas de pipeline só existem no Nodaro Cloud. Elas só aparecem se você tiver concedido as permissões pipelines:read, pipelines:execute e pipelines:approve.

As etapas

Um pipeline executa estas etapas em ordem: script, characters, objects, locations, shot_list, scene_images, animate_audio_edit e post_merge. No modo auto, ele executa todas sozinho e só para quando um match cut planejado entre duas tomadas se quebra. A execução então aguarda até que cada quebra seja aceita pela API REST. Nenhuma ferramenta MCP aceita uma quebra. Nos modos manual e guided, ele para em pontos de aprovação, e a etapa aguarda com o status awaiting_approval.

start_pipeline

Inicia um novo pipeline História → vídeo a partir de um prompt de história.

Permissão: pipelines:execute. Créditos: os créditos de cada geração que o pipeline executa. get_pipeline_status mostra os créditos à medida que ele avança.

Retorna: o ID do novo pipeline. Consulte get_pipeline_status periodicamente e, enquanto uma etapa aguarda, pipeline_pending_approvals.

A narração e a sincronização labial vêm desativadas por padrão quando um assistente inicia um pipeline, para que uma execução sem supervisão não gaste créditos com elas, a menos que você as peça.

get_pipeline_status

Retorna o estado de um pipeline: o status (pending, running, awaiting_approval, completed ou failed), a etapa atual, os contadores de créditos, o modo e failure_reason, quando ele falhou.

Permissão: pipelines:read. Créditos: grátis.

pipeline_pending_approvals

Lista as etapas que aguardam aprovação, cada uma com um instantâneo da saída dela. Uma lista vazia significa que nada está aguardando: a execução está no modo auto sem quebra de match cut, ou ainda está gerando.

Permissão: pipelines:read. Créditos: grátis.

chat_pipeline_stage

Envia uma mensagem ao diretor de refinamento sobre uma etapa que aguarda aprovação, por exemplo “deixe o final mais sombrio”. O pipeline precisa estar no modo guided.

Permissão: pipelines:approve.

Retorna: a resposta do diretor e, quando ele propõe uma edição, um proposed_change. Aplique a alteração com apply_chat_proposal.

apply_chat_proposal

Aceita a alteração proposta numa resposta do diretor e aprova a etapa com essa alteração.

Permissão: pipelines:approve. Créditos: grátis.

get_pipeline_stage_chat

Lista as mensagens do chat de uma etapa, das mais antigas para as mais recentes. A lista fica vazia quando ninguém escreveu ainda.

Permissão: pipelines:read. Créditos: grátis.

branch_pipeline

Cria um novo pipeline que executa de novo um pipeline concluído a partir de uma etapa. As etapas anteriores, com os personagens, objetos e locais delas, são copiadas como aprovadas. A etapa escolhida e todas as seguintes são executadas de novo.

Permissão: pipelines:execute. Créditos: os créditos das etapas executadas de novo.

Retorna: o ID do novo pipeline.