Skip to content

README.zh.md

Latest commit

 

History

History
270 lines (177 loc) · 15.8 KB

README.zh.md

File metadata and controls

270 lines (177 loc) · 15.8 KB
Raw
Aliyun Model Studio CLI

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

npm version Node.js TypeScript License

阿里云百炼 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 或 Pi
  • 模型训推 — 数据集校验上传、模型精调、专属模型部署上线
  • 批量推理 — CSV/JSONL 构造、异步 Chat/Embedding 任务创建与跟踪、原始结果/错误下载及可选 CSV，或同步单请求 Batch Chat
  • 账号运维 — 授权登录、界面化配置、模型市场、用量与额度、限流提额、团队席位管理
  • 套餐接入 — 支持 Token Plan 等订阅计划一键接到 CLI 和常见 Coding Agent

注意： 应用编排、原生 MCP 接入、模型训推、账号运维和套餐接入目前仅支持中国站（aliyun.com）账号，暂不支持国际站 / 全球站账号。

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

点击播放演示视频

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

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

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

唯一的提示词

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

示例 2：一句话构建短片导演 Managed Agent

点击播放演示视频

👆 点击封面播放完整演示

一句话构建一个可复用的云端短片导演，用于分镜设计、分镜图生成和视频创作：

唯一的提示词

“帮我构建一个 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 官方主页

体验知识库

准备有效的 API Key 和工作空间后，先预览初始化计划：

bl knowledge init --workspace-id <workspace-id> --dry-run

知识库创建成功即持续按时计费，即使没有检索也一样。标准版一次性 720 小时额度由多个知识库共享，新用户开通后 30 天内有效；模型调用另计，当前账户剩余额度未知。查看计划与计费规则，确认本次操作后，在同一命令中去掉 --dry-run 并添加 --yes 执行。

保留返回的 ID 和恢复记录。退出 CLI 或后续步骤失败不会停止计费；按返回的清理动作删除不再需要的知识库。检索及清理示例见 Knowledge Studio 快速开始。知识库 Skill bailian-knowledge 通过 bl skill init 安装。

RAG 音视频接入

bl knowledge doc import --index-id <id> --doc-id <fileId> 将历史文件导入已有库；doc list --details 查看文件级处理参数。支持音视频 parser、流式上传，以及检索/切片中的媒体来源展示。问答 JSON 将最终 answer 与 phases/tools/docs/usage/events 分开保存，quiet 只隐藏进度和过程提示，保留最终结果及完整 JSON 字段。参阅 命令指南。

ParseX

通过业务空间专属 ParseX API 解析文档、音视频，并按 Schema 抽取结构化字段：

bl parsex parse submit --workspace-id <workspace-id> --file-url "https://example.com/document.pdf" --file-name document.pdf --output-file-format markdown --output json
bl parsex parse result --workspace-id <workspace-id> --biz-id <parse-biz-id> --follow --output json
bl parsex extract submit --workspace-id <workspace-id> --parsed-file-biz-id <parse-biz-id> --schema-file schema.json --output json
bl parsex extract result --workspace-id <workspace-id> --biz-id <extract-biz-id> --follow --output json

需要普通 API Key 和已获 ParseX 访问权限的业务空间。提交立即返回 data.biz_id，result --follow 等待完成。schema.json 为 JSON Schema 对象，例如 {"type":"object","properties":{"title":{"type":"string"}}}。输入使用可访问的 HTTP(S) URL；抽取还可复用保留期内的文档解析任务。处理配置、结果分片、OSS 凭证、dry-run 和轮询约定见 ParseX 命令指南。

批量推理

bl batch convert --help
bl batch convert --file input.csv --output-file input.jsonl --model qwen-plus
bl batch create --file input.jsonl --dry-run
bl batch create --file input.jsonl
bl batch get --batch-id <id> --follow
bl batch download --batch-id <id> --csv
bl text chat --batch --model qwen-plus --message "你好" --timeout 3600

