Qwen 视频生成

使用 Wan 和 HappyHorse 模型生成视频。所有任务均为异步任务——先提交，再轮询，直至 完成。 此 skill 是 QianWen-AI/qianwen-ai 中的一部分。

⚠️ 各模式的重要参数差异：

- kf2v（首帧+尾帧）：时长固定为 5 秒——使用其他值将失败。输出仅限无声视频。

- 分辨率参数因模式而异：t2v/r2v/vace 使用 size（例如 "1280*720"）；i2v/kf2v 使用 resolution（例如 "720P"）。

Skill 目录

使用此 skill 的内部文件执行任务并学习。在默认执行路径失败或需要详细信息时，按需加载参考文件。

| 位置 | 用途 | |----------|---------| | scripts/video.py | 默认执行方式——自动检测模式、提交、轮询、下载 | | references/execution-guide.md | 备用方案：全部 5 种模式的 curl 命令、代码生成 | | references/request-fields.md | 各模式的字段表和音频处理方式 | | references/workflows.md | 时长扩展、多镜头、VACE 流程 | | references/polling-guide.md | 轮询模式和时序 | | references/merge-media.md | 拼接、裁剪、音频叠加——ffmpeg/moviepy 操作方案 | | references/prompt-guide.md | 各模式的 Prompt 公式、声音描述和多镜头结构 | | references/examples.md | 各模式的完整脚本示例 | | references/sources.md | 官方文档 URL |

安全

严禁以明文输出任何 API 密钥或凭证。 始终使用变量引用（命令行环境中使用 $DASHSCOPE_API_KEY，Python 中使用 os.environ["DASHSCOPE_API_KEY"]）。任何凭证检查或检测都必须采用非明文方式：仅报告状态（例如“已设置”/“未设置”、“有效”/“无效”），不得报告具体值。禁止显示 .env 文件或可能包含机密信息的配置文件中的内容。

未配置 API 密钥时，禁止要求用户直接提供密钥。 而应帮助创建包含占位值（DASHSCOPE_API_KEY=sk-your-key-here）的 .env 文件，并指示用户将该占位值替换为从千问AI平台控制台获取的实际密钥。仅当用户明确提出要求时，才可写入实际密钥值。

密钥兼容性

同时支持 PAYG 密钥（sk-ws-...；旧版为 sk-...）和 Token Plan 密钥（sk-sp-...）。请在不暴露密钥的情况下检测 API 密钥类型：

python3 -c "
import sys; sys.path.insert(0, 'scripts')
from qianwen_lib import detect_api_key_type
print(detect_api_key_type('scripts/qianwen_lib.py'))
"

| 输出 | 含义 | |--------|---------| | token-plan | Token Plan 密钥——仅可使用下方 Token Plan 列表中的模型。 | | payg | 按量付费密钥——可使用完整的模型目录。 | | not-set | 未配置密钥。 |

对于 Token Plan，请使用 qianwen-model-selector 提供的确切模型，或查阅以下文件： qianwen-ops-auth/references/tokenplan.md。若上述内容不可用，请使用：

• 个人版：https://platform.qianwenai.com/docs/token-plan/personal/token-plan-personal-overview.md
• 团队版：https://platform.qianwenai.com/docs/token-plan/team/token-plan-team-overview.md

Token Plan 不支持本地文件上传；对于 i2v/r2v/kf2v 模式，请通过以下可访问 URL 提供参考图像/视频： https:// 或 oss://，而非使用本地路径。

Token Plan 仅支持特定模型——必须严格使用上述参考资料中列出的模型；不得猜测或探测模型是否可用。 PAYG：请继续阅读下文。

模式选择指南

| 用户需求 | 模式 | 关键字段 | |-----------|------|------------| | 仅根据文本描述生成视频 | t2v | 仅需 prompt | | 为单张图像制作动画 | i2v | img_url 或 reference_image | | wan2.7 统一 i2v：首帧、首尾帧、视频续写、音频同步 | i2v | media[], first_frame_url, first_clip_url, driving_audio_url | | 生成两张图像之间的过渡（⚠️ 时长固定为 5s，仅生成无声视频） | kf2v | first_frame_url + last_frame_url | | 角色扮演：让角色演绎新剧本 | r2v | reference_urls（最多 5 个） | | 视频编辑：多图参考、重绘、局部编辑、扩展、扩图 | vace | function（默认为 wanx2.1-vace-plus） | | 视频编辑（无 function 字段，使用媒体数组） | videoedit | 模型 = wan2.7-videoedit 或 happyhorse-1.0-video-edit |

