阿里云百炼 (DashScope) AI 平台命令行工具
阿里云百炼 CLI 官方主页 · English · API 文档 · 获取 API Key
千问对话、图像生成与编辑、视频生成与编辑、图像理解、语音合成与识别、 应用调用、记忆管理、知识检索、联网搜索 — 一行命令，触达所有 AI 能力。
专为 AI Agent 打造，每个命令均可作为结构化工具调用。
- 模型生成 — 文本、图像、视频、语音全模态生成，支持编辑与参考生成
- 素材理解 — 图像、文档、音频、长视频的解析与问答
- 应用编排 — 调用百炼已发布的 Managed Agent、智能体和工作流，接入知识库、记忆库、联网搜索与 MCP 工具
- 原生 MCP 接入 — 将百炼 MCP 服务注册到 Codex、Claude Code、Cursor、Qoder、Qoder Work、千问办公（QwenWork）、Qwen Code 或 Gemini CLI，并保留渠道归因
- 模型训推 — 数据集校验上传、模型精调、专属模型部署上线
- 账号运维 — 授权登录、界面化配置、模型市场、用量与额度、限流提额、团队席位管理
- 套餐接入 — 支持 Token Plan 等订阅计划一键接到 CLI 和常见 Coding Agent
注意： 应用编排、原生 MCP 接入、模型训推、账号运维和套餐接入目前仅支持中国站（aliyun.com）账号，暂不支持国际站 / 全球站账号。
👆 点击封面播放完整 2 分钟演示
一部完整的 2 分钟、16:9 电影感短片 —— 由一句自然语言端到端生成，全程零手动剪辑。这个示例展示了 AI Agent 如何把三个基础能力编排成一条多步创作流水线：
- Qwen Code —— Agentic coding 模型，解析用户意图、驱动整个工作流
- 阿里云百炼 CLI —— 调用 HappyHorse 1.1，百炼的文生/图生/参考生视频模型
- spark-video Skill —— 负责场景拆分、分镜设计、镜头连贯性和最终拼接
“帮我生成一段日系影视风格，高中女生的青涩初恋故事，剧情高甜，让人看了想谈恋爱，2 分钟左右的视频，尺寸是 16:9。”
👆 点击封面播放完整演示
一句话构建一个可复用的云端短片导演，用于分镜设计、分镜图生成和视频创作：
- Qwen Code —— 理解需求并生成 Agent 配置
- 阿里云百炼 CLI —— 校验配置、预览变更并完成部署
- Managed Agent —— 在云端运行导演角色及其 Skill 和工具
“帮我构建一个 managedagent 应用，能够实现短片拍摄，导演专家生成视频，然后也能进行设计对应的分镜图。”
Agent 安装（推荐）
把下面这句话发给你的 Agent，它会自行判断环境并完成安装与校验：
请阅读：https://bailian.aliyun.com/cli/install.md 并按照说明为我安装阿里云百炼 CLI
NPM 安装
npm install -g bailian-cli
bl skill init需要预先安装 Node.js >= 18.17。
macOS/Linux 安装
curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash无需预先安装 Node.js，安装脚本会自动安装 Bailian Skills。
Windows 安装
irm https://bailian.aliyun.com/cli/install.ps1 | iex无需预先安装 Node.js，安装脚本会自动安装 Bailian Skills。
安装完成后，直接在 AI Agent 中描述你的任务，无需手动拼接命令。
| 场景 | 可以这样对 Agent 说 |
|---|---|
| Managed Agent | “帮我创建一个能够生成短片分镜和视频的 Managed Agent。” |
| 图片和视频生成 | “生成一张穿着太空服的猫站在火星上的图片，再把它制作成一段视频。” |
| 语音识别 | “把这段音频转写成文字，专有名词识别不准的话帮我加上热词再试。” |
| 用量与额度 | “查看最近的模型用量、免费额度和限流情况。” |
| 监控与告警 | “查看我的模型调用统计、失败明细和调用日志，并创建一条告警规则。” |
| 吞吐预留 | “查看我的吞吐预留及容量实例，并对容量进行扩缩、续订或释放，再等待操作完成。” |
| 模型选型 | “推荐一个适合图片理解和智能客服的模型。” |
| 了解 Bailian CLI | “介绍一下 Bailian CLI 能帮我完成哪些任务，并根据我的需求推荐使用方式。” |
更多案例与使用场景：阿里云百炼 CLI 官方主页
控制台能力命令（模型列表、应用列表、MCP 列表、工作空间、用量查询、限流提额、控制台直调）需要使用此登录方式，并可在需要时创建普通 API Key。Token Plan 等订阅计划不能使用 --console，请使用下面的 API Key 登录方式。
bl auth login --console国际站请使用 --console-site international。
使用已有的普通 API Key 或 Token Plan 订阅 Key，都执行同一条命令：
bl auth login --api-key <API_KEY>普通 Key 前往 DashScope 控制台 获取，Token Plan Key 前往 订阅详情 获取。
Token Plan 的席位与成员管理需要阿里云 AccessKey。前往 RAM 控制台 获取。
建议：创建 RAM 子账号并授予最小权限，避免使用主账号 AK/SK。
bl auth login --open-api --access-key-id LTAI5t... --access-key-secret ...# 查看当前配置
bl config show
# 查看全部配置档
bl config list
# 切换配置档
bl config use --name token-plan
# 将 CLI 界面切换为中文
bl config set --key language --value zh-CN配置文件位置：~/.bailian/config.json
bl update升级 CLI 至最新版本，并同步更新已安装的 Agent Skills。每个版本的变更详情记录在 CHANGELOG.zh.md。
欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 CONTRIBUTING.zh.md。
欢迎扫码加入阿里云百炼 CLI 钉钉用户交流群，获取使用答疑、问题排查、Bug 反馈和使用经验交流支持。
