mcpField
A
aliyun-emoji

aliyun-emoji

github.com/cinience创意与媒体39654 次安装11 周前更新
代码仓库

关于 aliyun-emoji

用于固定模板人脸动画视频的 Model Studio 技能，面向需要将人像照片制作为动画短片的用户。它先检测人脸并获取边界框，再将检测结果与模板 ID 用于生成视频。

主要功能

  1. 01检测人脸并获取边界框
  2. 02按模板生成动画视频
  3. 03轮询任务并获取视频链接
  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

详细介绍

Category: provider

Model Studio 表情动画

验证

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，或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials。
  • 输入图像必须是公开的 HTTP/HTTPS URL。

规范化接口（video.emoji）

检测请求
  • model（string，可选）：默认值为 emoji-detect-v1
  • image_url（string，必需）
生成请求
  • model（string，可选）：默认值为 emoji-v1
  • image_url（string，必需）
  • face_bbox（array，必需）
  • ext_bbox_face（array，必需）
  • template_id（string，必需）
响应
  • task_id（string）
  • task_status（string）
  • video_url（string，完成时提供）

快速开始

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

操作指南

  • 使用单人、正面且无遮挡的人像。
  • 模板 ID 来自官方模板列表或控制台体验；在生产调用中不要自行编造。
  • Emoji 输出的是人物视频片段，而非贴纸包或文字叠加素材。

输出位置

  • 默认输出：output/aliyun-emoji/request.json
  • 使用 OUTPUT_DIR 覆盖基础目录。

参考资料

  • references/sources.md

评论

支持 Markdown