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/ に保存します。
  • ポーリング結果のスナップショットを少なくとも 1 つ保持します。

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 を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加します。

正規化インターフェース（video.generate_reference）

リクエスト
  • prompt（string、必須）
  • reference_video（string | bytes、必須）
  • reference_image（string | bytes、省略可能）
  • duration（number、省略可能）
  • fps（number、省略可能）
  • size（string、省略可能）
  • seed（int、省略可能）
レスポンス
  • video_url（string）
  • task_id（string、非同期の場合）
  • request_id（string）

非同期処理

  • 本番環境のトラフィックでは、非同期送信を優先します。
  • 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. 接続と権限を確認するため、まず最小限の読み取り専用クエリを 1 つ実行します。
  3. 明示的なパラメーターと限定された範囲で、対象の操作を実行します。
  4. 結果を検証し、出力ファイルと証拠ファイルを保存します。

参考資料

  • references/sources.md

コメント

Markdown 対応