Aliyun Model Studio CLI **The official command-line interface for Aliyun Model Studio (DashScope) AI Platform** [![npm version](https://img.shields.io/npm/v/bailian-cli?color=0969da&label=npm)](https://www.npmjs.com/package/bailian-cli) [![Node.js](https://img.shields.io/badge/node-%3E%3D22.12-brightgreen)](https://nodejs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org) [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE) [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README.zh.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key) --- _Chat with Qwen, generate images & videos, understand images, call agents,_ _manage memory, search the web — all from your terminal._ _Built for AI Agents. Every command works as a structured tool call._
## Features Equip your AI Agent out-of-the-box with these capabilities, composable across complex tasks: - **Text chat** — Qwen3.7-max: major gains in agentic coding, frontend coding, and vibe coding - **Multimodal (Omni)** — Full omni-modal support across text + image + audio + video - **Image generation & editing** — Qwen-Image 2.0: pro text rendering, photorealism, strong semantic adherence, multi-image composition - **Video generation & editing** — HappyHorse-1.0 series: text-/image-/reference-to-video and natural-language video editing (up to 9-image reference) - **Speech synthesis & recognition** — CosyVoice streaming TTS, voice cloning from 5–20s samples; FunAudio-ASR covers 30 languages including 7 Chinese dialects and 20+ Mandarin accents - **Image & video understanding** — Qwen-VL: long-form video analysis, chart/document parsing, visual reasoning, multilingual OCR > **Note:** The features below are currently available only to China site (aliyun.com) account holders and are not yet supported for international / global site accounts. - **Knowledge base & memory** — Multimodal RAG retrieval and cross-session memory for personalized, coherent dialogue - **App calls** — Invoke agents and workflows already published on Aliyun Model Studio - **MCP integration** — Orchestrate Bailian MCP servers: list services, inspect tools, and invoke any tool directly from the terminal - **Web search** — Real-time internet retrieval for up-to-date, accurate answers - **Model recommendation** — Describe your scenario and get best-fit model suggestions; supports scoped search, model comparison, and alternative discovery - **Console capabilities** — Browse Bailian apps (`app list`), check free-tier quota (`usage free`), view model usage statistics (`usage stats`), manage workspaces (`workspace list`), and manage rate limits (`quota list/request/check/history`) - **Local file auto-upload** — Every URL parameter accepts a local path; uploaded to free temp storage with 48-hour validity ## Showcase: One-Sentence Cinematic Video

Click to play the demo video

👆 Click the cover to play the full 2-minute demo

A complete **2-minute, 16:9 cinematic short film** — produced end-to-end from a single natural-language sentence, with **zero manual editing**. This showcase demonstrates how an AI Agent can compose a multi-step creative pipeline by orchestrating three primitives: - **[Qwen Code](https://github.com/QwenLM/qwen-code)** — the agentic coding model that interprets the user's intent and drives the workflow - **[Aliyun Model Studio CLI](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)** — invokes **HappyHorse 1.0**, Aliyun Model Studio's text-/image-/reference-to-video generation model - **[spark-video Skill](https://github.com/JohnKeating1997/spark-video)** — handles scene decomposition, storyboarding, shot continuity, and final stitching ### The single prompt > _"Generate a roughly 2-minute video in Japanese cinematic style — a sweet, innocent first-love story about a high-school girl. The plot should be heart-fluttering enough to make viewers want to fall in love. Aspect ratio: 16:9."_ > > _(Original: "帮我生成一段日系影视风格，高中女生的青涩初恋故事，剧情高甜，让人看了想谈恋爱，2分钟左右的视频，尺寸是16:9")_ ### How it works 1. **Qwen Code** parses the request, plans the narrative beats, and decides which tools to call. 2. The **spark-video Skill** breaks the story into shots, writes per-shot prompts, and enforces visual continuity (characters, lighting, palette, lens language). 3. **`bl video generate`** dispatches each shot to **HappyHorse 1.0** in parallel. 4. The skill stitches all clips back together into a single 16:9 / ~2-min deliverable. No timeline scrubbing. No frame-by-frame editing. Just one sentence → one video. ## Installation ```bash npm install -g bailian-cli npx skills add modelstudioai/cli --all -g ``` > Requires Node.js >= 22.12. ## Quick Start ```bash # Authenticate, recommended bl auth login --console # Or authenticate with an API key bl auth login --api-key sk-xxxxx # Chat with Qwen bl text chat --message "What is DashScope?" # Multimodal chat (text + image + audio + video) bl omni --message "Describe this image" --image ./photo.jpg # Generate an image bl image generate --prompt "A cat in a spacesuit" --out-dir ./images/ # Generate a video from local image bl video generate --image ./cat.png --prompt "Make the cat move" --download cat.mp4 # Model recommendation — find the best model for your use case bl advisor recommend --message "I need a visual-understanding chatbot" # Compare specific models bl advisor recommend --message "qwen-max vs deepseek-v3 for code generation" # Browser login (required for console capability commands) bl auth login --console # Browse apps / free-tier quota / usage statistics / workspaces bl app list bl usage free --model qwen3-max bl usage free --expiring 30 # Quotas expiring within 30 days bl usage free --sort remaining # Sort by remaining % ascending bl usage stats --workspace-id # Usage overview for a workspace bl usage stats --model qwen-turbo --workspace-id # Per-model usage bl workspace list # List all workspaces # Rate limit management bl quota list # View RPM/TPM limits for all models bl quota list --model qwen3.6-plus # View limits for a specific model bl quota check # Current usage vs rate limits bl quota check --model qwen3.6-plus --period 5 # Check usage over last 5 minutes bl quota request --model qwen3.6-plus --tpm 6000000 # Request a temporary TPM increase bl quota history # View quota change history ``` > More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) ## Authentication ### DashScope API Key Required for most commands. Get your key from the [DashScope Console](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key). ```bash # Option 1: Environment variable export DASHSCOPE_API_KEY=sk-xxxxx # Option 2: Login command (persisted to ~/.bailian/config.json) bl auth login --api-key sk-xxxxx # Option 3: Per-command flag bl text chat --api-key sk-xxxxx --message "Hello" ``` ### Console Login (OAuth) Required for console capability commands (`app list`, `usage free`, `usage stats`, `workspace list`, `quota list/request/check/history`). Opens the Bailian console in your browser to sign in. ```bash bl auth login --console ``` ## Configuration ```bash # View current config bl config show # Set defaults bl config set --key base_url --value https://dashscope-us.aliyuncs.com bl config set --key default_text_model --value qwen-turbo bl config set --key timeout --value 600 # Self-update to latest version bl update ``` Config file location: `~/.bailian/config.json` ## Links | Resource | URL | | :--------------------------- | :---------------------------------------------------------------------------------------- | | Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& | | DashScope API Docs | https://help.aliyun.com/zh/model-studio/ | | Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models | | Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github | | Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key | | Get AccessKey | https://ram.console.aliyun.com/manage/ak | ## Changelog Release notes for every version live in [CHANGELOG.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG.md). ## Contributing Bug reports, feature requests, and PRs are welcome. See [CONTRIBUTING.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING.md) for developer setup, repo layout, and the workflow for adding or changing commands.