- Flags individuais (maior prioridade)
- O flag
--bodycom uma string JSON - Pipe via stdin
Flags individuais
Use um flag dedicado para cada campo. Esta é a opção mais fácil de descobrir e a mais simples de usar com auto-completar do shell:--help mostra todos os flags aceitos pelo comando, junto com os obrigatórios e opções enum.
O flag --body
Envie o corpo completo da requisição como uma única string JSON. Útil quando você já tem o corpo formado — por exemplo, de outra ferramenta ou de um teste:
Pipe via stdin
Envie JSON para qualquer comando que aceite um corpo. Esta é a escolha certa para scripts, encadear comandos ou ler corpos de arquivos:Cadeia de prioridade
Quando mais de uma fonte fornece o mesmo campo, a fonte de maior prioridade vence:| Prioridade | Fonte | Uso típico |
|---|---|---|
| 1 (maior) | Flags individuais | Ajustes pontuais, parâmetros em scripts |
| 2 | Flag --body | Corpo JSON formado inline |
| 3 (menor) | Stdin | JSON vindo de pipe ou arquivo |
Encadeie comandos
Como cada comando imprime JSON no stdout (quando você passa--output-format json), é possível alimentar uma chamada na próxima:
--output-format e --jq.
Entradas de arquivo
Comandos de upload de arquivos (llm files upload, llm speech transcribe, llm extract extract e similares) aceitam um caminho com --file.
O CLI lê o arquivo e o envia como multipart form data:
llm speech speak) suportam --output-file para gravar o payload em um caminho ao invés de imprimir:
--output-b64 quando quiser o binário codificado em base64 no stdout.