用途:用于通过 DashScope 的 wan2.7-videoedit 模型对视频进行编辑,支持风格迁移(如黏土、动漫等)和基于文本指令的内容编辑,可附带参考图。
主要能力:
- 风格迁移:将视频转换为不同视觉风格,仅需视频。
- 指令编辑:按文本指令编辑视频内容,可选参考图,最多3张。
使用方式:
- 安装依赖:python3 -m venv .venv; . .venv/bin/activate; python -m pip install dashscope。
- 设置 DASHSCOPE_API_KEY 环境变量,或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。
- 调用异步 API:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis,需带 Authorization: Bearer $DASHSCOPE_API_KEY、Content-Type: application/json、X-DashScope-Async: enable。新加坡端点替换为 dashscope-intl.aliyuncs.com。
- 创建任务后轮询 GET {BASE_URL}/tasks/{task_id},直至 SUCCEEDED、FAILED 或 CANCELED。
- 下载并保存结果视频,URL 24小时后失效。
参数:prompt(≤5000字符)、negative_prompt(≤500字符)、media(必填,含1个视频及最多3张参考图)、resolution(720P或1080P,默认1080P)、ratio(16:9、9:16、1:1、4:3、3:4)、duration(2-10秒)、audio_setting(auto或origin)、prompt_extend(默认true)、watermark(默认false)、seed。
媒体限制:视频格式 mp4/mov,时长2-10秒,单边240-4096像素,宽高比1:8至8:1,最大100MB。参考图格式 JPEG/JPG/PNG/BMP/WEBP,单边240-8000像素,最大20MB。
限制:仅支持异步调用,必须添加 X-DashScope-Async: enable 头;不能用于视频生成,应使用 aliyun-wan-i2v;视频URL过期后需重新生成。
验证:mkdir -p output/aliyun-wan-videoedit; python -m py_compile skills/ai/video/aliyun-wan-videoedit/scripts/edit_video.py && echo "py_compile_ok" > output/aliyun-wan-videoedit/validate.txt。
输出默认保存在 output/aliyun-wan-videoedit/videos/,可用 OUTPUT_DIR 覆盖。