模型选择

1. 用户指定了模型 → 直接使用。
2. 当模型选择取决于能力、场景或定价时，请使用 qianwen-model-selector skill。
3. 无相关指示且任务明确 → 默认值：t2v → happyhorse-1.1-t2v，i2v → happyhorse-1.1-i2v，kf2v → wan2.2-kf2v-flash，r2v → happyhorse-1.1-r2v，vace → wanx2.1-vace-plus，videoedit → wan2.7-videoedit。t2v/i2v/r2v 的默认模型（HappyHorse 1.1）兼容 TP 和 PAYG，支持音频输出，时长为 3–15s；kf2v/vace/videoedit 的默认模型仅限 PAYG。如需使用 wan2.6 功能（多镜头、size 参数），请显式设置 --model wan2.6-t2v / --model wan2.6-i2v-flash。如需使用 wan2.7 功能，请显式设置 --model wan2.7-t2v / --model wan2.7-i2v / --model wan2.7-videoedit。对于 HappyHorse 1.0 系列，请设置 --model happyhorse-1.0-{t2v,i2v,r2v,video-edit}。

模型

t2v（文生视频）

| 模型 | 特性 | |-------|----------| | wan2.7-t2v | 宽高比控制、自动配音、5000 字符 Prompt、720P/1080P。使用 resolution + ratio 参数。 | | wan2.7-t2v-2026-06-12 | wan2.7-t2v 的快照版本。功能相同。 | | wan2.6-t2v | 音频、多镜头，时长 2–15s，分辨率 720P/1080P。使用 size 参数。 | | wan2.5-t2v-preview | 音频，时长 5s/10s，分辨率 480P/720P/1080P | | wan2.2-t2v-plus | 无声，时长 5s，分辨率 480P/1080P |

i2v（图生视频）

| 模型 | 特性 | |-------|----------| | wan2.7-i2v | 统一协议：首帧、首尾帧、视频续写、音频同步。使用 media[] 数组。 | | wan2.6-i2v-flash | 有声/无声、多镜头，时长 2–15s，分辨率 720P/1080P。使用 img_url。 | | wan2.6-i2v | 音频、多镜头，时长 2–15s，分辨率 720P/1080P | | wan2.5-i2v-preview | 有声，5s/10s，480P/720P/1080P |

kf2v / r2v / vace

| 模型 | 功能 | |---------------------------------------------|---------------------------------------------------------------------| | wan2.2-kf2v-flash （kf2v 默认） | 无声，5s，480P/720P/1080P | | wan2.7-r2v | 多参考（图像/视频/音频）角色扮演。input.media=[{type,url}] 最多可包含 5 个混合类型的参考项（reference_image/reference_video/reference_audio）。resolution 支持 720P/1080P，duration ≤ 10s，不支持 ratio。仅限 PAYG。 | | wan2.7-r2v-2026-06-12 | wan2.7-r2v 的快照版本。主体参考 + 声音定制 + 分镜。 | | wan2.6-r2v | 有声，单角色/多角色，2–10s，720P/1080P | | wan2.6-r2v-flash | 有声/无声，多角色，2–10s，720P/1080P。仅限 PAYG。 | | wanx2.1-vace-plus (vace) | 多图参考、重绘、局部编辑、时长 ≤ 5s、720P |

wan3.0-video / wan3.0-video-prime（t2v + i2v 一体化）

统一的一体化模型， 在单个模型中同时支持文生视频（t2v）和图生视频（i2v）。模式会自动识别：仅提供 prompt 时为 t2v； 提供参考图像（img_url / reference_image / media）时为 i2v。仅限 PAYG。

| 模型 | 功能 | |-----------------------|------------------------------------------------------------------------------| | wan3.0-video | t2v + i2v，resolution 支持 480P/720P/1080P，ratio 支持 adaptive/16:9/9:16/1:1，duration ≤ 30s。i2v 使用 input.media=[{type:reference_image,url}]。 | | wan3.0-video-prime | wan3.0-video 的更高质量版本。请求体和参数相同。 |

