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

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

GrupoO que fazOnde está documentado
authFaz login, mostra e remove perfisCLI
projectsCria, lê, atualiza e exclui projetosEsta página
sessionsSessões de geração dentro de projetosEsta página
workflowsGerencia, exporta, importa, executa e compartilha workflowsEsta página
appsNavega pelos apps publicados e os executaEsta página
nodesLista os tipos de nó e executa um único nóEsta página
modelsNavega pelo catálogo de modelos e calcula o preço de identificadoresEsta página
billingPlanos e preços, a sua assinatura, o seu uso e o seu histórico de créditosEsta página
pickersLê os catálogos de seletores e preenche seletores a partir de uma descriçãoEsta página
presetsAs suas predefinições de nó, favoritos e pastas, e o catálogo integradoEsta página
palettes, moodboardsAs suas paletas de cores e painéis de inspiração para o Gerar imagemEsta página
catalogMantém os pacotes de catálogo de uma implantação, offlineEsta página
executions, jobsInspeciona, filtra, avalia e cancela execuçõesEsta página
galleryA galeria pública e os seus favoritosEsta página
webhooksEndpoints que o Nodaro chama quando uma tarefa terminaEsta página
video-proPara e retoma execuções do Gerar vídeo ProEsta página
promptTransforma uma ideia vaga em um prompt otimizadoEsta página
shotsCria e lê registros de compartilhamento de tomadasEsta página
recastPlaneja e renderiza uma execução de Recast, ou importa um scriptEsta página
trendsExecuta uma receita pronta do Video Remake com as suas próprias imagensEsta página
video-remakeFinaliza um rascunho do Nodaro Prism em qualidade totalEsta página
characters, locations, objectsGerencia entidades e gera as imagens e os movimentos delasComandos de entidades
voice, media, audio, editTroca vozes, legenda, compõe e edita mídiasComandos de mídia e voz
org, workspaceOrganizações, convites, espaços de trabalho e relatórios de usoEspaç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.
  • --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]

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]
  • import vincula tarefas à sessão. É tudo ou nada: uma tarefa que não é sua faz a chamada inteira falhar.
  • remove remove só o vínculo. A tarefa continua existindo, assim como as outras sessões que a contêm.
  • delete exclui a sessão. As tarefas dela são mantidas.
  • update --cover escolhe um dos itens da sessão para abrir as prévias dela. --auto-cover volta 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çãoO que faz
create --fileCria o workflow a partir de um pacote de workflow exportado.
update --fileGrava no workflow os nós, as conexões e as configurações de um arquivo JSON.
export --with-assetsAdiciona ao pacote os dados de personagens, objetos e locais que o workflow usa.
export --outputGrava o pacote em um arquivo em vez de imprimi-lo.
run --nodeExecuta só os ids de nós listados, separados por espaços.
run --watchAcompanha a execução até ela terminar.
run --continue-from --from-failedContinua 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 --nodeExecuta só os nós indicados, continuando uma execução concluída. Cada um dos outros nós repassa os resultados dessa execução.
run --overrideUma configuração por nó somente nesta execução, escrita nodeId.field=value. Repita para mais configurações.
run --idempotency-keyEnviado como o cabeçalho Idempotency-Key (8 caracteres ou mais). A mesma chave duas vezes inicia uma só execução.
run --nextEnvia 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-finalRenderiza 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]
  • 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.
  • mcp-conversations lista 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. --source mantém só alguns assistentes. Veja As conversas MCP viram workflows.
  • 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>
nodaro apps run-retry <slug> <runId> [--dry-run] [--app-version <n>] [--watch] [--json]
  • 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.
  • apps run-retry tenta 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-run lista 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 com app_run_version_changed. A CLI então mostra os dois caminhos: começar de novo com nodaro 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.
  • --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. 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, trigger ou utility.
  • nodes get imprime o schema de entrada de um tipo de nó: os campos que --param aceita.
  • nodes run envia para a rota própria do nó, POST /v1/<type> para a maioria dos tipos de nó. Alguns tipos de nó, como llm-chat e 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, como modify-image ou paint-mask, falha antes de a API ser chamada, e a mensagem diz o que executar no lugar. Veja Executar nós.
  • --watch consulta a tarefa periodicamente até ela terminar, quando a resposta tem um id de tarefa. --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.

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 --watch

Vá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 --watch

A 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 --watch

Modelos

