在AI智能体(Agent)成为主流应用形态的当下,开发者与企业迫切需要一套轻量化、统一化、可脚本化的工具,让AI Agent能高效调用各类大模型与多模态能力,无需在不同平台、不同接口间反复切换。阿里云百炼CLI(命令行工具)正是为此而生,它将百炼平台的150+多模态模型、10+类AI应用服务、知识库、记忆管理、联网搜索等核心能力,封装为一套简洁、一致的命令行接口,让Agent只需一行命令,即可完成从文本生成、图像创作、视频制作到语音处理、知识检索的全链路AI操作。百炼CLI以“Agent原生”为设计核心,原生兼容主流AI Agent框架,支持跨平台运行,彻底打通AI能力调用的最后一公里,成为开发者构建智能体、实现AI自动化工作流的核心基础设施。
一、产品定位与核心价值:Agent的“全能工具箱”
阿里云百炼CLI是专为AI智能体打造的开源命令行工具,核心定位是成为AI Agent的“全能工具箱”与“通用创作协议”,其核心价值体现在三个层面:
- 统一入口,全模态覆盖:将百炼平台分散的文本、图像、视频、语音、全模态交互等能力,统一封装为
bl命令前缀,一条命令即可调用10+类AI能力,无需切换多个工具,大幅降低Agent调用AI能力的复杂度。 - Agent原生,开箱即用:从设计之初就面向AI Agent优化,原生支持Claude Code、Qoder、OpenClaw、Hermes Agent等主流Agent框架,Agent可直接理解并执行百炼CLI命令,无需额外开发适配代码,真正实现“安装即集成”。
- 开源开放,灵活扩展:百炼CLI已在GitHub开源,支持自定义扩展能力,开发者可基于CLI框架添加自定义技能(Skills),适配个性化业务场景,同时无缝对接阿里云百炼平台的持续能力升级。
百炼CLI彻底改变了传统AI能力调用的模式,让AI从“被动响应”迈向“主动执行”,从“单一能力”迈向“全栈协同”,为智能体时代的AI应用开发提供了全新的技术底座。详情👉访问阿里云百炼 CLI 页面 或
详情👉访问阿里云百炼大模型服务平台页面 了解

二、核心架构与技术特性:轻量、统一、可扩展
百炼CLI采用“核心引擎+技能插件+统一鉴权+跨平台兼容”的四层架构设计,确保工具的轻量性、灵活性与稳定性:
- 核心引擎层:提供命令解析、参数校验、鉴权管理、结果输出等基础能力,是整个CLI的运行核心,体积轻量、启动快速,支持跨Windows、macOS、Linux平台运行。
- 技能插件层(Skills):将各类AI能力封装为独立的技能插件(如文本生成、图像生成、视频制作等),每个技能对应一组命令,支持按需安装、动态扩展,避免冗余能力占用资源。
- 统一鉴权层:基于阿里云百炼API Key实现统一鉴权,一次配置即可永久生效,支持Token Plan、Coding Plan、按量计费等多种计费模式,确保调用安全与成本可控。
- 跨平台兼容层:基于Node.js开发,仅需Node.js ≥18即可运行,无需依赖复杂环境,支持在本地终端、服务器、容器等多种环境中部署,适配各类开发与生产场景。
技术特性上,百炼CLI具备三大核心优势:
- 极简命令:所有命令遵循
bl <能力模块> <子命令> [参数]的统一格式,记忆成本低,上手速度快。 - 结果可脚本化:支持JSON、文本、文件等多种输出格式,命令结果可直接被脚本捕获、处理,实现AI工作流的全自动化。
- 能力协同:支持多命令链式调用,Agent可自动组合不同AI能力完成复杂任务(如“生成文案→生成配图→制作视频→合成语音”),无需人工干预。
三、核心功能模块:全栈AI能力,一行命令触达
百炼CLI整合了百炼平台的核心能力,形成模型服务、多模态生成、数据管理、Agent增强四大功能模块,覆盖AI应用开发的全场景需求。详情👉访问阿里云百炼 CLI 页面 或
详情👉访问阿里云百炼大模型服务平台页面 了解