仅限 PAYG：wan2.7-r2v、wan3.0-video、wan3.0-video-prime、wan2.2-kf2v-flash、wanx2.1-vace-plus 和 wan2.7-videoedit 无法在 Token Plan 中使用。Token Plan 不支持上传本地文件 — 请将所有参考图像/视频/音频作为可访问的 URL（https:// 或 oss://）提供，不得使用本地路径。

videoedit（视频编辑）

由 Prompt 驱动的视频编辑，可选用参考图像。不含 function 字段； 使用 input.media = [1 video] + [refs]。默认模型：wan2.7-videoedit。

| 模型 | 参考图像上限 | 说明 | |-----------------------------|----------|------------------------------------------------------------------------| | wan2.7-videoedit（默认）| ≤4 | 支持基于 Prompt 的局部/全局编辑；支持 negative_prompt。 | | happyhorse-1.0-video-edit | ≤5 | 通过参考图像替换元素；保留原有动态效果。 |

有关定价详情，请参阅 wan2.7-videoedit · happyhorse-1.0-video-edit。

HappyHorse 系列

| 模型 | 模式 | 与 wan2.6 相比的请求体差异 | |-----------------------------|-----------|-----------------------------------------------------------------------| | happyhorse-1.1-t2v 默认 | t2v | 音频输出，3–15s，720P/1080P。兼容 TP 和 PAYG。使用 resolution + ratio（不使用 size）。结构同 1.0-t2v. | | happyhorse-1.1-i2v 默认 | i2v | 音频输出，3–15s，720P/1080P。兼容 TP 和 PAYG。使用 media=[{type:'first_frame',url}]（有且仅有一个）。约束同 1.0-i2v. | | happyhorse-1.1-r2v 默认 | r2v | 音频输出，3–15s，720P/1080P。兼容 TP 和 PAYG。使用 media=[{type:reference_image,url}] + resolution + ratio。最多支持 9 个参考项。 | | happyhorse-1.0-t2v | t2v | 使用 resolution + ratio（不使用 size）。 | | happyhorse-1.0-i2v | i2v | 使用 media=[{type:'first_frame',url}]（有且仅有一个）。不支持 negative_prompt/prompt_extend/ratio/last_frame/first_clip/driving_audio。会自动转换 Wan2.6 格式的 img_url。 | | happyhorse-1.0-r2v | r2v | 使用 media=[{type:reference_image,url}] + resolution + ratio。最多支持 9 个参考项。 | | happyhorse-1.0-video-edit | videoedit | 使用 input.media = [1 video] + [refs]。无 function 字段。最多支持 5 个参考项。 |

端点：/services/aigc/video-generation/video-synthesis。

⚠️ 重要提示：上述模型列表是特定时间点的快照，可能已过时。模型可用性

变动频繁。**在做出模型决策前，请务必查看官方模型列表

，以获取权威的最新目录。**

模型详情：如需了解某个具体模型的更多信息，请引导用户访问其详情页：https://www.qianwenai.com/models/<model-name>（将 <model-name> 替换为确切的模型 ID，例如 wan2.7-t2v → <https://www.qianwenai.com/models/wan2.7-t2v>）。禁止修改或猜测 URL 中的模型名称。

动态模型查询：如果 qianwen-model-selector skill 或 千问AI平台 CLI（qianwen models info <model>）可用，请使用它获取实时模型数据。CLI 需要身份验证——登录流程请参阅 qianwen-usage skill。

执行

⚠️ 多个产物：在单个会话中生成多个文件时，必须为每个文件名追加数字后缀（例如 out_1.mp4、out_2.mp4），以防文件被覆盖。

前提条件

• API 密钥：使用密钥兼容性中的非明文检测器；不要将其替换为

变量存在性检查。如果未找到密钥，请在可用时使用 qianwen-ops-auth，或指导用户进行配置： DASHSCOPE_API_KEY/QIANWEN_API_KEY 应配置在 .env 中。Skills 可独立安装。

• Python 3.9+（仅使用标准库，无需执行 pip install）
• 如需合并媒体（拼接、裁剪、音频叠加）：请参阅 [merge-media.md](references/merge-media.md)，获取适合用户环境的 ffmpeg/moviepy 操作方案

环境检查

首次执行前，请验证 Python 是否可用：

