mcpField
A
aliyun-emoji

aliyun-emoji

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

aliyun-emoji について

ポートレート画像から固定テンプレートの顔アニメーション動画を作成する Model Studio スキルです。顔とバウンディングボックスを検出し、その結果とテンプレート ID を使って動画を生成します。

主な機能

  1. 01顔を検出して境界ボックスを取得
  2. 02テンプレートからアニメーション動画を生成
  3. 03タスクを確認して動画 URL を取得
  4. 04リクエストとタスク記録を保存

活用シーン

  1. 01正面向きのポートレートを動画にする
  2. 02動画生成前に顔検出結果を確認

インストール

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

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

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

同梱ファイル

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

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

詳細

カテゴリー：プロバイダー

Model Studio Emoji

検証

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

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

出力と証跡

  • 正規化されたリクエストペイロード、検出された顔の境界ボックス、選択したテンプレート ID、タスクのポーリングスナップショットを output/aliyun-emoji/ に保存します。
  • 正確なポートレート URL と、検出に合格したかどうかを記録します。

ユーザーが自由形式の動画生成ではなく、固定テンプレートを使った顔アニメーション動画を希望する場合は、Emoji を使用します。

重要なモデル名

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

  • emoji-detect-v1
  • emoji-v1

選択に関するガイダンス：

  • まず emoji-detect-v1 を実行して、face_bbox と ext_bbox_face を取得します。
  • 検出に成功した場合にのみ、emoji-v1 を使用します。

前提条件

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

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

検出リクエスト
  • model（文字列、任意）：デフォルトは emoji-detect-v1
  • image_url（文字列、必須）
生成リクエスト
  • model（文字列、任意）：デフォルトは emoji-v1
  • image_url（文字列、必須）
  • face_bbox（array、必須）
  • ext_bbox_face（array、必須）
  • template_id（文字列、必須）
レスポンス
  • task_id（文字列）
  • task_status（文字列）
  • video_url（文字列、完了時）

クイックスタート

python skills/ai/video/aliyun-emoji/scripts/prepare_emoji_request.py \
  --image-url "https://example.com/portrait.png" \
  --face-bbox 302,286,610,593 \
  --ext-bbox-face 71,9,840,778 \
  --template-id emoji_001

運用ガイダンス

  • 顔が隠れていない、正面を向いた1人のポートレートを使用します。
  • テンプレート ID は公式テンプレート一覧またはコンソールの操作画面から取得します。本番環境での呼び出し時に推測で指定しないでください。
  • Emoji の出力は人物の動画クリップであり、ステッカーパックやテキストオーバーレイ素材ではありません。

出力先

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

参考資料

  • references/sources.md

コメント

Markdown 対応