Comandos

Os comandos principais da CLI do Nodaro gerenciam projetos e workflows, executam apps publicados e nós avulsos, e inspecionam execuções e jobs. Esta página lista cada um deles com as opções. Os comandos de entidades, de mídia e de espaços de trabalho têm páginas próprias, listadas na primeira tabela.

Todos os exemplos pressupõem que você já instalou a CLI e fez login.

Grupos de comandos

Opções aceitas por todos os comandos

• --profile <name> executa o comando com um perfil salvo em vez do perfil padrão.
• --json imprime uma saída legível por máquina em todos os comandos que leem dados. Veja Saída e códigos de saída.
• --workspace <id> é uma opção global. Ela define o espaço de trabalho só para este comando. Veja Espaços de trabalho e organizações.
• -v ou --version imprime a versão da CLI.

Nas sinopses abaixo, <value> é um valor que você informa, [...] é opcional e a|b significa um dos valores listados.

Projetos

nodaro projects list [--json]
nodaro projects get <id> [--json]
nodaro projects create --name <name> [--description <desc>] [--json]
nodaro projects update <id> [--name <name>] [--description <desc>] [--json]
nodaro projects delete <id> [--json]

Workflows

nodaro workflows list --project <projectId> [--json]
nodaro workflows get <id> [--json]
nodaro workflows create --project <projectId> --name <name> [--file bundle.json] [--json]
nodaro workflows update <id> [--name <name>] [--file nodes-edges.json] [--json]
nodaro workflows delete <id> [--json]
nodaro workflows export <id> [--with-assets] [--output bundle.json]
nodaro workflows import <file> --project <projectId> [--json]
nodaro workflows run <id> [--watch] [--node n1 n2 ...] [--json]

O formato do pacote é o mesmo que o editor exporta. Veja Importação e exportação de workflows.

Compartilhar e mover workflows

Estes comandos funcionam em instâncias com organizações e espaços de trabalho.

nodaro workflows share <id> [--visibility workspace|private] [--json]
nodaro workflows move <id> --project <projectId> [--json]
nodaro workflows shared-with-me [--json]
nodaro workflows collaborators list <id> [--json]
nodaro workflows collaborators add <id> (--user <userId> | --email <email>) --role viewer|editor [--json]
nodaro workflows collaborators update <id> <userId> --role viewer|editor [--json]
nodaro workflows collaborators remove <id> <userId> [--json]

• share define quem no espaço de trabalho pode ver o workflow. A visibilidade padrão é workspace.
• collaborators add --email encontra o endereço de qualquer conta do Nodaro, seja qual for a organização dela. Um endereço sem conta retorna 404.
• move coloca o workflow em outro projeto. Mover para outro espaço de trabalho remove os colaboradores do workflow, e o resultado informa quem perdeu o acesso.

Apps

Um app é um workflow envolto em um formulário de entradas e saídas com curadoria. Veja Apps.

nodaro apps list [--search <query>] [--limit <n>] [--cursor <token>] [--category <slug>]
nodaro apps get <slug>                                   # input schema and outputs
nodaro apps run <slug> --input prompt="..." [--watch]
nodaro apps run <slug> --params-file inputs.json [--watch]
nodaro apps run <slug> --input prompt="..." --override <nodeId>.<field>=<value>
nodaro apps runs <slug> [--limit <n>] [--cursor <token>] [--json]   # your past runs
nodaro apps run-get <slug> <runId>

• apps list retorna até 50 apps por página. Passe o --cursor de uma página para obter a próxima.
• apps get mostra os nomes das entradas do app. Use esses nomes como chaves de --input.
• --input define uma entrada do app. Repita a opção para cada entrada, ou coloque todas em um arquivo JSON com --params-file.
• --override define diretamente um campo de nó, só nesta execução, no formato <nodeId>.<field>=<value>. A opção alcança campos que o app não expõe, como promptPrefix. Veja Texto antes e depois do prompt.