python3 --version  # must be 3.9+

如果未找到 python3，请尝试 python --version 或 py -3 --version。如果 Python 不可用或版本低于 3.9，请跳至 [execution-guide.md](references/execution-guide.md) 中的路径 2（curl）。

默认方式：运行脚本

脚本路径：脚本位于此 skill 所在目录（即包含此 SKILL.md 的目录）的 scripts/ 子目录中。您必须先找到此 skill 的安装目录，然后始终使用完整绝对路径执行脚本。 不要假定脚本位于当前工作目录。执行前不要使用 cd 切换目录。

执行说明： 所有脚本均在前台运行——等待 stdout 输出；不要在后台运行。

查看参数： 先运行 python3 <this-skill-dir>/scripts/video.py --help，查看所有可用参数。

python3 <this-skill-dir>/scripts/video.py \
  --request '{"prompt":"A detective in a rainy city at night","size":"1280*720","duration":5}' \
  --print-response

| 参数 | 说明 | |----------|-------------| | --request '{...}' | JSON 请求正文 | | --file path.json | 从文件加载请求 | | --mode MODE | 覆盖自动检测的模式（t2v/i2v/kf2v/r2v/vace） | | --model ID | 覆盖模型 | | --output path | 目录或文件路径。如果路径以视频文件扩展名（.mp4/.mov/.webm/.mkv/.m4v 等）结尾，则将其用作输出文件名（自动创建父目录）。否则会将其视为目录——视频将根据 OSS URL 的基名自动命名，以防在多次运行之间发生覆盖；请在不同调用中使用不同的文件名，以免覆盖响应数据 | | --print-response | 将响应 JSON 打印到 stdout | | --submit-only | 提交并退出（打印 task_id） | | --task-id ID | 操作现有任务 | | --poll-interval N | 两次轮询之间的间隔秒数（默认值：15） | | --timeout N | 最长等待秒数（默认值：600） |

模型优先级：--model CLI 标志 > --request JSON 中的 "model" 字段 > 内置默认值。

验证结果

