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âmetro | Tipo | Obrigatório | Descrição |
|---|
--api <chat|responses> | string | Não | API a chamar (padrão: chat) |
--model <model> | string | Não | ID do modelo (padrão: qwen3.8-max) |
--message <text> | array | Não | Texto da mensagem (repetível, prefixe role: para definir o papel); ou use --messages-file |
--messages-file <path> | string | Não | Arquivo JSON com matriz de mensagens (use - para stdin) |
--system <text> | string | Não | Prompt do sistema |
--max-tokens <n> | number | Não | Número máximo de tokens a gerar (padrão: 4096) |
--temperature <n> | number | Não | Temperatura de amostragem (0.0, 2.0] |
--top-p <n> | number | Não | Limite de amostragem de núcleo |
--enable-search <true|false> | boolean | Não | Ativar a pesquisa na web integrada do modelo (somente API Chat Completions; padrão: ativado para qwen3.8-max) |
--stream | switch | Não | Transmitir tokens de resposta (padrão: ligado em TTY) |
--tool <json-or-path> | array | Não | Definição de ferramenta como JSON ou caminho de arquivo (repetível) |
--enable-thinking | boolean | Não | Habilitar modo de pensamento/raciocínio (para modelos qwen3/qwq); use --enable-thinking=false para desativar |
--thinking-budget <n> | number | Não | Número máximo de tokens para pensamento (padrão: 4096) |
--batch | switch | não | Enviar uma única requisição Batch Chat síncrona (não streaming) |
--prime | switch | Não | Usar modo Prime com endpoint com escopo de workspace |
--workspace-id <id> | string | Não | ID 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âmetro | Tipo | Obrigatório | Descrição |
|---|
--message <text> | array | Não | Texto da mensagem (repetível, prefixe role: para definir o papel) |
--model <model> | string | Não | ID do modelo (padrão: qwen3.8-omni-flash) |
--system <text> | string | Não | Prompt do sistema |
--image <url> | array | Não | URL da imagem ou arquivo local (repetível) |
--audio <url> | array | Não | URL de áudio ou arquivo local (.wav/.mp3/.amr/.aac/.m4a/.ogg/.3gp/.3gpp) |
--video <url> | array | Não | URL de arquivo de vídeo / caminho local, ou URLs de quadros separadas por vírgula |
--voice <voice> | string | Não | ID de voz de saída (padrão: Tina). Use --list-voices para ver todas as opções |
--list-voices | switch | Não | Listar vozes de saída disponíveis e encerrar |
--audio-format <fmt> | string | Não | Formato de saída de áudio (padrão: wav) |
--audio-out <path> | string | Não | Salvar áudio em arquivo (padrão: gerar automaticamente) |
--text-only | switch | Não | Gerar apenas texto, sem geração de áudio |
--max-tokens <n> | number | Não | Número máximo de tokens a gerar |
--temperature <n> | number | Não | Temperatura de amostragem (0.0, 2.0] |
Exemplo: Listar vozes de saída disponíveis para Qwen-Omni