nodaro models list [--kind image|video|audio] [--mode <mode>] [--family <vendor>] [--featured] [--json]
nodaro models cost <id…> [--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, 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]
ComandoO que mostra
billing plansOs planos e os pacotes de créditos à venda, com os preços. Só no Nodaro Cloud. Não é preciso fazer login.
billing subscriptionA sua assinatura e o nível que os direitos da sua conta seguem. Só no Nodaro Cloud.
billing accountO seu plano e o seu saldo, como o provedor de cobrança da implantação os informa, na unidade dele.
billing surfaceComo a implantação cobra: se mede o uso e em que unidade os custos são mostrados. Não é preciso fazer login.
billing summaryO 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 historyCada 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çãoO que faz
pickers listLista todos os tipos de nó de seletor, o número de opções de cada um e quantas opções têm imagem.
pickers getRetorna um catálogo. Cada opção traz id, label, category, term, icon e, quando tem imagem, imageUrl.
--fullInclui a descrição de cada opção e o trecho de prompt que ela adiciona.
--categoryFiltra um seletor de uma única dimensão por uma categoria.
--fieldRetorna uma dimensão de um seletor de várias dimensões, como shotSize do Enquadramento.
pickers analyzeAI Fill: escolhe valores de seletores a partir de uma descrição em texto livre. É uma chamada a um LLM, cobrada em créditos.
--targetUma 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çãoO que faz
list --factoryLista 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.
listSem --factory, lista as suas próprias predefinições. Precisa de um perfil.
create --preview-urlUma imagem já armazenada nesta plataforma: um upload ou um resultado pronto.
update --expected-updated-at, delete --expected-updated-atRecusam a alteração quando a predefinição mudou depois desse horário.
exportGrava as suas predefinições em um arquivo JSON que import aceita.
importLê esse arquivo, ou uma lista JSON de predefinições, de um caminho ou da entrada padrão.
favorite, unfavoriteAdicionam ou removem um favorito: um id integrado ou um dos ids das suas predefinições.
groupsLista, 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 --image para cada uma, com uma legenda opcional depois de |. No update, --image substitui 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>"}' --watch

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. 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.
  • validate verifica 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 --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.
  • jobs list lista as suas tarefas, das mais novas para as mais antigas. --status, --type e --source aceitam uma lista separada por vírgulas. --source mcp lista o que os seus clientes MCP, como o Claude ou o ChatGPT, criaram. --no-favorited mantém as tarefas que você não favoritou. Todos os filtros se combinam entre si.
  • jobs rate define a sua avaliação de uma das suas tarefas. clear a remove.
  • jobs rename dá um nome a uma das suas tarefas, em uma linha de até 120 caracteres. O nome volta como title. --clear o remove.
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 --user mostra o trabalho de uma pessoa. O seu próprio id inclui os seus itens privados.
  • browse --favorites mostra só os seus próprios itens que você favoritou.
  • favorite alterna: favorita a tarefa, ou remove o favorito quando a tarefa já é favorita.
  • favorites imprime 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]
ComandoO que faz
createRegistra um endpoint e imprime o segredo de assinatura dele (whsec_…) uma única vez. Guarde-o. Com --json, a saída é { data, secret }.
update --enableLiga o endpoint. Também desfaz um desligamento automático, que acontece depois de 50 entregas seguidas falharem de vez.
deleteExclui o endpoint e o registro de entregas dele.
rotate-secretImprime 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.
deliveriesLista o registro de entregas, das mais novas para as mais antigas.
testEnvia 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]
  • 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 uma nova tarefa 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]
ComandoO que faz
prompt wizardFaz perguntas guiadas no terminal. Sem --node-type, ele pergunta primeiro para qual nó é o prompt. Exige um terminal interativo.
prompt analyzeRetorna as perguntas guiadas do assistente, para um script.
prompt generateMonta o prompt final a partir das suas respostas. Repita --selection category=value uma vez por resposta.
prompt enhanceReescreve um prompt em uma etapa, sem perguntas.
  • --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. 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.
  • --advanced funciona com modelos Gemini e Claude. Ele executa a requisição na API do próprio fabricante do modelo. Ele ativa --temperature, --max-tokens e 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]
ComandoO que fazCusto
recast skillImprime em Markdown o guia de criação de scripts.Grátis
recast validateVerifica um script. Sai com o código 1 enquanto o script for inválido.Grátis
recast importImporta 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 estimateFaz a cotação de uma execução em créditos.Grátis
recast createCompra o plano e retorna o id da execução. Execute estimate antes.Créditos
recast startRenderiza uma execução planejada. Executar duas vezes não causa problema.Incluído no plano
recast statusMostra 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.

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>
ComandoO que fazCusto
trends listLista as trends publicadas. --limit vai de 1 a 60.Grátis
trends getMostra as vagas de uma trend (chave, tipo, obrigatória), os exemplos, a prévia, o motor e as resoluções.Grátis
trends estimateFaz a cotação de uma execução: cerca de quantos créditos ela custa, e quantos ficam reservados enquanto ela roda.Grátis
trends runInicia uma execução e imprime o id da tarefa. Acompanhe com nodaro jobs get <id>. Execute estimate antes.Créditos
trends runsLista 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 unfavoriteAdiciona uma trend aos seus favoritos, ou a remove.Grátis
  • --slot se 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 _.
  • --choice mantém um traço do clipe (original) ou o refaz com as suas imagens (new): body, outfit ou hair de uma pessoa, body ou coat de um pet, shape ou finish de um produto.
  • --resolution é uma das resoluções que a trend oferece, como trends get as 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. --draft gera um rascunho em 480p que a qualidade total pode finalizar em 1080p, só em uma trend do Nodaro Prism. --no-draft continua 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]
ComandoO que fazCusto
video-remake full-quality estimateFaz 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 runInicia 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.

Última atualização

Nesta página