mcpField
A
alicloud-ai-video-wan-r2v

alicloud-ai-video-wan-r2v

github.com/cinienceCreative & media396272 installsUpdated 11w ago
Repository

About alicloud-ai-video-wan-r2v

A reference-to-video skill using Alibaba Cloud Model Studio Wan R2V, for users generating video from reference footage and optionally an image. It provides a normalized request schema, a request-preparation script, and guidance for polling asynchronous tasks.

Key features

  1. 01Generates video from reference footage
  2. 02Optional reference image input
  3. 03Duration, frame rate, size, and seed parameters
  4. 04Prepares request JSON and validates response schema
  5. 05Async task polling workflow

Use cases

  1. 01Create a short clip based on reference footage
  2. 02Guide video generation with a reference image
  3. 03Prepare and track a long-running video task

Install

Copy the command and run it in a terminal.

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

After installing, type/alicloud-ai-video-wan-r2vin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

Category: provider

Model Studio Wan R2V

Validation

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

Pass criteria: command exits 0 and output/alicloud-ai-video-wan-r2v/validate.txt is generated.

Output And Evidence

  • Save reference input metadata, request payloads, and task outputs in output/alicloud-ai-video-wan-r2v/.
  • Keep at least one polling result snapshot.

Use Wan R2V for reference-to-video generation. This is different from i2v (single image to video).

Critical model names

Use one of these exact model strings:

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

Newer official releases may prefer the flash variant for lower latency and lower cost.

Prerequisites

  • Install SDK in a virtual environment:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.

Normalized interface (video.generate_reference)

Request
  • prompt (string, required)
  • reference_video (string | bytes, required)
  • reference_image (string | bytes, optional)
  • duration (number, optional)
  • fps (number, optional)
  • size (string, optional)
  • seed (int, optional)
Response
  • video_url (string)
  • task_id (string, when async)
  • request_id (string)

Async handling

  • Prefer async submission for production traffic.
  • Poll task result with 15-20s intervals.
  • Stop polling when SUCCEEDED or terminal failure status is returned.

Local helper script

Prepare a normalized request JSON and validate response schema:

.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 location

  • Default output: output/alicloud-ai-video-wan-r2v/videos/
  • Override base dir with OUTPUT_DIR.

Workflow

  1. Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
  2. Run one minimal read-only query first to verify connectivity and permissions.
  3. Execute the target operation with explicit parameters and bounded scope.
  4. Verify results and save output/evidence files.

References

  • references/sources.md

Comments

Markdown supported