mirror of
https://github.com/modelstudioai/cli.git
synced 2026-09-14 19:49:23 +08:00
若麒
2f9558c161
AK/SK signing was used only by `knowledge retrieve`'s deprecated fallback, which the api-key auth gate now makes unreachable. Drop it; the command is pure api-key. - knowledge/retrieve: remove the AK/SK path + --access-key-id/secret/workspace-id flags; api-key only - delete client/ak-sign.ts and its signRequest/AkSignConfig exports - drop access_key_id/access_key_secret from config schema, loader, and `config show` / `config set` - remove the now-unused PascalCase KnowledgeRetrieve request/response types
194 lines
9.8 KiB
Markdown
194 lines
9.8 KiB
Markdown
<div align="center">
|
||
|
||
<img src="https://img.alicdn.com/imgextra/i1/O1CN01kGgO3z1N30OINgUoG_!!6000000001513-2-tps-1915-821.png" alt="Aliyun Model Studio CLI" />
|
||
|
||
**The official command-line interface for Aliyun Model Studio (DashScope) AI Platform**
|
||
|
||
[](https://www.npmjs.com/package/bailian-cli)
|
||
[](https://nodejs.org)
|
||
[](https://www.typescriptlang.org)
|
||
[](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._
|
||
|
||
</div>
|
||
|
||
## 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
|
||
|
||
<p align="center">
|
||
<a href="https://cloud.video.taobao.com/vod/dS2F4huqbw5Nfe5L3wwb3grz2q2DNYD3retq8dU-iHo.mp4">
|
||
<img src="https://img.alicdn.com/imgextra/i1/O1CN01Q5052k232Hd36NodG_!!6000000007197-0-tps-2940-1656.jpg" alt="Click to play the demo video" width="720" />
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center"><i>👆 Click the cover to play the full 2-minute demo</i></p>
|
||
|
||
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 <id> # Usage overview for a workspace
|
||
bl usage stats --model qwen-turbo --workspace-id <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.
|