用途:调用阿里云 Model Studio(百炼)Wan R2V 模型执行参考生视频(reference-to-video),与 i2v(单图生视频)不同,适合生成角色风格一致的多镜头视频。
主要能力:模型名为精确字符串 wan2.6-r2v-flash 或 wan2.6-r2v;官方较新版本倾向使用 flash 变体以降低延迟和成本。归一化接口 video.generate_reference:请求含 prompt(必填字符串)、reference_video(必填,路径或字节)、reference_image(可选)、duration、fps、size、seed;响应含 video_url、task_id(异步时)、request_id。
使用方式:在虚拟环境安装 dashscope(python3 -m venv .venv 后 . .venv/bin/activate,再 python -m pip install dashscope),设置 DASHSCOPE_API_KEY 或写入 ~/.alibabacloud/credentials 的 dashscope_api_key。生产流量建议异步提交,以 15-20 秒间隔轮询任务结果,直到 SUCCEEDED 或终态失败时停止。本地辅助脚本可准备归一化请求 JSON 并校验响应结构:.venv/bin/python skills/ai/video/alicloud-ai-video-wan-r2v/scripts/prepare_r2v_request.py --prompt "..." --reference-video "https://example.com/reference.mp4"。默认输出到 output/alicloud-ai-video-wan-r2v/videos/,可用 OUTPUT_DIR 覆盖。校验命令:python -m py_compile skills/ai/video/alicloud-ai-video-wan-r2v/scripts/prepare_r2v_request.py 且需生成 output/alicloud-ai-video-wan-r2v/validate.txt。
适用场景:需要参考视频来保持角色或多镜头风格一致性的短视频生成。
限制:需自行配置 API Key 与网络;具体计费、价格、可用地域与配额资料暂未提供;输出需保存参考输入元数据、请求载荷与任务输出,并保留至少一个轮询结果快照。