Comandos
Comandos da CLI do Nodaro, com opções: projetos, workflows, apps, nós, modelos, predefinições, paletas, tarefas, galeria, webhooks, cobrança e Recast.
Os comandos principais da CLI do Nodaro gerenciam projetos e workflows, executam apps publicados e nós avulsos, e inspecionam execuções e tarefas. 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
| Grupo | O que faz | Onde está documentado |
|---|---|---|
auth | Faz login, mostra e remove perfis | CLI |
projects | Cria, lê, atualiza e exclui projetos | Esta página |
sessions | Sessões de geração dentro de projetos | Esta página |
workflows | Gerencia, exporta, importa, executa e compartilha workflows | Esta página |
apps | Navega pelos apps publicados e os executa | Esta página |
nodes | Lista os tipos de nó e executa um único nó | Esta página |
models | Navega pelo catálogo de modelos e calcula o preço de identificadores | Esta página |
billing | Planos e preços, a sua assinatura, o seu uso e o seu histórico de créditos | Esta página |
pickers | Lê os catálogos de seletores e preenche seletores a partir de uma descrição | Esta página |
presets | As suas predefinições de nó, favoritos e pastas, e o catálogo integrado | Esta página |
palettes, moodboards | As suas paletas de cores e painéis de inspiração para o Gerar imagem | Esta página |
catalog | Mantém os pacotes de catálogo de uma implantação, offline | Esta página |
executions, jobs | Inspeciona, filtra, avalia e cancela execuções | Esta página |
gallery | A galeria pública e os seus favoritos | Esta página |
webhooks | Endpoints que o Nodaro chama quando uma tarefa termina | Esta página |
video-pro | Para e retoma execuções do Gerar vídeo Pro | Esta página |
prompt | Transforma uma ideia vaga em um prompt otimizado | Esta página |
shots | Cria e lê registros de compartilhamento de tomadas | Esta página |
recast | Planeja e renderiza uma execução de Recast, ou importa um script | Esta página |
trends | Executa uma receita pronta do Video Remake com as suas próprias imagens | Esta página |
video-remake | Finaliza um rascunho do Nodaro Prism em qualidade total | Esta página |
characters, locations, objects | Gerencia entidades e gera as imagens e os movimentos delas | Comandos de entidades |
voice, media, audio, edit | Troca vozes, legenda, compõe e edita mídias | Comandos de mídia e voz |
org, workspace | Organizações, convites, espaços de trabalho e relatórios de uso | Espaços de trabalho e organizações |
Opções aceitas por todos os comandos
--profile <name>executa o comando com um perfil salvo em vez do perfil padrão.--jsonimprime 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.-vou--versionimprime 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]Sessões
Uma sessão de geração agrupa gerações avulsas dentro de um projeto. Os itens dela são links para as suas tarefas, não cópias. Veja client.sessions.
nodaro sessions list [--project <id>] [--tool <tool>] [--archived] [--limit <n>] [--cursor <c>] [--json]
nodaro sessions get <id> [--json]
nodaro sessions items <id> [--limit <n>] [--cursor <c>] [--json]
nodaro sessions create --tool <tool> [--project <id>] [--title <title>] [--json]
nodaro sessions update <id> [--title <title> | --untitled] [--archive | --unarchive] [--cover <jobId> | --auto-cover] [--json]
nodaro sessions import <id> --jobs <id,id,...> [--json]
nodaro sessions remove <id> <jobId> [--json]
nodaro sessions delete <id> [--json]importvincula tarefas à sessão. É tudo ou nada: uma tarefa que não é sua faz a chamada inteira falhar.removeremove só o vínculo. A tarefa continua existindo, assim como as outras sessões que a contêm.deleteexclui a sessão. As tarefas dela são mantidas.update --coverescolhe um dos itens da sessão para abrir as prévias dela.--auto-covervolta aos itens mais recentes.
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]
nodaro workflows run <id> --continue-from <executionId> --from-failed [--node n1 n2 ...] [--idempotency-key <key>] [--watch]
nodaro workflows run <id> --continue-from <executionId> --node n1 n2 ... [--override n1.quality=final ...] [--watch]
nodaro workflows run <id> --next <json|file|-> [--idempotency-key <key>] [--watch]
nodaro workflows render-final <id> --from <executionId> [--render <nodeId>] [--estimate] [--watch] [--json]| Opção | O que faz |
|---|---|
create --file | Cria o workflow a partir de um pacote de workflow exportado. |
update --file | Grava no workflow os nós, as conexões e as configurações de um arquivo JSON. |
export --with-assets | Adiciona ao pacote os dados de personagens, objetos e locais que o workflow usa. |
export --output | Grava o pacote em um arquivo em vez de imprimi-lo. |
run --node | Executa só os ids de nós listados, separados por espaços. |
run --watch | Acompanha a execução até ela terminar. |
run --continue-from --from-failed | Continua uma execução que falhou de onde ela parou. Sem --node, considera os nós em que a primeira execução foi iniciada, mais cada nó que ficou com falha. Com --node, todo nó indicado conta: um nó que nenhuma execução da cadeia executou é executado e cobrado. Uma fonte, um gatilho ou um nó pulado nunca é executado. Veja Continuar uma execução que falhou. |
run --continue-from --node | Executa só os nós indicados, continuando uma execução concluída. Cada um dos outros nós repassa os resultados dessa execução. |
run --override | Uma configuração por nó somente nesta execução, escrita nodeId.field=value. Repita para mais configurações. |
run --idempotency-key | Enviado como o cabeçalho Idempotency-Key (8 caracteres ou mais). A mesma chave duas vezes inicia uma só execução. |
run --next | Envia o next de uma resposta continuation_preview_pending exatamente como veio. Um --from-failed recusado imprime o comando que conclui a execução retida. |
render-final | Renderiza em Final uma execução que parou em uma prévia e depois executa todos os nós após ela, continuando essa execução. --render usa por padrão a única renderização do workflow. --estimate cota os nós e os créditos e não executa nada. |
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 mcp-conversations [--month YYYY-MM] [--source claude,claude-code,chatgpt] [--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]sharedefine quem no espaço de trabalho pode ver o workflow. A visibilidade padrão éworkspace.collaborators add --emailencontra o endereço de qualquer conta do Nodaro, seja qual for a organização dela. Um endereço sem conta retorna404.mcp-conversationslista as suas conversas MCP de um mês, cada uma um workflow que um assistente montou. O mês padrão é o mês mais recente que tem alguma.--sourcemantém só alguns assistentes. Veja As conversas MCP viram workflows.movecoloca 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>
nodaro apps run-retry <slug> <runId> [--dry-run] [--app-version <n>] [--watch] [--json]apps listretorna até 50 apps por página. Passe o--cursorde uma página para obter a próxima.apps getmostra os nomes das entradas do app. Use esses nomes como chaves de--input.--inputdefine uma entrada do app. Repita a opção para cada entrada, ou coloque todas em um arquivo JSON com--params-file.apps run-retrytenta de novo uma execução que falhou, a partir de onde ela parou. Só as etapas que ela não concluiu são executadas, e só essas são cobradas. Cada etapa que ela concluiu repassa o resultado. O comando executa a versão que a execução executou, com as entradas que a execução aplicou, e não aceita entradas próprias. Veja Tentar novamente uma execução que falhou.--dry-runlista as etapas que o Tentar novamente executaria e o que ele cobraria, sem iniciar nada.--app-versioné a versão do app que você espera que o Tentar novamente execute. O padrão é a versão mais recente do app. Quando o app mudou desde a execução, o Tentar novamente é recusado comapp_run_version_changed. A CLI então mostra os dois caminhos: começar de novo comnodaro apps run, ou continuar na versão da própria execução com--app-version <that version>. Uma execução que foi parada, em vez de falhar, começa de novo.--overridedefine 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, comopromptPrefix. 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. 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]
nodaro nodes run generate-image --param prompt="..." [--count 1-4] [--models <id,id,...>] [--watch]
nodaro nodes run generate-video|text-to-video ... [--reference-task-type auto|reference|edit|extend]--categoryé um destes valores:input,parameter,ai-image,ai-video,ai-audio,ai-text,processing,composition,output,control,entity,triggerouutility.nodes getimprime o schema de entrada de um tipo de nó: os campos que--paramaceita.nodes runenvia para a rota própria do nó,POST /v1/<type>para a maioria dos tipos de nó. Alguns tipos de nó, comollm-chate os nós do Suno, têm uma rota própria, e a CLI a usa por você. Um tipo de nó que não pode ser executado sozinho, comomodify-imageoupaint-mask, falha antes de a API ser chamada, e a mensagem diz o que executar no lugar. Veja Executar nós.--watchconsulta a tarefa periodicamente até ela terminar, quando a resposta tem um id de tarefa.--poll-intervaldefine 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.
Por exemplo, o nó Profundidade de vídeo transforma um clipe em um vídeo de profundidade, o que está perto claro e o que está longe escuro:
nodaro nodes run video-depth --param videoUrl=https://cdn.example.com/clip.mp4 --param colormap=turbo --watchVárias imagens em uma chamada
Só no generate-image, --count <n> cria de 1 a 4 imagens, cada uma em sua própria tarefa. --models a,b executa a mesma requisição em 2 a 4 modelos de imagem, no lugar de provider. Com as duas opções, --count vale por modelo, até 8 imagens. O lote é conferido com o seu saldo e cobrado inteiro ou não é cobrado.
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --count 4 --watch
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --models gpt-image-2,flux-2-max --count 2 --watchA CLI imprime o id de cada tarefa, agrupado por modelo, e o id do lote. --watch acompanha cada tarefa até todas terminarem. Ela sai com 0 quando todas foram concluídas, 2 quando alguma falhou ou foi cancelada, e 3 quando as demais foram concluídas e algumas aguardam revisão. --json --watch imprime todos os status finais. As opções prevalecem sobre count e models em --param ou --params-file.
Para que serve a mídia de referência de um vídeo
No generate-video e no text-to-video, --reference-task-type <auto|reference|edit|extend> define referenceTaskType no corpo. A CLI confere o valor com esses quatro antes de chamar a API. A plataforma decide se o modelo e a requisição o usam, e um modelo que não o aceita o ignora. Veja Tipo de tarefa de referência do Seedance 2.5. A opção prevalece sobre referenceTaskType em --param ou --params-file, e --param referenceTaskType=edit continua funcionando. Qualquer outro tipo de nó recusa a opção, inclusive o video-to-video, porque ali uma edição sempre é executada como edição.
nodaro nodes run generate-video --params-file body.json --reference-task-type extend --watchModelos
nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]
nodaro models cost <id…> [--json]--modefiltra por operação, comot2i,i2v,t2voutts.--familyfiltra pelo fabricante do modelo, comoGoogleouBytedance.--featuredmostra só os modelos em destaque.
A tabela mostra o id, o tipo, a família, o fabricante, os modos e os níveis de crédito de cada modelo. O fabricante é a empresa que criou o modelo, ou - para um modelo que a instância oferece com a própria marca. A tabela 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. Também retorna o maker de cada modelo como { id, name }, ausente em um modelo de marca própria, e o logoUrl do fabricante, que é null quando a instância não publica nenhuma marca. Navegue pelo mesmo catálogo em Modelos.
models cost mostra quanto cada identificador cobra, a partir de POST /v1/credits/model-costs. Um identificador é um ID de modelo, um ID de crédito ou uma chave de preço de LLM medida, <feature>:<model>[:direct | :effort-<level>]. Uma chamada de LLM medida é cobrada pelos tokens que usa, então o valor dela é uma estimativa e aparece como ≈N. Um identificador sem preço mostra - e o motivo. Veja Chamadas de LLM.
Cobrança
Estes comandos leem os planos e os preços, a sua assinatura, e o seu uso e o seu histórico de créditos. Comprar e trocar de plano continuam sendo feitos no app do Nodaro.
nodaro billing plans [--base-url <url>] [--json]
nodaro billing subscription [--json]
nodaro billing account [--json]
nodaro billing surface [--base-url <url>] [--json]
nodaro billing summary [--since <when>] [--until <when>] [--bucket day|week|month] [--json]
nodaro billing history [--kind <k>] [--model <id>] [--since <iso>] [--until <iso>] [--search <words>] [--limit <n>] [--cursor <c>] [--csv] [--json]| Comando | O que mostra |
|---|---|
billing plans | Os planos e os pacotes de créditos à venda, com os preços. Só no Nodaro Cloud. Não é preciso fazer login. |
billing subscription | A sua assinatura e o nível que os direitos da sua conta seguem. Só no Nodaro Cloud. |
billing account | O seu plano e o seu saldo, como o provedor de cobrança da implantação os informa, na unidade dele. |
billing surface | Como a implantação cobra: se mede o uso e em que unidade os custos são mostrados. Não é preciso fazer login. |
billing summary | O seu uso de créditos em um período, por padrão os últimos 30 dias: totais, por modelo, por categoria, ao longo do tempo, por sessão e por workflow. Só no Nodaro Cloud. |
billing history | Cada movimento do seu saldo, do mais recente para o mais antigo, com o saldo depois de cada um. --csv imprime todo o histórico filtrado em CSV. Só no Nodaro Cloud. |
plans e surface não enviam credencial. Eles consultam a instância em --base-url, senão a instância do perfil, senão https://app.nodaro.ai. plans e subscription respondem 404 em uma instância auto-hospedada, que não tem cobrança. Veja client.billing para os campos, e Resumo de uso e Cada movimento do seu saldo para o que summary e history leem.
Seletores
Os seletores são os nós de Controles criativos, como Clima e Enquadramento. 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]| Comando ou opção | O que faz |
|---|---|
pickers list | Lista todos os tipos de nó de seletor, o número de opções de cada um e quantas opções têm imagem. |
pickers get | Retorna um catálogo. Cada opção traz id, label, category, term, icon e, quando tem imagem, imageUrl. |
--full | Inclui a descrição de cada opção e o trecho de prompt que ela adiciona. |
--category | Filtra um seletor de uma única dimensão por uma categoria. |
--field | Retorna uma dimensão de um seletor de várias dimensões, como shotSize do Enquadramento. |
pickers analyze | AI Fill: escolhe valores de seletores a partir de uma descrição em texto livre. É uma chamada a um LLM, cobrada em créditos. |
--target | Uma lista, separada por vírgulas, dos tipos de nó de seletor a preencher. O padrão é todo seletor que pode ser analisado. |
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 e Figurino e beleza também retornam sections: os tópicos deles, cada um com uma imagem redonda.
Predefinições
Uma predefinição é um conjunto de configurações salvas de um nó. Estes comandos gerenciam as suas predefinições, os seus favoritos e as suas pastas, e leem o catálogo integrado. Veja Predefinições.
nodaro presets list [--node-type <type>] [--factory [--base-url <url>]] [--json]
nodaro presets create --node-type <type> --name <name> (--data <json> | --data-file <path|->) [--description <text>] [--group <id>] [--tag <t>]... [--preview-url <url>] [--json]
nodaro presets update <id> [--name <name>] [--description <text>] [--data <json> | --data-file <path|->] [--group <id> | --no-group] [--tag <t>]... [--preview-url <url> | --no-preview-url] [--expected-updated-at <iso>] [--json]
nodaro presets delete <id> [--expected-updated-at <iso>] [--json]
nodaro presets export [--node-type <type>] [--output <file>]
nodaro presets import <file|-> [--json]
nodaro presets favorites --node-type <type> [--json]
nodaro presets favorite <presetId> --node-type <type> [--json]
nodaro presets unfavorite <presetId> --node-type <type> [--json]
nodaro presets groups list [--node-type <type>] [--json]
nodaro presets groups create --node-type <type> --name <name> [--kind folder|section] [--sort-order <n>] [--json]
nodaro presets groups update <id> [--name <name>] [--sort-order <n>] [--json]
nodaro presets groups delete <id> [--json]| Comando ou opção | O que faz |
|---|---|
list --factory | Lista o catálogo integrado de --node-type. Não é preciso fazer login. --base-url consulta outra instância. A coluna photos é quantas fotos de referência uma predefinição usa, e preview diz se ela tem uma imagem de exemplo. |
list | Sem --factory, lista as suas próprias predefinições. Precisa de um perfil. |
create --preview-url | Uma imagem já armazenada nesta plataforma: um upload ou um resultado pronto. |
update --expected-updated-at, delete --expected-updated-at | Recusam a alteração quando a predefinição mudou depois desse horário. |
export | Grava as suas predefinições em um arquivo JSON que import aceita. |
import | Lê esse arquivo, ou uma lista JSON de predefinições, de um caminho ou da entrada padrão. |
favorite, unfavorite | Adicionam ou removem um favorito: um id integrado ou um dos ids das suas predefinições. |
groups | Lista, cria, renomeia e exclui as suas pastas e seções. Um groups sozinho também as lista. Excluir uma pasta tira as predefinições dela. |
Reordenar é arrastar no editor. Scripts usam o presets.reorder() do SDK.
Paletas e painéis de inspiração
Salve as suas próprias cores e referências de estilo e depois use uma delas no generate-image. Uma paleta vai em direction.colorLook como palette:<id>, e um painel de inspiração vai em direction.style como moodboard:<id>. Veja paletas e painéis de inspiração na referência do SDK.
nodaro palettes list [--limit <n>] [--cursor <c>] [--json]
nodaro palettes get <id> [--json]
nodaro palettes create --name <name> --colors <#hex,#hex,...> [--description <text>] [--json]
nodaro palettes update <id> [--name <name>] [--colors <#hex,...>] [--description <text> | --clear-description] [--json]
nodaro palettes delete <id> [--json]
nodaro moodboards list [--limit <n>] [--cursor <c>] [--json]
nodaro moodboards get <id> [--json]
nodaro moodboards create --name <name> --image <url[|caption]>... [--description <text>] [--json]
nodaro moodboards update <id> [--name <name>] [--description <text> | --clear-description] [--image <url[|caption]>...] [--json]
nodaro moodboards delete <id> [--json]- Uma paleta tem de 2 a 12 cores.
- Um painel de inspiração tem de 1 a 12 imagens. Repita
--imagepara cada uma, com uma legenda opcional depois de|. Noupdate,--imagesubstitui todas as imagens. - Excluir um painel de inspiração não altera as imagens vinculadas.
nodaro palettes create --name Harbour --colors "#0F4C5C,#E3B23C,#F28C7A"
nodaro nodes run generate-image --param prompt="a lighthouse at dusk" --param 'direction={"colorLook":"palette:<paletteId>"}' --watchPacotes 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,...]snapshotimprime em JSON uma projeção/v1/catalogscompleta de um arquivo, com os arquivos de tradução dele.diff-upstreamé uma mesclagem de três vias. Ele leva as edições da versão de origem para as entradas que você não alterou, com os textos delas nas 11 localidades traduzidas. Ele informa os conflitos, em que você e a versão de origem alteraram a mesma entrada, e mantém a sua versão. Ele lista as novas entradas e as remoções da versão de origem, e nunca adiciona nada por conta própria. Ele sai com o código 2 quando há conflitos.validateverifica se o instantâneo 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 tarefas
Uma execução é cada vez que um workflow ou um app é executado. Uma tarefa é o trabalho de um único nó, como a geração de uma imagem. nodaro nodes run retorna uma tarefa.
nodaro executions get <id> [--watch] [--json]
nodaro executions cancel <id> [--mode cancelled|stopping]
nodaro jobs list [--status <s,s>] [--type <t,t>] [--origin <app>] [--source <s,s>] [--favorited | --no-favorited] [--rating good|bad|rated|unrated] [--limit <n>] [--cursor <c>] [--json]
nodaro jobs get <id> [--json]
nodaro jobs rate <id> good|bad|clear [--json]
nodaro jobs rename <id> <title> [--json]
nodaro jobs rename <id> --clear [--json]
nodaro jobs cancel <id> [--json]executions get --watchconsulta 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 stoppingdeixa o nível atual de nós terminar primeiro.jobs listlista as suas tarefas, das mais novas para as mais antigas.--status,--typee--sourceaceitam uma lista separada por vírgulas.--source mcplista o que os seus clientes MCP, como o Claude ou o ChatGPT, criaram.--no-favoritedmantém as tarefas que você não favoritou. Todos os filtros se combinam entre si.jobs ratedefine a sua avaliação de uma das suas tarefas.cleara remove.jobs renamedá um nome a uma das suas tarefas, em uma linha de até 120 caracteres. O nome volta comotitle.--clearo remove.
Galeria
nodaro gallery browse [--type image|video|audio] [--user <id> | --favorites] [--limit <n>] [--cursor <c>] [--json]
nodaro gallery favorite <jobId> [--json]
nodaro gallery favorites [--json]browse --usermostra o trabalho de uma pessoa. O seu próprio id inclui os seus itens privados.browse --favoritesmostra só os seus próprios itens que você favoritou.favoritealterna: favorita a tarefa, ou remove o favorito quando a tarefa já é favorita.favoritesimprime os ids das suas tarefas favoritas, das mais novas para as mais antigas.
Webhooks
Um endpoint de webhook é um endereço https que o Nodaro chama, com um POST assinado, toda vez que uma das suas tarefas termina com job.completed ou job.failed. Veja Webhooks para os eventos, o corpo e como verificar a assinatura.
nodaro webhooks list [--json]
nodaro webhooks get <id> [--json]
nodaro webhooks create --url <https-url> [--events job.completed,job.failed] [--description <text>] [--json]
nodaro webhooks update <id> [--url <https-url>] [--events <list>] [--description <text> | --clear-description] [--enable | --disable] [--json]
nodaro webhooks delete <id> [--json]
nodaro webhooks rotate-secret <id> [--grace <seconds>] [--json]
nodaro webhooks deliveries <id> [--status pending|delivered|failed] [--limit <n>] [--cursor <c>] [--json]
nodaro webhooks test <id> [--wait] [--poll-interval <ms>] [--json]| Comando | O que faz |
|---|---|
create | Registra um endpoint e imprime o segredo de assinatura dele (whsec_…) uma única vez. Guarde-o. Com --json, a saída é { data, secret }. |
update --enable | Liga o endpoint. Também desfaz um desligamento automático, que acontece depois de 50 entregas seguidas falharem de vez. |
delete | Exclui o endpoint e o registro de entregas dele. |
rotate-secret | Imprime um novo segredo uma única vez. O segredo antigo continua assinando por --grace segundos. O padrão é um dia, e 0 desativa o segredo antigo na hora. |
deliveries | Lista o registro de entregas, das mais novas para as mais antigas. |
test | Envia um ping, tentado uma vez, mesmo quando o endpoint está desligado. --wait acompanha essa entrega e mostra como o seu servidor respondeu. |
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 auto-hospedada 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]stopencerra 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.continueinicia uma nova tarefa que gera de novo a partir do segmentoN. 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]| Comando | O que faz |
|---|---|
prompt wizard | Faz perguntas guiadas no terminal. Sem --node-type, ele pergunta primeiro para qual nó é o prompt. Exige um terminal interativo. |
prompt analyze | Retorna as perguntas guiadas do assistente, para um script. |
prompt generate | Monta o prompt final a partir das suas respostas. Repita --selection category=value uma vez por resposta. |
prompt enhance | Reescreve um prompt em uma etapa, sem perguntas. |
--reasoning-efforténone,low,medium,high,xhighoumax. O suporte depende do modelo; um valor não aceito ou omitido usa o padrão do modelo. A chamada é cobrada pelos tokens que usa, pela tarifa do modelo, então um esforço maior só custa mais pelos tokens que escreve. Em um modelo Claude, qualquer esforço roda na API da própria Anthropic, pela tarifa dessa via.--advancedfunciona com modelos Gemini e Claude. Ele executa a requisição na API do próprio fabricante do modelo. Ele ativa--temperature,--max-tokense a faixa completa de raciocínio, e a chamada é cobrada pela tarifa dessa via.
Tomadas
Uma tomada é 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]| Comando | O que faz | Custo |
|---|---|---|
recast skill | Imprime em Markdown o guia de criação de scripts. | Grátis |
recast validate | Verifica um script. Sai com o código 1 enquanto o script for inválido. | Grátis |
recast import | Importa um script validado como uma análise concluída. --rights-attested declara que o script é obra sua. Um recast criado a partir de um script é renderizado em Faithful, exatamente como foi escrito. | Grátis |
recast estimate | Faz a cotação de uma execução em créditos. | Grátis |
recast create | Compra o plano e retorna o id da execução. Execute estimate antes. | Créditos |
recast start | Renderiza uma execução planejada. Executar duas vezes não causa problema. | Incluído no plano |
recast status | Mostra o status e qualquer etapa interativa que esteja esperando por você. | Grátis |
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.
Trends
Uma trend é uma receita pronta do Video Remake: um clipe curto com vagas para as pessoas, os pets, os produtos e o lugar, que você preenche com as suas próprias imagens. Os comandos de trends só funcionam no Nodaro Cloud.
nodaro trends list [--search <text>] [--tag <tag>] [--favorites] [--locale <l>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends get <slug> [--locale <l>] [--json]
nodaro trends estimate <slug> --slot <key>=<url>[,<url>] [--slot ...] [--choice <key>.<chip>=new|original] [--example <n>] [--details "…"] [--preview] [--resolution 480p|720p|1080p] [--draft] [--json]
nodaro trends run <slug> [the estimate options] [--session <id>] [--idempotency-key <key>] [--json]
nodaro trends runs [--trend <slug>] [--limit <n>] [--cursor <c>] [--json]
nodaro trends favorite <slug>
nodaro trends unfavorite <slug>| Comando | O que faz | Custo |
|---|---|---|
trends list | Lista as trends publicadas. --limit vai de 1 a 60. | Grátis |
trends get | Mostra as vagas de uma trend (chave, tipo, obrigatória), os exemplos, a prévia, o motor e as resoluções. | Grátis |
trends estimate | Faz a cotação de uma execução: cerca de quantos créditos ela custa, e quantos ficam reservados enquanto ela roda. | Grátis |
trends run | Inicia uma execução e imprime o id da tarefa. Acompanhe com nodaro jobs get <id>. Execute estimate antes. | Créditos |
trends runs | Lista as suas execuções de trends, das mais recentes para as mais antigas. A coluna de créditos é quanto cada execução custou depois de liquidada, com todas as etapas que ela executou: a preparação das referências, a máscara e o vídeo. Fica vazia até a reserva da própria execução ser liquidada. | Grátis |
trends favorite, trends unfavorite | Adiciona uma trend aos seus favoritos, ou a remove. | Grátis |
--slotse repete, uma vez por vaga, com 1 a 3 imagens cada. As imagens são separadas onde começa uma nova URL http ou https, então uma URL que contém vírgulas fica inteira. A chave de uma vaga tem de 1 a 32 caracteres entre a e z, 0 e 9 e_.--choicemantém um traço do clipe (original) ou o refaz com as suas imagens (new):body,outfitouhairde uma pessoa,bodyoucoatde um pet,shapeoufinishde um produto.--resolutioné uma das resoluções que a trend oferece, comotrends getas mostra. O padrão é a primeira da trend: 480p, ou 720p em uma trend do Nodaro Pulse.- Uma execução é normal, a menos que você passe
--draft.--draftgera um rascunho em 480p que a qualidade total pode finalizar em 1080p, só em uma trend do Nodaro Prism.--no-draftcontinua sendo aceito. --sessioné aceito, mas ainda não é aplicado: as execuções de trends ainda não são arquivadas em sessões.
Veja a API de Trends para os endpoints por trás destes comandos.
Qualidade total do Video Remake
Um rascunho do Nodaro Prism pode ser finalizado em 1080p, como a mesma tentativa, até 7 dias depois da conclusão. Um rascunho é uma execução do Video Remake ou de trend feita com draft: true, ou com --draft nos comandos trends. Uma execução normal e todas as execuções do Nodaro Pulse não têm qualidade total: execute-as de novo em 1080p no lugar. Os comandos só funcionam no Nodaro Cloud.
nodaro video-remake full-quality estimate <jobId> [--json]
nodaro video-remake full-quality run <jobId> [--session <id>] [--json]| Comando | O que faz | Custo |
|---|---|---|
video-remake full-quality estimate | Faz a cotação da versão em qualidade total: quantos créditos ela custa, aproximadamente, cada parte da cotação com o seu rótulo e até quando a execução pode ser finalizada. A renderização em 1080p é 0 quando a de uma tentativa anterior é reaproveitada. | Grátis |
video-remake full-quality run | Inicia a finalização e imprime o id da nova tarefa. Acompanhe com nodaro jobs get <id>. Execute estimate antes. | Créditos |
Há uma única qualidade total por rascunho. Quando ela já existe, run imprime essa tarefa e não cobra nada. full_quality_pending significa que a renderização em 1080p de uma tentativa anterior está em revisão ou ainda não começou. Não é definitivo: execute o comando de novo mais tarde. Veja Qualidade total.
Perguntas frequentes
Como listo todos os tipos de nó que a CLI do Nodaro pode executar?
Execute nodaro nodes list. Adicione --category ai-image, ou outra categoria, para filtrar a lista, e execute nodaro nodes get generate-image para ver o schema de entrada completo de um tipo de nó.
Como executo só alguns nós de um workflow pela CLI?
Adicione --node a nodaro workflows run, seguido dos ids dos nós separados por espaços. Só esses nós são executados.
Como paro um workflow em execução pelo terminal?
Execute nodaro executions cancel com o id da execução. O modo padrão, cancelled, para a execução na hora. Com --mode stopping, o nível atual de nós termina primeiro.
Como gero várias imagens com um só comando da CLI?
Execute nodaro nodes run generate-image com --count (de 1 a 4 imagens) ou --models com 2 a 4 ids de modelos de imagem. Adicione --watch para acompanhar cada tarefa até todas terminarem.
Quais comandos da CLI do Nodaro precisam do Nodaro Cloud?
Os comandos recast, trends e video-remake só funcionam no Nodaro Cloud. O mesmo vale para characters train, training e delete-lora, e para billing plans, subscription, summary e history. O controle de execuções do Gerar vídeo Pro também funciona em uma instalação auto-hospedada, pela conexão dela com o Nodaro Cloud.
Como recebo uma chamada no meu servidor quando uma tarefa termina?
Execute nodaro webhooks create --url com o seu endereço https. A CLI imprime o segredo de assinatura do endpoint uma única vez. Execute nodaro webhooks test com o id do endpoint e --wait para ver como o seu servidor respondeu.
Páginas relacionadas
CLI
Parâmetros e arquivos de entrada
Saída e códigos de saída
Comandos de entidades
Workflows
Última atualização
CLI
Instale a CLI do Nodaro pelo npm ou como binário, faça login uma vez por instância e execute workflows, apps e nós avulsos no terminal ou em uma tarefa de CI.
Parâmetros e arquivos de entrada
Como a CLI do Nodaro transforma pares key=value de --param e --input no corpo da requisição, como os valores ganham tipo e quando enviar um arquivo JSON.