• 退出代码为 0 且响应包含 output.task_id → 提交成功
• 轮询结果为 task_status: SUCCEEDED → 生成完成
• 退出代码非零、出现 HTTP 错误或状态为 FAILED → 失败
• 执行后检查：验证输出视频文件存在且大小不为零（ls -la <output_dir>）
• 强制要求 — stderr 信号检查：确认结果后，扫描命令的 stderr 输出，查看是否存在 [ACTION_REQUIRED] 或 [UPDATE_AVAILABLE]。如果出现任一信号，在回复用户前，你必须遵循下方[更新检查](#update-check-mandatory-post-execution)中的说明。

失败处理

如果脚本执行失败，请将错误输出与下方诊断表进行匹配，以确定解决方案。如果没有匹配项，请阅读 [execution-guide.md](references/execution-guide.md) 了解替代路径：curl 命令（路径 2 — 全部 5 种模式）、代码生成（路径 3）和自主解决（路径 5）。

如果完全无法使用 Python → 直接跳到 [execution-guide.md](references/execution-guide.md) 中的路径 2（curl）。

| 错误模式 | 诊断 | 解决方案 | |---------------|-----------|------------| | command not found: python3 | Python 不在 PATH 中 | 尝试 python 或 py -3；若缺失，请安装 Python 3.9+ | | Python 3.9+ required | 脚本版本检查失败 | 将 Python 升级至 3.9+ | | 类型提示附近出现 SyntaxError | Python < 3.9 | 将 Python 升级至 3.9+ | | QIANWEN_API_KEY/DASHSCOPE_API_KEY not found | 缺少 API 密钥 | 从千问AI平台控制台获取密钥；添加到 .env：echo 'DASHSCOPE_API_KEY=sk-...' >> .env；如果可用，也可运行 qianwen-ops-auth | | HTTP 401 | 密钥无效或不匹配 | 运行 qianwen-ops-auth（仅进行非明文检查）；验证密钥是否有效 | | SSL: CERTIFICATE_VERIFY_FAILED | SSL 证书问题（代理/企业网络） | macOS：运行 Install Certificates.command；否则设置 SSL_CERT_FILE 环境变量 | | URLError / ConnectionError | 网络不可达 | 检查互联网连接；如果使用代理，请设置 HTTPS_PROXY | | HTTP 429 | 触发速率限制 | 等待后以退避策略重试 | | HTTP 5xx | 服务器错误 | 以退避策略重试 | | ImportError: moviepy | 未安装 moviepy | pip install moviepy，或改用系统 ffmpeg（参见 [merge-media.md](references/merge-media.md)） | | PermissionError | 无法写入输出 | 使用 --output 指定可写目录 |

请求字段摘要

所有模式都需要 prompt。有关各模式的完整字段表，请参阅 [request-fields.md](references/request-fields.md)。

⚠️ 各模式的分辨率参数（关键）

| 模式 | 参数 | 格式 | 示例 | |------|-----------|--------|--------| | t2v | size | "WxH" | "1280*720", "1920*1080" | | r2v | size | "WxH" | "1280*720", "1920*1080" | | vace | size | "WxH" | "1280*720" | | i2v | resolution | "xxxP" | "720P", "1080P" | | kf2v | resolution | "xxxP" | "480P", "720P", "1080P" |

使用错误的参数名称会导致 API 调用失败。

各模式的必填字段

• i2v 需要 img_url/reference_image。kf2v 需要 first_frame_url + last_frame_url。r2v 需要 reference_urls。vace 需要 function。

成本估算

🚨 禁止猜测或捏造任何价格数值。 始终引导用户访问

官方定价页面，以获取准确费率。

生成视频按秒计费。价格因模型和分辨率而异。有关最新费率，请查看 官方定价页面。

| 模型 | 720P (USD) | 1080P (USD) | |------------------|--------------------|--------------------| | wan2.7-t2v | 按秒计费 | 按秒计费 | | wan2.7-i2v | 按秒计费 | 按秒计费 | | wan2.6-t2v | 按秒计费 | 按秒计费 | | wan2.6-i2v-flash | 按秒计费 | 按秒计费 | | wan2.6-r2v-flash | 按秒计费 | 按秒计费 |

快速示例：happyhorse-1.1-t2v 5s 720P——请查看 官方定价页面，了解当前的按秒 费率。部分模型可能会提供有限的免费额度——不得假定任何调用都是免费的；请使用 qianwen-usage skill 检查免费层剩余额度，或在用户的千问AI平台控制台中核实。

要查看实际用量和账单，请使用 qianwen-usage skill，或访问控制台： 用量分析 | 按量付费账单 | Token Plan 订阅

严禁编造、猜测或构造用量/账单/控制台 URL。 只能提供此 skill 中列出的确切链接。如果某个 URL 未在此处列出，则不得杜撰。

本地文件处理

当用户提供本地文件路径（图像、视频、音频）时，将其直接传递给脚本。脚本会将本地文件自动上传到 DashScope 临时存储（oss:// URL，48h TTL），并注入 X-DashScope-OssResourceResolve: enable 请求头。无需手动执行上传步骤。

生产环境：默认临时存储的 TTL 为 48h，且 上传限制为 100 QPS——不适用于生产环境、高并发场景或负载测试。要使用自有 OSS 存储桶，请在 .env 中设置 QWEN_TMP_OSS_BUCKET 和 QWEN_TMP_OSS_REGION，安装 pip install oss2，并通过 QWEN_TMP_OSS_AK_ID / QWEN_TMP_OSS_AK_SECRET 或标准的 OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET 提供凭据。使用遵循最小权限原则的 RAM 用户（仅授予对目标存储桶的 oss:PutObject + oss:GetObject 权限）。如果已安装 qianwen-ops-auth，请参阅其中的 references/custom-oss.md，获取完整配置指南。

跨 Skill 串联

将另一个 skill 的输出用作输入时（例如 image-gen → i2v、audio-tts → 音频叠加）：

• 直接传递 URL（例如 "img_url": "<image_url from image-gen>"）— 不得下载后以本地路径重新传递
• 脚本会检测 URL 前缀（https://、oss://），并将其直接传递，无需重新上传
• 响应中的 local_path 仅用于用户预览或非 API 操作

将此 skill 的输出传递给另一个 skill 时（例如，vace 编辑、视觉分析）：

• 直接传递响应中的 video_url — 不得下载后以本地路径重新传递

| 场景 | 使用 | |----------|-----| | 传递给另一个 skill | video_url / image_url (URL) | | 向用户展示 / 本地播放 | local_path（本地文件） |

重要说明

• 仅支持异步：所有视频 APIs 都必须使用 X-DashScope-Async: enable 请求头。
• kf2v：使用不同的 API 端点。时长固定为 5s，仅支持无声输出。
• r2v：在提示词中使用 character1/character2/...。最多支持 5 个参考素材（其中视频最多 3 个）。
• vace：必须指定 function。仅支持无声输出，输出时长≤5s。
• 多镜头：同时设置 shot_type: "multi" 和 prompt_extend: true。
• 视频 URL 将在 24h 后过期 — 脚本会自动下载到 --output 目录。与另一个 skill 串联使用时（例如 vace 编辑），直接传递 video_url — 不得重新下载。
• 有关高级工作流 → 参见 [workflows.md](references/workflows.md)。

错误处理

| 错误 | 原因 | 处理措施 | |-------|-------|--------| | 401 Unauthorized | API 密钥无效或缺失 | 如可用，运行 qianwen-ops-auth；否则，提示用户设置密钥（仅进行非明文检查） | | current user api does not support synchronous calls | 缺少异步请求头 | 添加 X-DashScope-Async: enable | | 429 / 5xx | 限流或服务器错误 | 采用退避策略重试 | | The product is not activated / Model not subscribed | 账户未启用第三方模型 | 访问模型市场，找到该模型，然后点击 "开通" | | 任务 FAILED | 生成失败 | 检查轮询响应中的 output.message |

输出位置

优先使用当前工作目录。默认子目录：./output/qianwen-video-generation/。

写入禁令：严禁将输出文件写入此 skill 的安装目录或任何 skills/ 层级结构中。所有生成的内容必须写入当前工作目录下的 output/ 或用户指定的路径。

更新检查（执行后必须进行）

脚本执行后，检查 stderr 是否包含操作信号。脚本会自动检测更新状态并发出结构化信号。你必须根据这些信号采取行动。当用户明确要求检查更新时，本节也适用。

信号：[ACTION_REQUIRED] qianwen-update-check skill is not installed

当 stderr 中包含此信号时，你必须向用户提供以下选项，并等待用户响应后再继续。不得静默跳过此步骤。

尚未安装更新检查 skill。它会帮助你及时了解 QianWen-AI/qianwen-ai 中的新功能和错误修复。

1) 立即安装 — 我将为你运行安装命令

