文本對話與全模態

一條命令即可在終端機呼叫阿里雲百煉文本對話與全模態互動能力。

任意命令追加 --help 可檢視完整參數說明，例如 bl text chat --help。所有接受檔案 URL 的參數也接受本地路徑——CLI 會自動上傳到暫時儲存（有效期 48 小時），無需手動託管為 URL。本文命令明細以 bl 2.2.1 為基準核實。

命令速查

發送文字模型請求（OpenAI 兼容，DashScope）。需要 API Key 鑑權。語法

bl text chat --message <text> [flags]

參數	類型	必填	說明
`--api <chat\|responses>`	string	否	呼叫的 API（預設：chat）
`--model <model>`	string	否	模型 ID（預設：qwen3.8-max）
`--message <text>`	array	否	消息文字（可重複；可使用 role: 前綴指定角色），也可使用 --messages-file
`--messages-file <path>`	string	否	包含 messages 數組的 JSON 檔案（使用 - 從 stdin 讀取）
`--system <text>`	string	否	系統提示詞
`--max-tokens <n>`	number	否	最大生成 Token 數（預設：4096）
`--temperature <n>`	number	否	採樣溫度 (0.0, 2.0]
`--top-p <n>`	number	否	核採樣閾值
`--stream`	switch	否	流式輸出回應 Token（TTY 中預設開啟）
`--tool <json-or-path>`	array	否	JSON 格式的工具定義或檔案路徑（可重複）
`--enable-thinking`	switch	否	啟用思考/推理模式（適用於 qwen3/qwq 模型）
`--thinking-budget <n>`	number	否	思考過程最大 Token 數（預設：4096）
`--prime`	switch	否	使用工作空間專屬 Endpoint 的 Prime 模式
`--workspace-id <id>`	string	否	預設 Prime Endpoint 使用的工作空間 ID（也可設定 BAILIAN_WORKSPACE_ID）

範例：發送文字訊息請求模型回覆

bl text chat --message "通义千问是什么？"

Prime 模式必須顯式指定模型，且目前僅支援 Chat Completions API。
Prime Endpoint：已設定的 --base-url、DASHSCOPE_BASE_URL 或 Profile base_url 優先；否則依 --workspace-id、BAILIAN_WORKSPACE_ID、設定項 workspace_id 解析工作空間。

支援文字輸入與音訊輸出的多模態對話（Qwen-Omni）。需要 API Key 鑑權。語法

bl omni --message <text> [flags]

參數	類型	必填	說明
`--message <text>`	array	否	消息文字（可重複；可使用 role: 前綴指定角色）
`--model <model>`	string	否	模型 ID（預設：qwen3.5-omni-plus）
`--system <text>`	string	否	系統提示詞
`--image <url>`	array	否	圖片 URL 或本地檔案（可重複）
`--audio <url>`	array	否	音訊 URL 或本地檔案（.wav/.mp3/.amr/.aac/.m4a/.ogg/.3gp/.3gpp）
`--video <url>`	array	否	影像檔案 URL / 本地路徑，或以逗號分隔的幀 URL
`--voice <voice>`	string	否	輸出音色 ID（預設：Tina）。使用 --list-voices 檢視所有選項
`--list-voices`	switch	否	列出可用的輸出音色並退出
`--audio-format <fmt>`	string	否	音訊輸出格式（預設：wav）
`--audio-out <path>`	string	否	將音訊儲存至檔案（預設：自動產生路徑）
`--text-only`	switch	否	僅輸出文字，不產生音訊
`--max-tokens <n>`	number	否	最大生成 Token 數
`--temperature <n>`	number	否	採樣溫度 (0.0, 2.0]

範例：預覽可用音色列表

bl omni --list-voices