All Products
Search
Document Center

Alibaba Cloud Model Studio:Text Chat & Omni

Last Updated:Nov 05, 2026

Bailian CLI command reference for text chat and Omni multimodal interaction.

A single command invokes Bailian's text chat and Omni multimodal interaction capabilities from the terminal.

ImportantAppend --help to any command for full parameter details, e.g. bl text chat --help. Every parameter that accepts a file URL also accepts a local path — the CLI auto-uploads it to temporary storage (valid for 48 hours), so you never need to host files as URLs yourself. Command details on this page are verified against bl 2.8.0.

Command reference

bl text chat

Send a text model request (OpenAI compatible, DashScope). Requires API Key authentication.

Usage

bl text chat --message <text> [flags]
ParameterTypeRequiredDescription
--api <chat|responses>stringnoAPI to call (default: chat)
--model <model>stringnoModel ID (default: qwen3.8-max)
--message <text>arraynoMessage text (repeatable, prefix role: to set role); or use --messages-file
--messages-file <path>stringnoJSON file with messages array (use - for stdin)
--system <text>stringnoSystem prompt
--max-tokens <n>numbernoMaximum tokens to generate (default: 4096)
--temperature <n>numbernoSampling temperature (0.0, 2.0]
--top-p <n>numbernoNucleus sampling threshold
--streamswitchnoStream response tokens (default: on in TTY)
--tool <json-or-path>arraynoTool definition as JSON or file path (repeatable)
--enable-thinkingswitchnoEnable thinking/reasoning mode (for qwen3/qwq models)
--thinking-budget <n>numbernoMax tokens for thinking (default: 4096)
--batchswitchnoSend a single synchronous Batch Chat request (non-streaming)
--primeswitchnoUse Prime mode with a workspace-scoped endpoint
--workspace-id <id>stringnoWorkspace ID for the default Prime endpoint (or set BAILIAN_WORKSPACE_ID)

Example: Send message asking What is Qwen?

bl text chat --message "What is Qwen?"

Example: Send a synchronous Batch Chat request

bl text chat --batch --model qwen-plus --message "Hello" --timeout 3600
  • --batch sends one synchronous Batch Chat request and forces non-streaming even in a TTY. It cannot be combined with --prime, --api responses, or --stream. --message or --messages-file supplies the conversation context for one request, not independent requests from a file.
  • Batch Chat total request timeout defaults to 300 seconds; --timeout must be 60–3600 seconds. For file-based batch inference, use batch create/get/download; create returns a task ID without waiting for completion.
  • --batch rejects explicitly specified realtime, international, or Token Plan endpoints; explicitly specified Batch or custom proxy URLs retain existing credentials. No automatic fallback or POST replay occurs.
  • Prime mode requires an explicit model and currently supports only the Chat Completions API.
  • Prime endpoint: configured --base-url, DASHSCOPE_BASE_URL, or profile base_url takes precedence; otherwise workspace is resolved from --workspace-id, BAILIAN_WORKSPACE_ID, then config workspace_id.

bl omni

Multimodal chat with text + audio output (Qwen-Omni). Requires API Key authentication.

Usage

bl omni --message <text> [flags]
ParameterTypeRequiredDescription
--message <text>arraynoMessage text (repeatable, prefix role: to set role)
--model <model>stringnoModel ID (default: qwen3.5-omni-plus)
--system <text>stringnoSystem prompt
--image <url>arraynoImage URL or local file (repeatable)
--audio <url>arraynoAudio URL or local file (.wav/.mp3/.amr/.aac/.m4a/.ogg/.3gp/.3gpp)
--video <url>arraynoVideo file URL / local path, or comma-separated frame URLs
--voice <voice>stringnoOutput voice ID (default: Tina). Use --list-voices to see all options
--list-voicesswitchnoList available output voices and exit
--audio-format <fmt>stringnoAudio output format (default: wav)
--audio-out <path>stringnoSave audio to file (default: auto-generate)
--text-onlyswitchnoOutput text only, no audio generation
--max-tokens <n>numbernoMaximum tokens to generate
--temperature <n>numbernoSampling temperature (0.0, 2.0]

Example: List available output voices for Qwen-Omni

bl omni --list-voices