百炼云端 DashScope API 快速上手：不用本地显卡，直接调 Wan2.2
两种使用方式
不想本地部署、没有 80GB 显卡的话，百炼提供了两条路径：
| 方式 | 适用 | 有无水印 |
|---|---|---|
| 百炼控制台网页体验 | 快速试用、调 prompt | 有（右下角"AI 生成"水印，无法关闭） |
| DashScope API | 集成到自己的程序、自动化 | 无（默认 false，可按需开启） |
第一步：申请 API Key
- 打开阿里云百炼 Model Studio 控制台
- 登录后进入「API-KEY 管理」
- 创建一个 API Key，复制保存好（只显示一次）
- 设置到环境变量：
Windows PowerShell：
$env:DASHSCOPE_API_KEY = "你的_key"Linux / macOS：
export DASHSCOPE_API_KEY="你的_key"第二步：安装 SDK
pip install dashscope第三步：选模型名
Wan2.2 在百炼上有多种模型（含 2.2 以上的版本），常见的 Wan2.2 系列：
| 模型名 | 能力 |
|---|---|
| wan2.2-t2v-plus | 文生视频（Plus 质量） |
| wan2.2-t2v-flash | 文生视频（Flash 更快） |
| wan2.2-i2v-plus | 图生视频（Plus） |
| wan2.2-i2v-flash | 图生视频（Flash） |
| wan2.2-s2v-detect | S2V 人脸图像检测 |
| wan2.2-s2v | S2V 对口型视频生成 |
⚠️ 百炼平台的模型名会持续更新，以上名称在 2026 年 10 月左右仍有效。最新列表请查百炼控制台的「模型广场」。
第四步：第一个 API 调用（伪代码示意）
DashScope 新协议使用异步任务提交模式——先提交任务拿到 task_id，再轮询查询结果。以下是典型流程的示意（实际 HTTP 路径和参数以官方文档为准）：
POST 提交任务 → 拿到 task_id
GET 查询 task_id 状态 → 等 processing 变 succeeded
GET 下载结果视频 URLSDK 版本会封装掉轮询细节，直接调用即可。
Endpoint URL 的地域选择
百炼的模型和地域绑定，调用时要保证模型、Endpoint URL 和 API Key 属于同一地域：
| 地域 | Endpoint URL |
|---|---|
| 华北 2（北京） | https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com |
| 新加坡（国际站） | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com |
WorkspaceId 在百炼控制台的业务空间详情页可以查到。跨地域调用会直接失败。
免费额度与计费
新用户通常有一定的免费额度。超过后按量计费，不同模型价格不同。以 wan2.2-t2v-plus 为例（仅供参考，实际价格以控制台为准）：
| 计费项 | 价格 |
|---|---|
| 480P 视频生成 | 约 0.14 元 / 秒 |
| 1080P 视频生成 | 约 0.70 元 / 秒 |
百炼对部分模型实行阶梯计费——输入 Token 越多、单价越高。视频生成类模型按输出时长计费。
水印控制
百炼控制台网页体验强制有水印，但通过 API 调用时，watermark 参数默认是 false——也就是无水印。如果你想留水印可以显式设为 true。
这一点对自动化和生产场景很重要：要无水印 → 必须走 API，不能走控制台。