Uma substituição nunca pode mudar para onde um nó externo envia dados ou de onde ele os busca, como o endereço de um nó Saída de webhook (Webhook Output). Nesse caso, a execução é recusada com locked_field.

Nós

nodaro nodes list [--category <category>] [--json]
nodaro nodes get <type>                                  # full input schema
nodaro nodes run <type> --param prompt="..." --param provider=flux [--watch]
nodaro nodes run <type> --params-file body.json [--watch] [--poll-interval 1000]

• --category é um destes valores: input, parameter, ai-image, ai-video, ai-audio, ai-text, processing, composition, output, control, entity, trigger ou utility.
• nodes get imprime o schema de entrada de um tipo de nó: os campos que --param aceita.
• --watch consulta o job periodicamente até ele terminar, quando a resposta tem um id de job. --poll-interval define o intervalo da consulta periódica, em milissegundos. O padrão é 2000.

A sintaxe de --param e de --params-file está em Parâmetros e arquivos de entrada.

Modelos

nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]

• --mode filtra por operação, como t2i, i2v, t2v ou tts.
• --family filtra pelo fabricante do modelo, como Google ou Bytedance.
• --featured mostra só os modelos em destaque.

A tabela mostra o id, o tipo, a família, os modos e os níveis de crédito de cada modelo. Ela também marca os modelos em destaque e as famílias de modelos para as quais o Nodaro reuniu orientações de prompt. --json retorna as fichas completas de recursos, os preços em créditos e as dicas de prompt. Navegue pelo mesmo catálogo em Modelos.

Seletores

Os seletores são os nós de Controles criativos, como Clima (Mood) e Enquadramento (Framing). Estes comandos leem os catálogos de valores válidos deles. Veja Catálogos de seletores.

nodaro pickers list [--json]
nodaro pickers get <nodeType> [--full] [--category <c>] [--field <f>] [--json]
nodaro pickers analyze "<text>" [--target <types>] [--instructions <text>] [--model <id>] [--effort <level>] [--json]

term é a expressão profissional curta que o modo Compacto do Trecho do prompt adiciona a um prompt. Ele fica vazio em uma opção sem efeito, como auto ou none. Pessoa (Person) e Figurino e beleza (Styling) também retornam sections: os tópicos deles, cada um com uma imagem redonda.

Pacotes de catálogo

Uma implantação pode fazer a curadoria dos catálogos de seletores com pacotes de catálogo próprios (vendored). Estes comandos mantêm esses pacotes. Eles funcionam offline, sobre arquivos, e não exigem login.

nodaro catalog snapshot --in <file>
nodaro catalog diff-upstream --baseline <f> --upstream <f> --pack <f> [--write <f>]
nodaro catalog validate --pack <file> [--exempt es,fr,...]

• snapshot imprime em JSON uma projeção /v1/catalogs completa de um arquivo, com os arquivos de tradução dele.
• diff-upstream é uma mesclagem de três vias (three-way merge). Ele leva as edições do upstream para as entradas que você não alterou, com os textos delas nas 11 localidades traduzidas. Ele informa os conflitos, em que você e o upstream alteraram a mesma entrada, e mantém a sua versão. Ele lista as novas entradas e as remoções do upstream, e nunca adiciona nada por conta própria. Ele sai com o código 2 quando há conflitos.
• validate verifica se o snapshot de um pacote tem traduções nas 11 localidades traduzidas; com --exempt, você declara exceções. Ele sai com o código 1 quando falta uma tradução em uma localidade que não é exceção.

Execuções e jobs

Uma execução é cada vez que um workflow ou um app é executado. Um job é o trabalho de um único nó, como a geração de uma imagem. nodaro nodes run retorna um job.

nodaro executions get <id> [--watch] [--json]
nodaro executions cancel <id> [--mode cancelled|stopping]
nodaro jobs get <id> [--json]
nodaro jobs cancel <id> [--json]

