SuperAPI AI 工具集

alicloud-ai-video-emoji

设计与创作

查看项目

更新于 10-15 17:34

技能介绍

用途:该技能用于生成模板驱动的表情(Emoji)视频。当用户需要固定模板的人脸动画短片,而非开放式视频生成时使用。

主要能力:调用阿里云百炼 Emoji 模型,先用 emoji-detect-v1 检测人像并获取 face_bbox 与 ext_bbox_face,检测成功后再用 emoji-v1 按指定 template_id 生成视频。输出为人物视频片段,不是贴纸包或文字叠加素材。

使用方式:需在中国大陆(北京)区域使用;在环境中设置 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、ext_bbox_face、template_id。响应含 task_id、task_status,完成后含 video_url。快速开始命令:python skills/ai/video/alicloud-ai-video-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。默认输出 output/alicloud-ai-video-emoji/request.json,可用 OUTPUT_DIR 覆盖基础目录。

适用场景:单人、正面、无遮挡的人像,用于固定风格的表情或梗视频。

限制:仅限中国大陆(北京);template_id 须来自官方模板列表或控制台体验,不可在生产调用中自行编造;需先检测成功再生成。校验方式:mkdir -p output/alicloud-ai-video-emoji 后运行 python -m py_compile 脚本,退出码为 0 且生成 validate.txt 即通过。应将规范化请求载荷、检测到的人脸框、所选模板 ID 与任务轮询快照保存到 output/alicloud-ai-video-emoji/,并记录人像 URL 及检测是否通过。