阿里云百炼CLI安装与配置教程参考：调用 CLI，让AI Agent自动调度10+项模型应用能力

阿里云百炼 CLI 是阿里云百炼平台专为 AI Agent 打造的命令行工具。只需一行安装指令并完成认证，即可将百炼平台的 AI 能力集成至各类 AI 工具中。让 AI Agent 自动调度 10+ 项模型应用能力，交付电商图、视频、播客等专业级场景产出。更多阿里云百炼平台知识可参考：https://www.aliyun.com/product/bailian

一、3 步完成接入 CLI

第一步：安装 CLI
复制下面的内容，告诉您的 AI Agent 阅读安装文档后，能够自动装好阿里云百炼 CLI。

请阅读：https://bailian.aliyun.com/cli/install.md 并按照说明为我安装阿里云百炼 CLI

第二步：鉴权配置
方式一：快捷登录
复制命令给 Agent 后自动完成鉴权信息配置。

帮我执行 bl auth login --console 控制台登录

方式二：API Key 配置
获取 API Key ，然后把 Key 告诉 Agent 完成配置。

API Key 是：sk-xxxxxxxxxxxx

第三步：开始使用
完成 1、2 步骤后，给您的 Agent 下发需求即可调度 CLI 能力进行产出，尝试给 Agent 发送第一个示例：

帮我生成一套电商主图，6 张图，产品是纯黑色夏日男装 T 恤

二、安装与配置

2.1 安装

说明前置要求：Node.js ≥ 22.12.0。百炼 CLI 仅支持通过 npm 安装。

方式一：在 AI Agent 中安装（推荐）

在 AI Agent 中告诉 Agent：

请阅读 https://bailian.aliyun.com/cli/install.md 并按照说明为我安装阿里云百炼 CLI

方式二：手动安装

# 第 1 步：安装 CLI
npm install -g bailian-cli

# 第 2 步：安装 Skills（将百炼能力描述文件注册到各 Agent 的 Skills 目录）
npx skills add modelstudioai/cli --all -g

# 第 3 步：验证安装
bl --version

2.2 认证与配置

使用百炼 CLI 前，您需要完成身份认证。支持以下认证方式：

控制台登录和 API Key 可同时配置，互不覆盖。

说明如果您通过控制台登录后，执行 bl text chat 等模型调用命令时仍提示"缺少 API Key"，请先运行 bl update 升级到最新版本。若升级后问题仍然存在，请单独配置 API Key：bl auth login --api-key <your-key>。

认证完成后，您可以通过 bl config 设置模型、输出目录等参数：

# 查看当前配置
bl config show

# 设置默认文本模型
bl config set --key default-text-model --value qwen3.7-max

# 设置输出目录
bl config set --key output_dir --value ~/bailian-output

常用全局参数

百炼 CLI 兼容 Claude Code、Cursor、Codex、Qwen Code 等主流 AI 工具和框架。完整兼容列表和集成方式，请参见百炼 CLI GitHub 仓库。

三、场景实战

3.1 电商套图生成

告诉 Agent：

帮我生成一套亚马逊电商主图，6 张图，产品是纯黑色夏日男装 T 恤

Agent 会组合多个命令完成任务：

1. 生成 6 张产品主图：

 bl image generate --prompt "纯黑色夏日男装T恤，白色背景，亚马逊电商主图风格" --n 6 --out-dir ./ecommerce/

1. 如需调整某张图：

 bl image edit --image ./ecommerce/image_01.png --prompt "添加模特穿着效果"

1. 如需生成产品展示视频：

 bl video generate --image ./ecommerce/image_01.png --prompt "T恤360度旋转展示" --download tshirt-demo.mp4

3.2 新闻播客生成

告诉 Agent：

搜索今天关于 AI 的新闻，写一段相声，然后生成男女音色区分的音频播客

Agent 会依次执行：

1. 联网搜索获取新闻素材：

 bl search web --query "今天AI新闻"

1. 用大模型撰写相声稿本：

 bl text chat --message "根据以下新闻素材，写一段相声..."

1. 分角色生成音频：

 bl speech synthesize --text "甲：您听说了吗..." --voice Ethan --out host_male.mp3
 bl speech synthesize --text "乙：怎么了？..." --voice Cherry --out host_female.mp3

1. 用 ffmpeg 合并音频片段为完整播客。

3.3 故事书生成

告诉 Agent：

帮我生成一部小红帽的故事书，真人写实版本，保持人物连续一致性，需要有 20 页，尺寸是 16:9 的，变成 PDF 给我

Agent 会自动完成：为每页生成故事文字 → 根据文字生成风格一致的配图 → 排版并输出 PDF。

四、命令参考

4.1 文本对话

bl text chat

发送文本对话请求，兼容 OpenAI 接口格式。

bl text chat --message <text> [flags]

4.2 全模态理解

bl omni

全模态对话，支持图片、音频、视频输入，文本和语音输出。

