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.
Os parâmetros são os valores que você passa para uma execução na linha de comando. nodaro nodes run recebe esses valores como --param key=value, e nodaro apps run, como --input key=value. As duas flags podem ser repetidas e seguem as mesmas regras, e um arquivo JSON com --params-file cobre tudo o que não cabe em uma flag.
Pares key=value
Repita a flag uma vez por valor. Coloque entre aspas um valor que tenha espaços, para que o shell o passe como um único argumento.
nodaro nodes run generate-video \
--param prompt="a paper boat drifting down a rainy street" \
--param provider=seedance-2-fast \
--param duration=8A CLI dá um tipo a cada valor antes de enviar a requisição:
| Você digita | O corpo da requisição recebe |
|---|---|
true ou false | Um booleano |
null | null |
Um número inteiro, como 8 | Um número |
Um número decimal, como 0.5 | Um número |
Um valor que começa com [ ou { e é um JSON válido | Um array ou um objeto JSON |
| Qualquer outra coisa | Uma string |
Só o primeiro = separa a chave do valor. O resto do texto é mantido, então --param query=a=b=c envia a string a=b=c.
Um array JSON em linha fica assim. Coloque o par entre aspas simples, para que o shell mantenha as aspas duplas:
nodaro nodes run generate-image --param prompt="the same mug on a marble counter" --param 'referenceImageUrls=["https://example.com/mug-front.png","https://example.com/mug-side.png"]'subject no generate-image e no text-to-video indica quem está na tomada, por ID de catálogo. Como um valor que começa com { é lido como JSON, o mapa inteiro cabe em um único --param. Os nomes dos campos e os IDs vêm de nodaro pickers get person, e também de styling, held-prop, material e animal. O Nodaro escreve o texto. Veja Nós.
nodaro nodes run generate-image --param prompt="on the seawall at dusk" \
--param subject='{"type":"woman","age":"age-30s","heldProp":"smartphone"}' --watchPara descobrir as chaves que um nó aceita, execute nodaro nodes get <type>. Para um app, execute nodaro apps get <slug>.
Enviar um arquivo JSON
Para objetos aninhados, arrays longos ou qualquer valor que não caiba no formato de flag, escreva o corpo inteiro em um arquivo JSON e passe o arquivo com --params-file. O arquivo precisa conter um único objeto JSON.
cat > body.json <<'EOF'
{
"prompt": "a lighthouse on a cliff at dawn, cinematic",
"provider": "flux",
"aspectRatio": "16:9"
}
EOF
nodaro nodes run generate-image --params-file body.json --param aspectRatio=9:16As flags têm prioridade sobre o arquivo. Neste exemplo, a execução usa a proporção 9:16 da flag e o restante do corpo do arquivo.
Entradas do app e campos diretos de nós
nodaro apps run recebe os nomes das entradas do app como chaves:
nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" --watch--override alcança campos de nós que o app não expõe, só nesta execução. Escreva no formato <nodeId>.<field>=<value>:
nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" \
--override n1.promptPrefix="Studio portrait of" --override n1.promptSuffix=", 85mm, soft light"Este exemplo envolve o prompt do usuário com texto oculto antes e depois dele. Veja Texto antes e depois do prompt. Uma substituição nunca pode mudar para onde um nó envia dados ou de onde ele os busca, como o endereço de um nó Saída de webhook; a execução é recusada com locked_field.
Executar nós de entrada e de origem
Os nós de entrada e de origem são executados da mesma forma. O Extrair da web, web-scrape, recebe a origem como actor: google-search, content-crawler, rss ou tiktok.
# Google Search results
nodaro nodes run web-scrape --param actor=google-search --param query="running shoes" --param maxResults=5
# The text of one web page, as Markdown
nodaro nodes run web-scrape --param actor=content-crawler --param url=https://example.com --param mode=pageEm uma instalação auto-hospedada, o Extrair da web precisa de APIFY_API_TOKEN no servidor, ou de uma conexão com o Nodaro Cloud que execute e cobre a extração.
Perguntas frequentes
Como a CLI do Nodaro decide se um valor é um número ou uma string?
As palavras true e false viram booleanos, null vira null, e números inteiros e decimais viram números. Um valor que começa com colchete ou chave vira um array ou um objeto JSON quando é um JSON válido. Todo o resto continua como string.
Um valor de --param pode conter um sinal de igual?
Sim. Só o primeiro sinal de igual separa a chave do valor, então --param query=a=b=c envia o valor a=b=c.
Quando devo usar --params-file em vez de --param?
Use um arquivo JSON para objetos aninhados, arrays longos ou qualquer valor difícil de digitar como flag. As flags do mesmo comando têm prioridade sobre as chaves que também estão no arquivo.
Qual é a diferença entre --param e --input?
Use --param com nodaro nodes run, em que as chaves são os campos de entrada do nó. Use --input com nodaro apps run, em que as chaves são os nomes das entradas do app. As duas flags seguem a mesma sintaxe.
Páginas relacionadas
Comandos
Saída e códigos de saída
Exemplos
Nós
Última atualização
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.
Saída e códigos de saída
Leia a saída da CLI do Nodaro em tabela ou JSON, acompanhe execuções até o fim com --watch e trate nos scripts os códigos de falha, cancelamento e revisão.