Skip to main content

Chat de Texto & Omni

Referência de comando da CLI Bailian para chat de texto e interação multimodal Omni.

Um único comando invoca as capacidades de chat de texto e interação multimodal Omni do Bailian a partir do terminal.
Anexe --help a qualquer comando para obter detalhes completos dos parâmetros, por exemplo: bl text chat --help. Todos os parâmetros que aceitam uma URL de arquivo também aceitam um caminho local — a CLI faz o upload automático para armazenamento temporário (válido por 48 horas), então você nunca precisa hospedar arquivos como URLs manualmente. Os detalhes dos comandos nesta página são verificados com o bl 2.10.1.

Referência de comando

bl text chat

Envia uma solicitação de modelo de texto (compatível com OpenAI, DashScope). Requer autenticação com chave de API. Uso
bl text chat --message <text> [flags]
ParâmetroTipoObrigatórioDescrição
--api <chat|responses>stringNãoAPI a chamar (padrão: chat)
--model <model>stringNãoID do modelo (padrão: qwen3.8-max)
--message <text>arrayNãoTexto da mensagem (repetível, prefixe role: para definir o papel); ou use --messages-file
--messages-file <path>stringNãoArquivo JSON com matriz de mensagens (use - para stdin)
--system <text>stringNãoPrompt do sistema
--max-tokens <n>numberNãoNúmero máximo de tokens a gerar (padrão: 4096)
--temperature <n>numberNãoTemperatura de amostragem (0.0, 2.0]
--top-p <n>numberNãoLimite de amostragem de núcleo
--enable-search <true|false>booleanNãoAtivar a pesquisa na web integrada do modelo (somente API Chat Completions; padrão: ativado para qwen3.8-max)
--streamswitchNãoTransmitir tokens de resposta (padrão: ligado em TTY)
--tool <json-or-path>arrayNãoDefinição de ferramenta como JSON ou caminho de arquivo (repetível)
--enable-thinkingbooleanNãoHabilitar modo de pensamento/raciocínio (para modelos qwen3/qwq); use --enable-thinking=false para desativar
--thinking-budget <n>numberNãoNúmero máximo de tokens para pensamento (padrão: 4096)
--batchswitchnãoEnviar uma única requisição Batch Chat síncrona (não streaming)
--primeswitchNãoUsar modo Prime com endpoint com escopo de workspace
--workspace-id <id>stringNãoID do workspace para o endpoint Prime padrão (ou defina BAILIAN_WORKSPACE_ID)
Exemplo: Enviar mensagem perguntando "O que é Qwen?"
bl text chat --message "What is Qwen?"
Exemplo: Enviar uma requisição Batch Chat síncrona
bl text chat --batch --model qwen-plus --message "Olá" --timeout 3600
  • --batch envia uma requisição Batch Chat síncrona e força non-streaming mesmo em um TTY. Não pode ser combinado com --prime, --api responses ou --stream. --message ou --messages-file fornece o contexto da conversa para uma requisição, não requisições independentes de um arquivo.
  • O timeout total da requisição Batch Chat é 300 segundos por padrão; --timeout deve ser 60–3600 segundos. Para inferência em lote baseada em arquivo, use batch create/get/download; create retorna um ID de tarefa sem aguardar a conclusão.
  • --batch rejeita endpoints realtime, internacionais ou Token Plan especificados explicitamente; URLs de Batch ou proxy personalizado especificadas explicitamente mantêm as credenciais existentes. Não há fallback automático nem reenvio de POST.
  • O modo Prime exige um modelo explícito e atualmente suporta apenas a API de Completions de Chat.
  • Endpoint Prime: configurado via --base-url, DASHSCOPE_BASE_URL ou base_url do perfil tem precedência; caso contrário, o workspace é resolvido a partir de --workspace-id, BAILIAN_WORKSPACE_ID, depois config workspace_id.
  • --enable-search mapeia para o parâmetro enable_search do Chat Completions e exige um modelo com suporte a pesquisa na web integrada. Modelos na lista de permissões (qwen3.8-max) o ativam por padrão; passe --enable-search false para desativar. Para a API Responses, use --tool '{"type":"web_search"}' em vez disso.
  • --enable-thinking aceita um valor false explícito; quando o pensamento está desativado, a CLI não envia thinking_budget.

bl omni

Chat multimodal com texto + saída de áudio (Qwen-Omni). Requer autenticação com chave de API. Uso
bl omni --message <text> [flags]
ParâmetroTipoObrigatórioDescrição
--message <text>arrayNãoTexto da mensagem (repetível, prefixe role: para definir o papel)
--model <model>stringNãoID do modelo (padrão: qwen3.8-omni-flash)
--system <text>stringNãoPrompt do sistema
--image <url>arrayNãoURL da imagem ou arquivo local (repetível)
--audio <url>arrayNãoURL de áudio ou arquivo local (.wav/.mp3/.amr/.aac/.m4a/.ogg/.3gp/.3gpp)
--video <url>arrayNãoURL de arquivo de vídeo / caminho local, ou URLs de quadros separadas por vírgula
--voice <voice>stringNãoID de voz de saída (padrão: Tina). Use --list-voices para ver todas as opções
--list-voicesswitchNãoListar vozes de saída disponíveis e encerrar
--audio-format <fmt>stringNãoFormato de saída de áudio (padrão: wav)
--audio-out <path>stringNãoSalvar áudio em arquivo (padrão: gerar automaticamente)
--text-onlyswitchNãoGerar apenas texto, sem geração de áudio
--max-tokens <n>numberNãoNúmero máximo de tokens a gerar
--temperature <n>numberNãoTemperatura de amostragem (0.0, 2.0]
Exemplo: Listar vozes de saída disponíveis para Qwen-Omni
bl omni --list-voices