bl omni --message <text> [flags]

4.3 图像生成与编辑

bl image generate

文字生成图像。

bl image generate --prompt <text> [flags]

bl image edit

编辑已有图像，支持多图合成。

bl image edit --image <url> --prompt <text> [flags]

4.4 视频生成与编辑

bl video generate

文字或图片生成视频。

bl video generate --prompt <text> [--image <url>] [flags]

bl video edit

编辑视频，支持风格转换、对象替换等。

bl video edit --video <url> --prompt <text> [flags]

bl video ref

多图参考生成视频，支持多主体、多镜头、配音。

bl video ref --prompt <text> --image <url>... [flags]

bl video task get

查询异步视频任务的状态。

bl video task get --task-id <id>

bl video download

按任务 ID 下载已完成的视频。

bl video download --task-id <id> --out <path>

4.5 视觉理解

bl vision describe

使用视觉模型描述图片或视频内容。

bl vision describe --image <path-or-url> [flags]

4.6 语音合成与识别

bl speech synthesize

文字转语音（TTS）。

bl speech synthesize --text <text> [flags]

bl speech recognize

语音转文字（ASR）。

bl speech recognize --url <audio-url> [flags]

4.7 联网搜索

bl search web

联网搜索。

bl search web --query <text> [flags]

4.8 应用与数据

bl app call

调用百炼应用（智能体或工作流）。

bl app call --app-id <id> --prompt <text> [flags]

bl app list

列出百炼应用。

bl app list [flags]

bl memory add

添加记忆。

bl memory add --user-id <id> [flags]

bl memory search

搜索记忆。

bl memory search --user-id <id> [flags]

bl memory list

列出记忆。

bl memory list --user-id <id> [flags]

bl knowledge retrieve

从百炼知识库检索（需要 AccessKey 认证）。

bl knowledge retrieve --index-id <id> --query <text> [flags]

五、开发辅助

bl file upload

上传本地文件到 DashScope 临时存储（48 小时有效）。

bl file upload --file <path> --model <model>

bl usage free

查询模型免费额度。

bl usage free --model <model> [flags]

bl mcp list

列出已激活的 MCP 服务。

bl mcp list [flags]

bl pipeline run

运行流水线工作流。

bl pipeline run <file> [flags]

bl advisor recommend

根据需求推荐最佳模型。

bl advisor recommend <prompt> [flags]

六、常见问题

Q：安装失败怎么办？

确认 Node.js 版本 ≥ 22.12.0 且使用 npm 安装（不支持 pnpm/yarn）：

node --version
npm install -g bailian-cli
npx skills add modelstudioai/cli --all -g

Q：提示认证失败？

检查 API Key 是否正确配置：

bl auth status

如需重新配置：

bl auth logout
bl auth login --api-key sk-xxx
# 或拉起浏览器登录
bl auth login --console

Q：本地文件可以直接用吗？

可以。直接把文件路径传给 Agent 即可，CLI 会自动上传到临时存储（48 小时有效）：

帮我把 ./photo.png 改成水彩风格
帮我识别 ./meeting.wav 这段录音
描述一下 ./demo.mp4 这个视频的内容

Q：如何查看命令的完整参数？

告诉 Agent “看一下 bl image generate 有哪些参数”，或直接运行：

bl <命令> --help

2026年阿里云AI产品与云产品优惠权益参考：
AI 产品权益主要包括智启 AI 普惠权益，至高享 1亿+免费 tokens，加速 Al 应用落地；Token Plan 模型订阅计划，Qwen3.8-Max 首发尝鲜，限时加量 10 倍，夜间低至2折；千问办公，限时限量积分加倍，你的AI工作搭子，覆盖日常办公高频场景；万小智 AI 建站低至 15元/月，送.CN域名，送备案服务码；Night Plan 支持 Qwen 3.8-Max，夜间 5 折，Qwen/Meoo/TokenPlan 客户专享。而云产品权益主要有轻量应用服务器限时抢购2核2G38元/年；经济型e实例3.9折，通用算力型u2i实例3折，九代c9i、g9i、r9i等实例1年付6.4折起等优惠权益。详情可通过阿里云权益中心了解：https://www.aliyun.com/benefit

综上所述，阿里云百炼CLI通过极简的三步接入流程（安装、鉴权、使用），将平台强大的多模态AI能力无缝集成至主流的AI Agent工具生态中，赋能开发者一键调度图像生成与编辑、全模态理解、语音合成与识别、联网搜索等10余项模型能力，高效交付电商套图、新闻播客、故事书等复杂业务场景的专业级产出。这套命令行工具不仅兼容Claude Code、Cursor等主流开发环境，还提供了覆盖文本、图像、视频、语音的全链路API支持与详尽的参数指引，显著降低了多模态AI应用的门槛与开发周期，让开发者能更专注于业务创新而非底层技术集成，是加速AI Agent落地的得力助手。