mcpField
A
aliyun-liveportrait

aliyun-liveportrait

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

aliyun-liveportrait について

Alibaba Cloud Model Studio LivePortrait で動画を生成するスキルです。人物画像を先に検査し、テンプレートや動きの設定を指定して音声付きの人物動画を作成できます。

主な機能

  1. 01人物画像の検査
  2. 02音声から人物動画を生成
  3. 03normal、calm、active テンプレートの選択
  4. 04目・口・頭の動きの調整
  5. 05タスクの確認と動画 URL の取得

活用シーン

  1. 01軽量な人物アニメーションの作成
  2. 02長めのプレゼンター動画の生成

インストール

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

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

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

同梱ファイル

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

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

詳細

Category: プロバイダー

Model Studio LivePortrait

検証

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

合格基準：コマンドが終了コード 0 で終了し、output/aliyun-liveportrait/validate.txt が生成されること。

出力とエビデンス

  • 正規化されたリクエストペイロード、テンプレートの選択、タスクのポーリングスナップショットを output/aliyun-liveportrait/ に保存します。
  • ポートレートと音声の正確な URL、および動きの強さに関連するパラメーターを記録します。

音声を使った軽量なポートレートアニメーション、特に長めのクリップやシンプルなプレゼンター風の動きには、LivePortrait を使用します。

重要なモデル名

次のモデル文字列を正確に使用してください。

  • liveportrait-detect
  • liveportrait

選択のガイダンス：

  • まず liveportrait-detect を実行して、ポートレート画像を検証します。
  • 実際の動画生成タスクには liveportrait を使用します。

前提条件

  • 中国本土（北京）のみで利用できます。
  • 環境に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加します。
  • 入力画像と音声は、公開 HTTP/HTTPS URL である必要があります。

正規化されたインターフェース（video.liveportrait）

検出リクエスト
  • model（string、任意）：デフォルトは liveportrait-detect
  • image_url（string、必須）
生成リクエスト
  • model（string、任意）：デフォルトは liveportrait
  • image_url（string、必須）
  • audio_url（string、必須）
  • template_id（string、任意）：normal、calm、または active
  • eye_move_freq（number、任意）：0 ～ 1
  • video_fps（int、任意）：15 ～ 30
  • mouth_move_strength（number、任意）：0 ～ 1.5
  • paste_back（bool、任意）
  • head_move_strength（number、任意）：0 ～ 1
レスポンス
  • task_id（string）
  • task_status（string）
  • video_url（string、完了時）

クイックスタート

python skills/ai/video/aliyun-liveportrait/scripts/prepare_liveportrait_request.py \
  --image-url "https://example.com/portrait.png" \
  --audio-url "https://example.com/speech.mp3" \
  --template-id calm \
  --video-fps 24 \
  --paste-back

運用ガイダンス

  • 遮蔽が少なく、正面を向いた鮮明なポートレートを使用します。
  • 音声はクリアで、声が主体のものにします。
  • paste_back=false の場合、生成された顔の領域のみが出力されます。標準的なトーキングヘッド形式の出力には true を指定します。
  • 長めでシンプルなプレゼンター風のクリップが必要な場合は、EMO より LivePortrait が適しています。

出力先

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

参照資料

  • references/sources.md

コメント

Markdown 対応