(一)模型服务模块:150+模型,一键调用
模型服务是百炼CLI的核心基础,支持调用百炼平台的150+大模型,涵盖文本、视觉、语音、全模态四大类,满足不同场景的模型需求:
- 文本生成模型:默认调用qwen3.7-max旗舰模型,支持长文本创作、代码生成、办公文案、逻辑推理等,具备强大的自主执行与复杂任务处理能力。
- 视觉理解模型:默认调用qwen3-vl-plus,支持图像理解、视觉编码、空间感知、超长视频分析,思考/非思考双模式融合,适配多模态交互场景。
- 语音处理模型:语音合成默认调用cosyvoice-v3-flash,支持多音色实时流式合成、情感增强、5-20秒样本克隆;语音识别默认调用fun-asr,覆盖汉语七大方言、20+口音与30种语种。
- 全模态模型:默认调用qwen3.5-omni-plus,支持文本、图像、音频、音视频的统一理解与交互,可处理10小时音频、400秒音视频,适配复杂多模态任务。
所有模型调用均支持自定义参数(如温度、最大长度、采样策略等),Agent可根据任务需求灵活调整,实现最优生成效果。
(二)多模态生成模块:文本/图像/视频/语音,全场景创作
多模态生成是百炼CLI的核心亮点,支持从文本到图像、视频、语音的全链路创作,让创意一键落地:
- 文本生成(bl text):支持文案创作、代码生成、摘要提取、翻译、问答等,支持长文本、结构化输出,可直接生成Markdown、JSON等格式内容。
- 图像生成与编辑(bl image):支持文生图、图生图、图像编辑、风格迁移、电商图制作等,支持自定义分辨率、比例、数量,生成专业级图像素材。
- 视频生成与编辑(bl video):支持文生视频、图生视频、视频剪辑、字幕添加、BGM替换、主体更换等,支持自定义时长、分辨率、帧率,快速生成短视频、宣传片等内容。
- 语音合成与识别(bl voice):支持文本转语音(TTS)、语音转文本(ASR)、语音克隆、多音色切换,支持流式输出与批量处理,适配播客、有声书、智能客服等场景。
该模块支持多能力协同,例如通过bl text generate生成视频脚本,再通过bl video generate将脚本转为视频,最后通过bl voice tts为视频添加配音,全程仅需三条命令。
(三)数据管理模块:知识库+记忆+检索,AI的“大脑”
数据管理模块为AI Agent提供持久化记忆与知识检索能力,解决Agent“健忘”与“信息不足”的痛点:
- 知识库管理(bl rag):支持一键搭建企业/个人知识库,支持上传PDF、Word、TXT、Markdown等格式文件,自动解析、向量化、索引,支持自然语言检索,快速获取精准知识。
- 记忆管理(bl memory):提供Agent记忆的持久化存储与管理,支持记忆增删改查、分类、检索,让Agent记住历史交互信息,实现上下文连贯的复杂任务处理。
- 联网搜索(bl search):集成实时联网搜索能力,支持自然语言查询,自动获取最新信息,解决模型知识时效性不足的问题,适配需要实时数据的场景。
- 数据处理(bl data):支持数据清洗、格式转换、批量处理,适配AI训练数据预处理、业务数据整理等场景。
(四)Agent增强模块:工作流+调用+监控,提升智能体能力
Agent增强模块进一步强化AI Agent的自动化与智能化水平,让Agent成为真正的“超级助手”:
- 工作流编排(bl workflow):支持自定义AI工作流,将多个命令组合为自动化流程,支持条件判断、循环执行,实现复杂任务的一键执行。
- Agent调用(bl agent):支持调用百炼平台的AI Agent应用,支持多Agent协同,实现更复杂的业务逻辑处理。
- 状态监控(bl status):支持查看CLI状态、模型调用日志、资源使用情况、计费信息,方便开发者监控与调试。
- 技能扩展(bl skills):支持安装、卸载、更新自定义技能插件,扩展CLI能力,适配个性化业务需求。
四、安装与配置:30秒快速上手,跨平台兼容
百炼CLI安装极简,仅需Node.js环境,30秒即可完成安装与配置,支持跨平台运行。
(一)环境要求
- Node.js ≥ 18.0.0(推荐22.12.0及以上)
- npm ≥ 8.0.0
- 支持Windows、macOS、Linux全平台
(二)安装命令(一行完成)
# 全局安装百炼CLI并安装所有官方技能
npm install -g bailian-cli && npx skills add modelstudioai/skills --all -g
# 验证安装
bl --version
# 输出:bailian-cli x.x.x(版本号)
(三)鉴权配置(API Key)
- 登录阿里云百炼控制台,进入“API密钥管理”,创建并复制API Key(以
sk-开头)。 - 执行鉴权命令:
```bash登录鉴权
bl auth login --api-key sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
查看鉴权状态
bl auth status
输出:校验API Key → PASS,写入配置 → ~/.bailian/config.toml,检测Token Plan → 已开通
##### (四)配置文件管理
百炼CLI配置文件默认存储于`~/.bailian/config.toml`,支持手动修改配置(如默认模型、输出格式、地域等):
```toml
# 配置文件示例
[auth]
api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
[default]
model = "qwen3.7-max" # 默认文本模型
image_model = "stable-diffusion-xl" # 默认图像模型
output_format = "json" # 默认输出格式
region = "cn-beijing" # 服务地域
五、常用命令实战:全场景代码演示
以下为百炼CLI核心功能的常用命令实战,覆盖文本、图像、视频、语音、知识库等场景,可直接复制使用。
(一)文本生成(bl text)
# 1. 生成营销文案
bl text generate --prompt "为一款智能办公椅写一段100字营销文案,突出人体工学、舒适、智能调节" --max-length 200 --temperature 0.7
# 2. 生成代码(Python)
bl text generate --prompt "编写一个Python函数,实现列表去重并保持顺序" --model "qwen3.7-max" --output "deduplicate.py"
# 3. 文本摘要
bl text summarize --input "long_article.txt" --max-length 100 --output "summary.txt"
# 4. 翻译(中译英)
bl text translate --text "阿里云百炼CLI,一行命令解锁全栈AI能力" --source "zh" --target "en"
(二)图像生成与编辑(bl image)
# 1. 文生图(生成电商主图)
bl image generate --prompt "黑色男装T恤,纯白背景,1:1正方形,亚马逊主图风格,高清细节" --size "1024x1024" --num 6 --output "./product_images/"
# 2. 图生图(风格迁移)
bl image edit --input "original.jpg" --prompt "转换为水彩画风格,保留主体细节" --output "watercolor.jpg"
# 3. 图像裁剪与水印
bl image process --input "image.jpg" --crop "512x512" --watermark "阿里云百炼" --opacity 0.3 --output "processed.jpg"
(三)视频生成与编辑(bl video)
# 1. 文生视频(30秒产品宣传片)
bl video generate --prompt "30秒智能办公椅产品宣传片,展示人体工学设计、智能调节、舒适体验,背景音乐轻快" --duration 30 --resolution "1280x720" --output "product_video.mp4"
# 2. 图生视频(图片转视频)
bl video generate --type r2v --img "./product_images/" --prompt "将产品图片转为30秒轮播视频,添加过渡效果" --duration 30 --output "image_video.mp4"
# 3. 视频编辑(添加字幕与BGM)
bl video edit --input "original_video.mp4" --subtitle "subtitle.srt" --bgm "background_music.mp3" --output "edited_video.mp4"
(四)语音处理(bl voice)
# 1. 文本转语音(TTS)
bl voice tts --text "欢迎使用阿里云百炼CLI,一行命令解锁全栈AI能力" --voice "female_standard" --speed 1.0 --output "tts_audio.mp3"
# 2. 语音克隆(基于5秒样本)
bl voice clone --sample "voice_sample.wav" --text "克隆语音测试" --output "cloned_voice.mp3"
# 3. 语音转文本(ASR)
bl voice asr --input "audio.wav" --language "zh" --output "transcript.txt"
(五)知识库与记忆管理(bl rag / bl memory)
# 1. 上传文件到知识库
bl rag upload --file "company_document.pdf" --dataset "company_kb" --description "公司产品文档"
# 2. 知识库检索
bl rag query --query "智能办公椅的核心功能是什么" --dataset "company_kb" --top-k 3
# 3. 存储记忆
bl memory set --key "user_preference" --value "喜欢简约风格,注重舒适度" --category "user_data"
# 4. 检索记忆
bl memory get --key "user_preference" --category "user_data"
(六)工作流编排(bl workflow)
# 1. 创建自动化工作流(生成文案→生成配图→制作视频)
bl workflow create --name "content_generation" --steps '
[
{"command": "bl text generate --prompt \"生成产品文案\" --output文案.txt"},
{"command": "bl image generate --prompt \"根据文案生成配图\" --output配图/"},
{"command": "bl video generate --prompt \"根据文案和配图制作视频\" --output视频.mp4"}
]
'
# 2. 执行工作流
bl workflow run --name "content_generation"
六、计费模式与成本控制:灵活计费,按需使用
百炼CLI基于阿里云百炼平台的计费体系,支持三种灵活的计费模式,满足不同用户的成本需求:
- 按量计费(后付费):按实际调用的模型Token数、图像生成张数、视频时长、语音时长计费,无最低消费,适合测试与低频使用场景。
- Token Plan(包年包月):预购固定额度的Token,支持文本、图像、视频、语音全能力抵扣,价格低至按量计费的5折,适合中高频使用场景。
- Coding Plan(固定月费):针对开发者与编程场景的专属套餐,固定月费,不限代码生成次数,适合AI编程、代码助手等场景。
用户可通过bl billing命令查看实时计费信息、资源使用情况,支持设置消费提醒,避免超额支出。
七、应用场景与价值:全行业赋能,AI自动化新范式
百炼CLI凭借全栈AI能力、Agent原生、命令行自动化的核心优势,广泛应用于多个行业与场景,创造显著价值:
- 内容创作行业:支持文案、图像、视频、语音的全链路自动化生成,大幅提升内容生产效率,降低创作成本,适配自媒体、电商、广告等场景。
- 开发者与编程:一键生成代码、调试、文档,支持AI编程助手,提升开发效率,适配软件开发、代码生成、技术文档编写等场景。
- 企业数字化:快速搭建企业知识库,实现知识检索与智能问答,支持自动化办公流程,适配企业知识管理、智能客服、办公自动化等场景。
- AI Agent开发:为AI Agent提供统一的AI能力调用接口,支持多能力协同与工作流编排,快速构建功能强大的智能体,适配智能助手、自动化机器人等场景。
- 教育与培训:自动生成课件、习题、教学视频,支持语音讲解与智能答疑,适配在线教育、培训内容制作等场景。
- 媒体与娱乐:快速生成短视频、播客、有声书,支持内容二次创作,适配媒体制作、内容分发等场景。
八、总结
阿里云百炼CLI作为AI智能体时代的核心命令行工具,通过统一的接口、极简的命令、全栈的AI能力,彻底打通了AI能力调用的最后一公里。它将百炼平台的150+模型、10+类多模态能力、知识库、记忆管理、联网搜索等核心能力,封装为一行命令即可调用的工具,让AI Agent从“思考”迈向“行动”,从“单一能力”迈向“全栈协同”。百炼CLI支持跨平台运行、Agent原生兼容、灵活计费与自定义扩展,无论是个人开发者、企业团队还是AI Agent开发者,都能通过百炼CLI快速实现AI能力的集成与自动化,大幅提升效率、降低成本。随着AI智能体的快速普及,百炼CLI将成为构建AI自动化工作流、释放AI创造力的核心基础设施,助力用户在智能体时代抢占先机。