mcpField
A
aliyun-pixverse-generation

aliyun-pixverse-generation

github.com/cinienceクリエイティブ・メディア39659 回インストール11 週間前に更新
リポジトリ

aliyun-pixverse-generation について

aliyun-pixverse-generationは、Alibaba Cloud Model StudioでPixVerse系モデルの動画生成リクエストを準備するスキルです。テキスト、画像、フレーム間の遷移、複数画像の参照に対応し、非同期タスクの送信と状態確認を行います。

主な機能

  1. 01PixVerse動画リクエストの準備
  2. 02テキストからの動画生成
  3. 03先頭フレーム画像の動画化
  4. 042フレーム間の遷移生成
  5. 05複数画像による一貫性の維持

活用シーン

  1. 01テキストプロンプトから動画を生成
  2. 02指定した先頭フレーム画像を動かす
  3. 03フレーム間の動画遷移を作成
  4. 04参照画像でキャラクターやスタイルを統一

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-pixverse-generation

インストール後、Claude Code で/aliyun-pixverse-generationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

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

詳細

カテゴリ:プロバイダー

Model Studio Aishi 動画生成

検証

mkdir -p output/aliyun-pixverse-generation
python -m py_compile skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py && echo "py_compile_ok" > output/aliyun-pixverse-generation/validate.txt

合格基準:コマンドが終了コード 0 で終了し、output/aliyun-pixverse-generation/validate.txt が生成されます。

出力とエビデンス

  • 正規化されたリクエストペイロード、選択したモデルバリアント、タスクのポーリングスナップショットを output/aliyun-pixverse-generation/ に保存します。
  • リージョン、解像度/サイズ、長さ、音声生成が有効かどうかを記録します。

ユーザーが動画生成に Wan 以外の PixVerse ファミリーを明示的に希望する場合は、Aishi を使用してください。

重要なモデル名

次のいずれかのモデル文字列をそのまま使用します。

  • pixverse/pixverse-v5.6-t2v
  • pixverse/pixverse-v5.6-it2v
  • pixverse/pixverse-v5.6-kf2v
  • pixverse/pixverse-v5.6-r2v

選択の目安:

  • テキストのみで生成する場合は、pixverse/pixverse-v5.6-t2v を使用します。
  • 最初のフレーム画像から動画を生成する場合は、pixverse/pixverse-v5.6-it2v を使用します。
  • 最初のフレームから最後のフレームへの変化を生成する場合は、pixverse/pixverse-v5.6-kf2v を使用します。
  • 複数の画像を使ってキャラクターやスタイルの一貫性を保つ場合は、pixverse/pixverse-v5.6-r2v を使用します。

前提条件

  • このファミリーが現在対応しているのは、中国本土(北京)のみです。
  • SDK をインストールするか、HTTP を直接呼び出します。
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 環境に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加します。

正規化インターフェース(video.generate)

リクエスト
  • model(string、必須)
  • prompt(string、it2v では任意、それ以外のバリアントでは必須)
  • media(array、任意)
  • size(string、任意):1280*720 などの直接指定するピクセルサイズ。t2v と r2v で使用します
  • resolution(string、任意):360P/540P/720P/1080P。it2v と kf2v で使用します
  • duration(int、必須):5/8/10。ただし、1080P では 5/8 のみ対応します
  • audio(bool、任意)
  • watermark(bool、任意)
  • seed(int、任意)
  • レスポンス
    • task_id(string)
    • task_status(string)
    • video_url(string、完了時)

    エンドポイントと実行モデル

    • タスクを送信:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
    • タスクをポーリング:GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
    • HTTP 呼び出しは非同期のみです。ヘッダー X-DashScope-Async: enable を設定する必要があります。

    クイックスタート

    テキストから動画への生成:

    python skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py \
      --model pixverse/pixverse-v5.6-t2v \
      --prompt "A compact robot walks through a rainy neon alley." \
      --size 1280*720 \
      --duration 5
    

    画像から動画への生成:

    python skills/ai/video/aliyun-pixverse-generation/scripts/prepare_aishi_request.py \
      --model pixverse/pixverse-v5.6-it2v \
      --prompt "The turtle swims slowly as the camera rises." \
      --media image_url=https://example.com/turtle.webp \
      --resolution 720P \
      --duration 5
    

    運用ガイダンス

    • t2v と r2v では size を使用し、it2v と kf2v では resolution を使用します。
    • kf2v では、first_frame を 1 つ、last_frame を 1 つだけ指定します。
    • r2v では、最大 7 枚の参照画像を渡せます。
    • Aishi は最初にタスク ID を返します。最初のレスポンスを最終的な動画の結果として扱わないでください。

    出力先

    • デフォルトの出力先:output/aliyun-pixverse-generation/request.json
    • OUTPUT_DIR でベースディレクトリを上書きします。

    参考資料

    • references/sources.md

コメント