wan-media-generation · diff

git:20261027.9d5beef to git:20261028.1756e02

1 added, 1 removed. Audit A to A.

---
name: wan-media-generation
description: |
通义万相 / DashScope（wan）生图/改图/生视频。用户指定万相、wan、DashScope、通义，或已配 DASHSCOPE_API_KEY 时使用。
⏰ 触发：「用万相生图/生视频」「DashScope wan 画图」等。
对话内快速单张/单段优先 platform → media.*（model=wan2.7-*）；多步流水线再用本技能 scripts。
火山生图请用 byted-ark-seedream-skill；火山短片请用 media-production。
---
# 通义万相 / DashScope（wan）媒体生成
Harness provider 名 **`wan`**。运行时与平台 `media.*` **共用** `providers/factory` + `dashscope_wan`（按模型号选协议）。
## 优先路径（对话内）
单张图 / 单段视频 → **`platform`**：
1. `media.catalog`（看模型与凭据）
2. `media.generate_image` / `media.generate_video`（`confirm=true`，`model=wan2.7-image` 或 `wan2.7-i2v`）
3. 视频再 `media.task_wait`
本技能 `wan_api.py`：用户明确要求终端脚本、批量、或要 `--last-frame-url` / `--audio-url` 等细参时再用。
## 模型与协议（默认 2.7）
| 模型 | 能力 | 协议 |
|------|------|------|
| `wan2.7-image` / `wan2.7-image-pro` | 文生图 / 图生图 | multimodal-generation **同步** |
| `wan2.7-i2v` | 图生视频（首帧/首尾帧 + 可选 driving_audio） | video-synthesis **异步** `input.media[]` |
| `wan2.7-t2v` | 文生视频 | 同上异步 |
| `wan2.6-t2i` / `wan2.6-i2v` / `wan2.6-t2v` | 兼容旧配额 | legacy text2image / `img_url` |
未传 `--model` 时脚本与平台一致：图默认 `wan2.7-image`，视频默认 `wan2.7-i2v` / `wan2.7-t2v`。
## 官方文档
| 能力 | 文档 |
|------|------|
| 万相 2.7 图像 | [图像生成与编辑](https://help.aliyun.com/zh/model-studio/wan-image-generation-and-editing-api-reference) |
| 万相 2.7 图生视频 | [图生视频 API](https://help.aliyun.com/zh/model-studio/wan-i2v-api-reference) |
| 万相视频总览 | [视频生成 API](https://help.aliyun.com/zh/model-studio/wan-video-generation-api-reference) |
| 万相 2.1/2.6 文生图（legacy） | [文生图 V2](https://help.aliyun.com/zh/model-studio/text-to-image-v2-api-reference) |
API 基址默认：`https://dashscope.aliyuncs.com/api/v1`
认证：`Authorization: Bearer <DASHSCOPE_API_KEY>`
## 凭据
**设置 → 模型 → 生图生视频 → 通义万相**，或环境变量 `DASHSCOPE_API_KEY`。
申请：[阿里云百炼 / Model Studio](https://bailian.console.aliyun.com/)
## 脚本
`skills/public/wan-media-generation/scripts/wan_api.py`（stdout = JSON）
### 文生图（默认 2.7）
```bash
python skills/public/wan-media-generation/scripts/wan_api.py image \
--prompt "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵，电影级光照" \
--aspect-ratio 16:9 \
--model wan2.7-image \
--output-dir outputs
```
### 图生图
```bash
python skills/public/wan-media-generation/scripts/wan_api.py image \
--mode image2image \
--prompt "保持构图，改为雨夜赛博朋克风格" \
--reference-image-urls "https://example.com/ref.png" \
--model wan2.7-image \
--output-dir outputs
```
### 图生视频（首帧；可加尾帧 / 驱动音频）
```bash
python skills/public/wan-media-generation/scripts/wan_api.py image \
--prompt "…" --aspect-ratio 16:9 --output-dir outputs
python skills/public/wan-media-generation/scripts/wan_api.py video \
--prompt "微推镜头，自然光影" \
--first-frame-url "<上一步 url>" \
--last-frame-url "<可选尾帧>" \
--audio-url "<可选 mp3>" \
--model wan2.7-i2v \
--duration 5 --resolution 720p --output-dir outputs
python skills/public/wan-media-generation/scripts/wan_api.py task-get \
--task-id "<task_id>" --media-kind video \
--max-wait-seconds 600 --output-dir outputs
```
### 文生视频
```bash
python skills/public/wan-media-generation/scripts/wan_api.py video \
--mode text2video \
--prompt "一只猫在海滩上看日落，电影感" \
--model wan2.7-t2v \
--poll --output-dir outputs
```
### 兼容旧协议
```bash
python skills/public/wan-media-generation/scripts/wan_api.py image \
--prompt "…" --model wan2.6-t2i --output-dir outputs
```
## 交付
- 解析 stdout 的 `absolute_path` / `local_path`；回复：`@@outputs/文件名@@`（png/mp4）。平台工具结果卡已有预览时勿再贴 `![]()`。
+ 解析 stdout 的 `absolute_path` / `local_path`；回复用 Markdown：`[文件名](相对工作目录的路径)` 或短路径反引号（png/mp4）。平台工具结果卡已有预览时勿再贴 `![]()`。
## 常见错误
- 图生图未传 `--reference-image-urls`
- 视频未 `task-get` / `--poll` 就当作失败
- Key 未在 EvoFlow **启用**
- 失败 **勿自动换** 其它厂商（须用户同意）