2) 暂时跳过 — 本次不执行任何操作

3) 禁止再提醒我 — 永久抑制此提示

用户响应后：

• 用户选择 1 → 运行：npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y，然后运行：python3 <this-skill-scripts-dir>/gossamer.py --dismiss
• 用户选择 2 → 运行：python3 <this-skill-scripts-dir>/gossamer.py --dismiss，然后照常继续
• 用户选择 3 → 运行：python3 <this-skill-scripts-dir>/gossamer.py --never-install，然后照常继续

信号：[UPDATE_AVAILABLE]

当 stderr 包含此信号时，你必须在回复中附上一则简短的更新通知，其中包括 stderr 输出中显示的版本信息和更新命令。

stderr 中无信号

如果 stderr 既不包含 [ACTION_REQUIRED]，也不包含 [UPDATE_AVAILABLE]，则无需执行任何操作 — 该 skill 已安装且为最新版本（或已在 24h 内缓存）。

用户明确请求

当用户明确要求检查更新（例如“检查更新”、“检查版本”）时：

1. 在同级 skill 目录中查找 qianwen-update-check/SKILL.md。
2. 如果找到 — 运行：python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response 并报告结果。
3. 如果未找到 — 向用户提供上述安装选项。

参考资料

• [execution-guide.md](references/execution-guide.md) — 备用路径（适用于所有模式的 curl、代码生成、自主处理）
• [request-fields.md](references/request-fields.md) — 各模式的详细字段表 + 音频处理
• [workflows.md](references/workflows.md) — 时长扩展、音频变通方案、多镜头、VACE 流水线
• [polling-guide.md](references/polling-guide.md) — 轮询模式和时序建议
• [merge-media.md](references/merge-media.md) — 生成合并/裁剪/音频叠加代码的指南
• [examples.md](references/examples.md) — 所有模式的完整脚本执行示例
• [sources.md](references/sources.md) — 官方文档 URL