mcpField
A
alicloud-ai-video-wan-r2v

alicloud-ai-video-wan-r2v

github.com/cinience创意与媒体396272 次安装11 周前更新
代码仓库

关于 alicloud-ai-video-wan-r2v

这是一个使用 Alibaba Cloud Model Studio Wan R2V 的参考素材转视频技能，面向需要根据参考视频和可选参考图像生成视频的用户。它提供规范化请求字段、请求准备脚本和异步任务轮询指引。

主要功能

  1. 01根据参考视频生成视频
  2. 02可选参考图像输入
  3. 03支持时长、帧率、尺寸和种子参数
  4. 04准备请求 JSON 并校验响应结构
  5. 05提供异步任务轮询流程

适用场景

  1. 01依据参考视频制作风格一致的短片
  2. 02结合参考图像控制视频生成
  3. 03准备并跟踪长时间运行的视频任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-ai-video-wan-r2v

安装后在 Claude Code 中输入/alicloud-ai-video-wan-r2v确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
prepare_r2v_request.py

详细介绍

Category: provider

Model Studio Wan R2V

验证

mkdir -p output/alicloud-ai-video-wan-r2v
python -m py_compile skills/ai/video/alicloud-ai-video-wan-r2v/scripts/prepare_r2v_request.py && echo "py_compile_ok" > output/alicloud-ai-video-wan-r2v/validate.txt

通过标准：命令以退出码 0 结束，并生成 output/alicloud-ai-video-wan-r2v/validate.txt。

输出与证据

  • 将参考输入元数据、请求负载和任务输出保存在 output/alicloud-ai-video-wan-r2v/ 中。
  • 至少保留一个轮询结果快照。

使用 Wan R2V 根据参考内容生成视频。这与 i2v（单张图片生成视频）不同。

关键模型名称

请使用以下精确模型字符串之一：

  • wan2.6-r2v-flash
  • wan2.6-r2v

较新的官方版本可能更推荐使用 flash 变体，以降低延迟和成本。

先决条件

  • 在虚拟环境中安装 SDK：
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 在环境中设置 DASHSCOPE_API_KEY，或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials。

规范化接口（video.generate_reference）

请求
  • prompt（字符串，必填）
  • reference_video（字符串 | 字节，必填）
  • reference_image（字符串 | 字节，可选）
  • duration（数字，可选）
  • fps（数字，可选）
  • size（字符串，可选）
  • seed（整数，可选）
响应
  • video_url（字符串）
  • task_id（字符串，异步时提供）
  • request_id（字符串）

异步处理

  • 生产流量优先采用异步提交。
  • 每隔 15-20 秒轮询一次任务结果。
  • 返回 SUCCEEDED 或终态失败状态时停止轮询。

本地辅助脚本

准备规范化请求 JSON 并验证响应架构：

.venv/bin/python skills/ai/video/alicloud-ai-video-wan-r2v/scripts/prepare_r2v_request.py \
  --prompt "Generate a short montage with consistent character style" \
  --reference-video "https://example.com/reference.mp4"

输出位置

  • 默认输出：output/alicloud-ai-video-wan-r2v/videos/
  • 使用 OUTPUT_DIR 覆盖基础目录。

工作流

  1. 确认用户意图、区域、标识符，以及操作是只读还是会修改数据。
  2. 先执行一项最小化只读查询，以验证连接和权限。
  3. 使用明确的参数和有限的范围执行目标操作。
  4. 验证结果并保存输出／证据文件。

参考资料

  • references/sources.md

评论

支持 Markdown