# Exemplos

> Receitas prontas da CLI do Nodaro: execute um workflow toda noite com cron, condicione etapas de CI, gere imagens, legende um vídeo e melhore um prompt.

Source: https://nodaro.ai/pt-BR/docs/developers/cli/examples

Estes **exemplos da CLI do Nodaro** são receitas curtas para tarefas comuns: execuções agendadas, condições em pipelines de CI, geração por script, legendas a partir de uma transcrição e melhoria de prompts. Cada um pressupõe que você já [instalou a CLI e fez login](https://nodaro.ai/docs/developers/cli), e a maioria usa o `jq` para ler a saída JSON.

## Executar um workflow toda noite com o cron
Esta entrada do cron executa um workflow toda noite às 03:00 e acrescenta o resultado em JSON a um arquivo de log:

```text
0 3 * * * /usr/local/bin/nodaro workflows run wf_abc123 --json >> /var/log/nodaro-nightly.log 2>&1
```

## Aguardar uma execução e depois continuar
`--watch` faz o comando aguardar a execução e sair com `0` só em caso de sucesso, então o próximo comando só é executado quando o workflow deu certo:

```bash
nodaro workflows run wf_abc --watch && \
echo "shipped" | mail -s "nodaro run done" me@example.com
```

Os outros códigos de saída estão listados em [Saída e códigos de saída](https://nodaro.ai/docs/developers/cli/output).

## Gerar uma imagem com um único comando
```bash
nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --param resolution=2K \
  --watch --json | jq -r '.output_data.imageUrl'
```

O comando imprime só a URL da imagem, pronta para a próxima etapa de um script.

## Legendar um vídeo a partir da transcrição
Transcreva uma faixa com as marcações de tempo das palavras e depois embuta as palavras no vídeo como legendas cinéticas.

```bash
# 1. Word-level transcription (elevenlabs-stt always returns word timings)
nodaro audio transcribe --audio https://example.com/talk.mp3 \
  --provider elevenlabs-stt --watch

# 2. Save the words. They are in milliseconds; the top-level segments are in seconds.
nodaro jobs get <jobId> --json | jq '.output_data.words' > words.json

# 3. Burn them in. With captions supplied, add-captions runs no transcription of its own.
nodaro media add-captions https://example.com/talk.mp4 \
  --captions-file words.json \
  --style word-highlight --no-auto-transcribe --watch
```

- Corrija o `text` de uma palavra em `words.json` entre as etapas 2 e 3, e é a correção que aparece no vídeo.
- Adicione `--max-words-per-line 2` à etapa 3 para uma leitura rápida, duas palavras de cada vez.
- A etapa 1 precisa de um mecanismo que marque o tempo de cada palavra: `elevenlabs-stt`, ou `incredibly-fast-whisper` com `--word-timestamps`. O mecanismo `whisper` retorna frases sem as palavras, então um estilo cinético não teria nada para mostrar.

Veja [Comandos de mídia e voz](https://nodaro.ai/docs/developers/cli/media-commands#captions) para todas as opções de legenda.

## Envolver o prompt de um app com texto oculto
`--override` adiciona texto antes e depois do prompt do usuário em uma execução, sem alterar o app:

```bash
nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" \
  --override n1.promptPrefix="Studio portrait of" --override n1.promptSuffix=", 85mm, soft light"
```

Veja [Texto antes e depois do prompt](https://nodaro.ai/docs/concepts/prompt-pre-post-text) para saber como o texto é unido ao prompt.

## Transformar uma ideia vaga em um prompt otimizado
`prompt enhance` reescreve um prompt em uma etapa. Passe o resultado direto para a execução de um nó:

```bash
PROMPT=$(nodaro prompt enhance \
  --node-type generate-image \
  --prompt "snow leopard" \
  --json | jq -r '.prompt')

nodaro nodes run generate-image --param prompt="$PROMPT" --watch
```

Para usar as perguntas guiadas do assistente em um script, siga o caminho de duas etapas: `nodaro prompt analyze --json` retorna as perguntas, e `nodaro prompt generate --selection category=value` monta o prompt final a partir das suas respostas. O `nodaro prompt wizard` interativo precisa de um terminal.

## Exportar um mês de uso
Em uma instância com organizações, grave em um arquivo CSV um relatório de uso por membro:

```bash
nodaro org usage org_abc --from 2026-09-01 --to 2026-09-30 --group-by member --csv > september.csv
```

Veja [Espaços de trabalho e organizações](https://nodaro.ai/docs/developers/cli/workspaces#usage-reports).

## Frequently asked questions

### Como executo um workflow do Nodaro de forma agendada?

Adicione uma entrada no cron que chame nodaro workflows run com o id do workflow e --json e acrescente a saída a um arquivo de log. O primeiro exemplo desta página executa um workflow toda noite às 03:00.

### Como obtenho a URL de uma imagem gerada em um shell script?

Execute nodaro nodes run generate-image com --watch e --json, e encaminhe a saída com um pipe para jq -r '.output_data.imageUrl'.

### Como adiciono legendas palavra por palavra a um vídeo pela CLI?

Transcreva o áudio com um mecanismo que marca o tempo de cada palavra, como o elevenlabs-stt, salve o output_data.words do job em um arquivo e passe o arquivo para nodaro media add-captions com --captions-file e --no-auto-transcribe.

### Posso melhorar um prompt antes de executar um nó?

Sim. nodaro prompt enhance com --node-type e --prompt retorna um prompt otimizado, que você pode passar direto para nodaro nodes run.