• executions get --watch consulta periodicamente até a execução ser concluída, falhar ou ser cancelada.
• executions cancel --mode cancelled, o padrão, para a execução na hora. --mode stopping deixa o nível atual de nós terminar primeiro.

Controle de execuções do Gerar vídeo Pro

O Gerar vídeo Pro cria um vídeo longo um segmento de cada vez, então você pode parar uma execução e retomá-la depois. Ele roda no Nodaro Cloud; uma instalação self-hosted o executa pela conexão com o Nodaro Cloud.

nodaro video-pro stop <jobId> [--json]
nodaro video-pro continue <jobId> [--from-segment N] [--watch] [--poll-interval <ms>] [--json]

• stop encerra a execução de forma ordenada. Os segmentos concluídos são mantidos e entregues, e o restante da reserva é reembolsado. O segmento em andamento ainda é cobrado.
• continue inicia um novo job que gera de novo a partir do segmento N. O padrão é o primeiro segmento que não foi entregue. Você paga só pelos segmentos gerados de novo, mais a taxa fixa do Pro.

Assistente de prompt

O assistente de prompt transforma uma ideia vaga em um prompt otimizado para um tipo de nó, como generate-image.

nodaro prompt wizard [--node-type <type>] [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>]
nodaro prompt analyze --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt generate --node-type <type> --selection category=value [--selection ...] [--original-prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]
nodaro prompt enhance --node-type <type> [--prompt "..."] [--provider <name>] [--style <name>] [--aspect-ratio <ratio>] [--duration <seconds>] [--llm-model <id>] [--reasoning-effort <level>] [--advanced] [--temperature <n>] [--max-tokens <n>] [--json]

• --reasoning-effort é none, low, medium, high, xhigh ou max. O suporte depende do modelo; um valor não aceito ou omitido usa o padrão do modelo. xhigh e max cobram um nível acima, com teto no nível premium.
• --advanced funciona só com modelos Gemini. Ele ativa --temperature, --max-tokens e a faixa completa de raciocínio, e cobra um nível acima, com teto no nível premium.

Tomadas

Uma tomada (shot) é um estado salvo do construtor: seleções de seletores, prompts, modelos escolhidos e referências a entidades. As tomadas alimentam os links de compartilhamento e o remix com um clique.

nodaro shots get <id> [--json]
nodaro shots create [--file shot.json] [--visibility private|public] [--json]
nodaro shots update <id> [--file fields.json] [--visibility private|public] [--json]
nodaro shots delete <id>

Uma tomada nova é privada, a menos que você defina --visibility public. Qualquer pessoa que tenha o id de uma tomada pública pode lê-la.

Recast

O Recast gera de novo um vídeo analisado com o seu próprio elenco. Você também pode importar um script que escreveu e renderizá-lo como um recast. Os comandos recast só funcionam no Nodaro Cloud.

nodaro recast skill
nodaro recast validate --file script.json [--json]
nodaro recast import --file script.json --rights-attested [--json]
nodaro recast estimate --analysis-job <id> [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast create --workflow <id> --analysis-job <id> [--rights-attested] [--fidelity faithful] [--resolution <r>] [--segment-sec <n>] [--json]
nodaro recast start <recastId> [--segment-sec <n>] [--json]
nodaro recast status <recastId> [--json]

O --segment-sec na CLI 1.24.0. As rotas do Recast recebem o nome de um pacote na configuração de segmentos: scenes-max (o menor número de emendas), scenes (partes mais curtas) ou max (as partes mais longas que o modelo permite). A CLI 1.24.0 envia --segment-sec como número, então ela não consegue enviar o nome de um pacote, e um número como 10 é recusado com 400 validation_error. Deixe a opção de fora, e o servidor usa o padrão dele, scenes-max. Para escolher outro pacote, chame a API do Recast.

Veja Recast para entender como um recast funciona, e a API do Recast para os endpoints por trás destes comandos.