--help 提供 CSV、JSONL 和结果数据样例。convert 为本地转换，无需凭证；推理/任务命令使用模型 API Key。文件推理统一使用异步任务 create → get → download：create 上传/提交后返回任务 ID，不等待任务完成；通过 get 查询，完成后用 download 下载结果。转换/下载产物逐文件原子发布，不静默覆盖，部分下载失败可用 --force 重跑恢复。JSONL 是保真结果，CSV 为有损展示；导入 ID 请选择文本类型以保留前导零。Ctrl-C 仅停止本地轮询，不取消远端任务。

text chat --batch 发送单次同步请求并等待响应，不创建异步任务 ID。使用 --message 或 --messages-file；后者表示同一请求的对话上下文，不表示文件中的独立请求。请求总超时默认为 300 秒（--timeout：60–3600 秒）。超时、Ctrl-C、断线不保证服务端已取消执行。

同步 Batch Chat 强制非流式；拒绝显式实时/国际站/Token Plan 端点。显式实时 Profile 需指定 --base-url https://batch.dashscope.aliyuncs.com。Batch 可用范围和限制取决于服务与模型。dry-run 不调用业务 API、不写产物或目录，框架更新检查/遥测遵循其配置。

认证方式

控制台登录（OAuth，推荐）

控制台能力命令（模型列表、应用列表、MCP 列表、工作空间、用量查询、限流提额、控制台直调）需要使用此登录方式，并可在需要时创建普通 API Key。Token Plan 等订阅计划不能使用 --console，请使用下面的 API Key 登录方式。

bl auth login --console

国际站请使用 --console-site international。

CLI 始终打印登录地址。若要自行选择浏览器，请保持命令运行，并在同一台机器的浏览器中打开地址：

bl auth login --console --no-browser --console-site international

浏览器拦截本地回调时，请检查控制台站点的本地网络权限，或尝试 Firefox。PNA 兼容响应头不能绕过 Chrome 的本地网络权限或 Safari 的混合内容限制。15 分钟内未收到回调会登录失败（退出码 5），不会视为成功。

如果已有有效的控制台 access token，可通过 stdin 导入，无需浏览器或本地回调服务。必须指定 token 实际所属的地域与站点；以下为 POSIX shell 示例：

bl auth login --console --token-stdin --console-site international --console-region ap-southeast-1 < /path/to/console-token.txt

输入只能是一个原始 token（不超过 64 KiB），不接受 JSON 或 Bearer ...；为避免凭证回显，不接受终端交互输入。请使用受保护的文件或可信管道，不要把 token 放进命令参数或 shell 历史，使用后清理临时凭证文件。CLI 校验通过才保存；失败时保留原凭证和激活的 Profile。加上 --config <name> 可在成功后写入并激活指定 Profile。此方式仅导入控制台会话，不创建模型 API Key。

API Key

使用已有的普通 API Key 或 Token Plan 订阅 Key，都执行同一条命令：

bl auth login --api-key <API_KEY>

普通 Key 前往 DashScope 控制台 获取，Token Plan Key 前往 订阅详情 获取。

阿里云 OpenAPI AK/SK

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 反馈和使用经验交流支持。

阿里云百炼 CLI 钉钉用户交流群

相关链接

Memory 用户文档：能力矩阵 · 命令指南。

资源 地址
阿里云百炼 CLI 官方主页 https://bailian.console.aliyun.com/cli?spm=a2ty07.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/?spm=a2ty07.github
获取 API Key https://bailian.console.aliyun.com/cn-beijing/?spm=a2ty07.github&tab=app#/api-key
获取 Token Plan API Key https://bailian.console.aliyun.com/cn-beijing?spm=a2ty07.github&tab=plan#/efm/subscription/overview
获取 AccessKey https://ram.console.aliyun.com/manage/ak