Pular para o conteúdo principal
Todo comando que aceita um corpo de requisição suporta três formas de fornecê-lo:
  1. Flags individuais (maior prioridade)
  2. O flag --body com uma string JSON
  3. Pipe via stdin
Elas podem ser combinadas — o CLI as mescla e fontes de maior prioridade sobrescrevem as de menor prioridade no nível de campo.

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:
mka1 llm responses create \
  --model meetkai:functionary-pt \
  --input '"Resuma a fila de suporte de ontem."'
--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:
mka1 llm responses create --body '{
  "model": "meetkai:functionary-pt",
  "input": "Resuma a fila de suporte de ontem."
}'
Flags individuais ainda sobrescrevem o corpo no nível de campo:
# Corpo final: {"model":"meetkai:functionary-pt","input":"Um prompt diferente"}
mka1 llm responses create \
  --body '{"model":"meetkai:functionary-pt","input":"Prompt original"}' \
  --input '"Um prompt diferente"'

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:
# De um arquivo JSON
mka1 llm responses create < request.json

# De outro comando
curl -s https://example.com/prompt.json | mka1 llm responses create

# Gerado inline
echo '{"model":"meetkai:functionary-pt","input":"Olá"}' | mka1 llm responses create
Flags individuais também sobrescrevem valores do stdin:
# Corpo final: {"model":"meetkai:functionary-pt","input":"Sobrescrito"}
echo '{"model":"meetkai:functionary-pt","input":"Do stdin"}' \
  | mka1 llm responses create --input '"Sobrescrito"'

Cadeia de prioridade

Quando mais de uma fonte fornece o mesmo campo, a fonte de maior prioridade vence:
PrioridadeFonteUso típico
1 (maior)Flags individuaisAjustes pontuais, parâmetros em scripts
2Flag --bodyCorpo JSON formado inline
3 (menor)StdinJSON vindo de pipe ou arquivo
O CLI mescla as chaves dos objetos, então você pode misturar: envie a maior parte do corpo via stdin e depois sobrescreva um campo com um flag.

Encadeie comandos

Como cada comando imprime JSON no stdout (quando você passa --output-format json), é possível alimentar uma chamada na próxima:
mka1 llm files upload \
  --file ./support-manual.pdf \
  --purpose assistants \
  --output-format json \
  --jq '{file_id: .id, purpose: .purpose}' \
  | mka1 llm vector-stores create-file --vector-store-id vs_123
Veja formatar e filtrar saída para mais sobre --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:
mka1 llm files upload --file ./dataset.jsonl --purpose fine-tune
Respostas binárias (por exemplo, llm speech speak) suportam --output-file para gravar o payload em um caminho ao invés de imprimir:
mka1 llm speech speak \
  --text 'Olá, bem-vindo ao nosso serviço.' \
  --output-file ./welcome.wav
Use --output-b64 quando quiser o binário codificado em base64 no stdout.