Skip to content

README.zh.md

Latest commit

 

History

History
212 lines (147 loc) · 10.7 KB

README.zh.md

File metadata and controls

212 lines (147 loc) · 10.7 KB
Raw
Aliyun Model Studio CLI

阿里云百炼 (DashScope) AI 平台命令行工具

npm version Node.js TypeScript License

阿里云百炼 CLI 官方主页 · English · API 文档 · 获取 API Key

千问对话、图像生成与编辑、视频生成与编辑、图像理解、语音合成与识别、 应用调用、记忆管理、知识检索、联网搜索 — 一行命令，触达所有 AI 能力。

专为 AI Agent 打造，每个命令均可作为结构化工具调用。

功能特性

让您的 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

注意： 以下功能目前仅对中国站（aliyun.com）账号开放，国际站 / 全球站账号暂不支持。

  • 知识库与记忆库 — 多模态 RAG 检索 + 跨会话记忆，提供个性化连贯对话体验
  • 应用调用 — 调用已发布在阿里云百炼平台上的智能体与工作流应用
  • MCP 集成 — 统一调度百炼 MCP 服务：列出服务、查看工具、直接在终端调用任意工具
  • 联网搜索 — 实时互联网信息检索，提升回答准确性及时效性
  • 模型推荐 — 描述你的场景，智能推荐最适合的模型；支持限定范围搜索、模型对比和替代发现
  • 微调与部署 — 上传数据集、创建 SFT/LoRA/DPO/CPT 调优任务（finetune create）、非阻塞探测任务状态（finetune watch）、按模型查训练能力（finetune capability），并把训练好的模型部署为推理服务（deploy create）
  • 控制台能力 — 浏览百炼应用（app list），查询模型免费额度（usage free），查看模型用量统计（usage stats），管理业务空间（workspace list），管理限流与提额（quota list/request/check/history）
  • 本地文件自动上传 — 所有 URL 参数同时支持本地路径，免费临时存储 48 小时

示例:一句话生成一部电影短片

点击播放演示视频

👆 点击封面播放完整 2 分钟演示

一部完整的 2 分钟、16:9 电影感短片 —— 由一句自然语言端到端生成,全程零手动剪辑。这个示例展示了 AI Agent 如何把三个基础能力编排成一条多步创作流水线:

  • Qwen Code —— Agentic coding 模型,解析用户意图、驱动整个工作流
  • 阿里云百炼 CLI —— 调用 HappyHorse 1.1,百炼的文生/图生/参考生视频模型
  • spark-video Skill —— 负责场景拆分、分镜设计、镜头连贯性和最终拼接

唯一的提示词

"帮我生成一段日系影视风格,高中女生的青涩初恋故事,剧情高甜,让人看了想谈恋爱,2 分钟左右的视频,尺寸是 16:9"

工作流程

  1. Qwen Code 解析需求、规划叙事节奏,决定要调用哪些工具。
  2. spark-video Skill 把故事拆成镜头、为每个镜头写提示词,并保证视觉连贯性(角色、光线、色调、镜头语言)。
  3. bl video generate 把每个镜头并行下发给 HappyHorse 1.1。
  4. Skill 把所有片段拼成最终的 16:9 / 约 2 分钟成片。

没有时间线拖拽,没有逐帧剪辑。一句话 → 一部短片。

安装

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

需要预先安装 Node.js >= 22.12。

快速开始

# 认证（推荐浏览器登录）
bl auth login --console

# 或使用 API key 认证
bl auth login --api-key sk-xxxxx

# 和通义千问对话
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 create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # 本地路径自动上传
bl finetune watch --job-id ft-xxx --output json       # 非阻塞状态探测（退出码 0/1/3 = 成功/失败/进行中）
bl finetune capability --model qwen3-8b               # 查询模型支持哪些训练方式
bl deploy create --model qwen3-8b --name my-svc --plan mu  # 把训练好的模型部署为推理服务

# 浏览应用 / 免费额度 / 用量统计 / 业务空间
bl app list
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 官方主页

认证方式

DashScope API Key

大部分命令均需要 API Key。前往 DashScope 控制台 获取。

# 方式一：环境变量
export DASHSCOPE_API_KEY=sk-xxxxx

# 方式二：登录命令（持久化到 ~/.bailian/config.json）
bl auth login --api-key sk-xxxxx

# 方式三：命令行参数
bl text chat --api-key sk-xxxxx --message "你好"

控制台登录（OAuth）

控制台能力命令（app list、usage free、usage stats、workspace list、quota list/request/check/history）需要使用此登录方式。打开浏览器跳转百炼控制台完成登录。

bl auth login --console

阿里云 AK/SK（知识库检索与 Token Plan）

knowledge retrieve 与 token-plan 命令组需要阿里云 AccessKey。前往 RAM 控制台 获取。

建议：创建 RAM 子账号并授予最小权限，避免使用主账号 AK/SK。

export ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI5t...
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=...
export BAILIAN_WORKSPACE_ID=ws-...

配置

# 查看当前配置
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

# 自更新到最新版本
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
获取 AccessKey https://ram.console.aliyun.com/manage/ak

更新日志

每个版本的变更详情记录在 CHANGELOG.zh.md。

参与贡献

欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 CONTRIBUTING.zh.md。