用途:通过 DashScope Python SDK 调用 Wan 系列视频生成模型,统一 video.generate 的输入输出,为视频智能体流水线提供稳定的视频生成能力。
主要能力:支持文生视频与图生视频。可用模型为官方指定字符串:wan2.6-t2v、wan2.6-t2v-us、wan2.2-t2v-plus、wan2.2-t2v-flash、wan2.6-i2v-flash、wan2.6-i2v、wan2.6-i2v-us、wanx2.1-t2v-turbo;禁止编造模型名或别名。请求字段含 prompt(必填)、negative_prompt、duration、fps、size、seed、reference_image(t2v 可选,i2v 必填)、motion_strength;响应含 video_url、duration、fps、seed。据官方文档,wan2.6-t2v 与 wan2.6-t2v-us 支持多镜头叙事与可选音频输入。
使用方式:建议在 venv 安装依赖:python3 -m venv .venv;. .venv/bin/activate;python -m pip install dashscope。设置环境变量 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key(环境变量优先)。生成通常异步:调用 VideoSynthesis.call 或 async_call 获取 task_id,再用 VideoSynthesis.wait 轮询至 SUCCEEDED。size 用 WxH 格式如 1280*720,不支持尺寸可能返回 400。默认输出到 output/alicloud-ai-video-wan-video/videos/,可用 OUTPUT_DIR 覆盖。
验证:mkdir -p output/alicloud-ai-video-wan-video;python -m py_compile skills/ai/video/alicloud-ai-video-wan-video/scripts/generate_video.py && echo "py_compile_ok" > output/alicloud-ai-video-wan-video/validate.txt,退出码 0 且生成 validate.txt 即通过。需保存任务 ID、轮询响应与最终视频 URL;按 prompt、negative_prompt、duration、fps、size、seed、reference_image 哈希与 motion_strength 缓存;视频存对象存储,元数据仅留 URL。
适用场景:文生视频、以参考图驱动的图生视频、异步批量生成与流水线集成。
限制:生成可能耗时数分钟,需提供进度与取消/重试;4xx 应显式处理不可盲目重试;i2v 缺参考图会报 Field required: input.img_url。价格、配额与地域细节暂未提供。