mirror of
https://github.com/modelstudioai/cli.git
synced 2026-09-14 19:49:23 +08:00
lisheng.lisheng
241 lines
12 KiB
Markdown
241 lines
12 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" />
|
||
|
||
**阿里云百炼 (DashScope) AI 平台命令行工具**
|
||
|
||
[](https://www.npmjs.com/package/bailian-cli)
|
||
[](https://nodejs.org)
|
||
[](https://www.typescriptlang.org)
|
||
[](LICENSE)
|
||
|
||
[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [English](https://github.com/modelstudioai/cli/blob/main/README.md) · [API 文档](https://help.aliyun.com/zh/model-studio/) · [获取 API Key](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key)
|
||
|
||
---
|
||
|
||
_千问对话、图像生成与编辑、视频生成与编辑、图像理解、语音合成与识别、_
|
||
_应用调用、记忆管理、知识检索、联网搜索 — 一行命令，触达所有 AI 能力。_
|
||
|
||
_专为 AI Agent 打造，每个命令均可作为结构化工具调用。_
|
||
|
||
</div>
|
||
|
||
## 功能特性
|
||
|
||
让您的 AI Agent 开箱即具备以下能力，并可在复杂任务中自动组合调用：
|
||
|
||
- **文本对话** — Qwen3.7-max：Agentic coding、前端编程、Vibe coding 等能力显著增强
|
||
- **全模态对话** — 文本 + 图像 + 音频 + 视频全模态支持
|
||
- **图像生成与编辑** — Qwen-Image 2.0：专业文字渲染、真实质感、强语义遵循、多图合成
|
||
- **视频生成与编辑** — happyhorse-1.1 系列，支持文生 / 图生 / 参考生（最多 9 张图参考）/ 自然语言视频编辑
|
||
- **语音合成与识别** — CosyVoice 实时流式合成，5-20s 样本即可克隆；FunAudio-ASR 覆盖 30 种语种，含汉语七大方言与 20+ 口音官话
|
||
- **图像与视频理解** — Qwen-VL：长视频解析、复杂图表与文档识别、视觉推理、多语种 OCR
|
||
- **Coding Agent 配置** — 使用 `bl config agent` 将 Claude Code、Qwen Code、OpenCode、OpenClaw、Hermes Agent 或 Codex 配置为使用 DashScope
|
||
|
||
> **注意：** 以下功能目前仅对中国站（aliyun.com）账号开放，国际站 / 全球站账号暂不支持。
|
||
|
||
- **知识库与记忆库** — 多模态 RAG 检索 + 跨会话记忆，提供个性化连贯对话体验
|
||
- **应用调用** — 调用已发布在阿里云百炼平台上的智能体与工作流应用
|
||
- **MCP 集成** — 统一调度百炼 MCP 服务：列出服务、查看工具、直接在终端调用任意工具
|
||
- **联网搜索** — 实时互联网信息检索，提升回答准确性及时效性
|
||
- **模型推荐** — 描述你的场景，智能推荐最适合的模型；支持限定范围搜索、模型对比和替代发现
|
||
- **微调与部署** — 上传数据集、创建文本/音频/图像调优任务（`finetune text|audio|image create`；文本涵盖 SFT/LoRA/DPO/CPT）、非阻塞探测任务状态（`finetune watch`）、按模型查训练能力（`finetune capability`），并把训练好的模型部署为推理服务（`deploy text|audio|image create`）
|
||
- **控制台能力** — 浏览模型市场（`model list`）和百炼应用（`app list`），查看统一用量视图（`usage summary`），查询模型免费额度（`usage free`），查看模型用量统计（`usage stats`），管理业务空间（`workspace list`），管理限流与提额（`quota list/request/check/history`）
|
||
- **本地文件自动上传** — 所有 URL 参数同时支持本地路径，免费临时存储 48 小时
|
||
|
||
## 示例:一句话生成一部电影短片
|
||
|
||
<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="点击播放演示视频" width="720" />
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center"><i>👆 点击封面播放完整 2 分钟演示</i></p>
|
||
|
||
一部完整的 **2 分钟、16:9 电影感短片** —— 由一句自然语言端到端生成,**全程零手动剪辑**。这个示例展示了 AI Agent 如何把三个基础能力编排成一条多步创作流水线:
|
||
|
||
- **[Qwen Code](https://github.com/QwenLM/qwen-code)** —— Agentic coding 模型,解析用户意图、驱动整个工作流
|
||
- **[阿里云百炼 CLI](https://github.com/modelstudioai/cli/)** —— 调用 **HappyHorse 1.1**,百炼的文生/图生/参考生视频模型
|
||
- **[spark-video Skill](https://github.com/JohnKeating1997/spark-video)** —— 负责场景拆分、分镜设计、镜头连贯性和最终拼接
|
||
|
||
### 唯一的提示词
|
||
|
||
> _"帮我生成一段日系影视风格,高中女生的青涩初恋故事,剧情高甜,让人看了想谈恋爱,2 分钟左右的视频,尺寸是 16:9"_
|
||
|
||
### 工作流程
|
||
|
||
1. **Qwen Code** 解析需求、规划叙事节奏,决定要调用哪些工具。
|
||
2. **spark-video Skill** 把故事拆成镜头、为每个镜头写提示词,并保证视觉连贯性(角色、光线、色调、镜头语言)。
|
||
3. **`bl video generate`** 把每个镜头并行下发给 **HappyHorse 1.1**。
|
||
4. Skill 把所有片段拼成最终的 16:9 / 约 2 分钟成片。
|
||
|
||
没有时间线拖拽,没有逐帧剪辑。一句话 → 一部短片。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
npm install -g bailian-cli
|
||
npx skills add modelstudioai/cli --all -g
|
||
```
|
||
|
||
> 需要预先安装 Node.js >= 22.12。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 认证（推荐浏览器登录）
|
||
bl auth login --console
|
||
|
||
# 或使用 API key 认证
|
||
bl auth login --api-key sk-xxxxx
|
||
|
||
# 或使用 Token Plan（已内置 Base URL，登录时自动测试 Key）
|
||
bl auth login --config token-plan --api-key sk-sp-xxxxx
|
||
|
||
# 配置 Coding Agent 使用 DashScope
|
||
bl config agent --agent codex --base-url https://dashscope.aliyuncs.com/compatible-mode/v1 --api-key sk-xxxxx --model qwen3-coder-plus
|
||
|
||
# 和通义千问对话
|
||
bl text chat --message "你好，介绍一下阿里云百炼平台"
|
||
|
||
# 多模态对话（文本 + 图片 + 音频 + 视频）
|
||
bl omni --message "描述这张图片" --image ./photo.jpg
|
||
|
||
# 生成图片
|
||
bl image generate --prompt "一只穿太空服的猫在火星上" --out-dir ./images/
|
||
|
||
# 图生视频（本地文件自动上传）
|
||
bl video generate --image ./cat.png --prompt "让画面中的猫动起来" --download cat.mp4
|
||
|
||
# 模型推荐 — 根据场景推荐最适合的模型
|
||
bl advisor recommend --message "我要做一个能理解图片的客服机器人"
|
||
|
||
# 对比特定模型
|
||
bl advisor recommend --message "qwen-max 和 deepseek-v3 哪个更适合做代码生成"
|
||
|
||
# 浏览器登录（控制台能力相关命令需要）
|
||
bl auth login --console
|
||
|
||
# 微调与部署 — 从训练到服务的一站式流程
|
||
bl dataset upload --file ./train.jsonl # 上传 .jsonl 数据集（先校验）
|
||
bl finetune text create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora # 本地路径自动上传
|
||
bl finetune watch --job-id ft-xxx --output json # 非阻塞探测（运行中/成功返回 0；失败/取消报错）
|
||
bl finetune capability --model qwen3-8b # 查询模型支持哪些训练方式
|
||
bl deploy text create --model qwen3-8b --name my-svc --plan mu # 把训练好的模型部署为推理服务
|
||
|
||
# 浏览模型 / 应用 / 免费额度 / 用量统计 / 业务空间
|
||
bl model list # 浏览模型系列与价格信息
|
||
bl app list
|
||
bl usage summary # 统一视图：免费额度 + 近期用量概览
|
||
bl usage free # 各模型免费额度（可加 --model/--expiring/--sort）
|
||
bl usage stats --workspace-id <id> # 模型用量统计（加 --model 查单模型）
|
||
bl workspace list # 列出所有业务空间
|
||
|
||
# 限流管理与提额（list / check / request / history）
|
||
bl quota list # 查看 RPM/TPM 限额（加 --model 过滤）
|
||
bl quota check # 当前用量 vs 限流阈值（加 --model/--period）
|
||
bl quota request --model qwen3.6-plus --tpm 6000000 # 申请临时 TPM 提额
|
||
bl quota history # 查看提额历史记录
|
||
|
||
# Token Plan 团队版管理（需 AK/SK，见下方认证说明）
|
||
bl token-plan list-seats # 查看订阅席位明细
|
||
bl token-plan add-member --account-name dev --org-id org_xxx
|
||
bl token-plan assign-seats --workspace-id ws_xxx --seat-type standard --account-id acc_xxx
|
||
bl token-plan create-key --account-id acc_xxx --workspace-id ws_xxx
|
||
```
|
||
|
||
> 更多案例与使用场景：[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
|
||
|
||
## 认证方式
|
||
|
||
### DashScope API Key
|
||
|
||
大部分命令均需要 API Key。前往 [DashScope 控制台](https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key) 获取。
|
||
|
||
```bash
|
||
# 方式一：环境变量
|
||
export DASHSCOPE_API_KEY=sk-xxxxx
|
||
|
||
# 方式二：登录命令（持久化到 ~/.bailian/config.json）
|
||
bl auth login --api-key sk-xxxxx
|
||
|
||
# 方式三：命令行参数
|
||
bl text chat --api-key sk-xxxxx --message "你好"
|
||
```
|
||
|
||
### Token Plan API Key
|
||
|
||
前往 [Token Plan 订阅详情](https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview) 获取或复制 API Key。
|
||
CLI 已内置 Token Plan 的默认 Base URL；登录命令会先测试 Key，通过后才保存并激活 `token-plan` 配置。
|
||
|
||
```bash
|
||
bl auth login --config token-plan --api-key sk-sp-xxxxx
|
||
```
|
||
|
||
### 控制台登录（OAuth）
|
||
|
||
控制台能力命令（`model list`、`app list`、`usage summary/free/stats`、`workspace list`、`quota list/request/check/history`）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。
|
||
|
||
```bash
|
||
bl auth login --console
|
||
```
|
||
|
||
### 阿里云 OpenAPI AK/SK（仅 Token Plan）
|
||
|
||
`token-plan` 命令组需要阿里云 AccessKey。前往 [RAM 控制台](https://ram.console.aliyun.com/manage/ak) 获取。
|
||
|
||
> 建议：创建 RAM 子账号并授予最小权限，避免使用主账号 AK/SK。
|
||
|
||
```bash
|
||
# 方式一：登录命令（持久化到 ~/.bailian/config.json）
|
||
bl auth login --open-api --access-key-id LTAI5t... --access-key-secret ...
|
||
|
||
# 方式二：环境变量
|
||
export ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI5t...
|
||
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=...
|
||
export BAILIAN_WORKSPACE_ID=ws-...
|
||
```
|
||
|
||
## 配置
|
||
|
||
```bash
|
||
# 查看当前配置
|
||
bl config show
|
||
|
||
# 设置默认值
|
||
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
|
||
|
||
# 一键配置编程 Agent（Claude Code、Qwen Code、OpenCode、OpenClaw、Hermes、Codex）接入百炼
|
||
bl config agent --agent claude-code \
|
||
--base-url https://dashscope.aliyuncs.com/apps/anthropic \
|
||
--api-key sk-xxxxx --model qwen3-max
|
||
|
||
# 自更新到最新版本
|
||
bl update
|
||
```
|
||
|
||
配置文件位置：`~/.bailian/config.json`
|
||
|
||
## 相关链接
|
||
|
||
| 资源 | 地址 |
|
||
| :---------------------- | :---------------------------------------------------------------------------------------- |
|
||
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
|
||
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
|
||
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
|
||
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
|
||
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
|
||
| 获取 Token Plan API Key | https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview |
|
||
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
|
||
|
||
## 更新日志
|
||
|
||
每个版本的变更详情记录在 [CHANGELOG.zh.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG.zh.md)。
|
||
|
||
## 参与贡献
|
||
|
||
欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 [CONTRIBUTING.zh.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING.zh.md)。
|